Table of Contents
This chapter is included for the people who wish to control exactly the way Pioneers is running.
The extra configuration options are processed in this order:
Command line
Settings file
Environment
Built-in settings
The client is controlled by the command line, the environment and the settings file.
Table 5.1. pioneers command line options
| Short | Long | Description |
|---|---|---|
| -s | --server | Hostname of the server |
| -p | --port | Port of the server |
| -n | --name | Player name |
| --language | Override the language as set in the environment. Valid choices: de en es fr hu it nl sv |
When both the server and port are set, the client will not display the connect dialog, but will directly connect to this port. When the connection is closed (because the game is over, or the connection fails), the client quits.
Server and port need both to be set, or not at all.
Table 5.2. Settings file ~/.config/pioneers
| Section | Key | Type | Description |
|---|---|---|---|
| connect | server | string | Last used server for private game |
| connect | port | string | Last used port for private game |
| connect | meta-server | string | Address of the meta server |
| connect | name | string | Last used player name |
| favorites | server%dname | string | History entry of private server games |
| favorites | server%dport | string | History entry of private server games |
| settings | color_chat | boolean | Display chat messages in user's color |
| settings | color_messages | boolean | Display colors in the message log |
| settings | color_summary | boolean | Use colors in the summary |
| settings | toolbar_show_accelerators | boolean | Show the keyboard accelerators in the toolbar |
| settings | show_toolbar | boolean | Show the toolbar |
| settings | legend_page | boolean | Display the legend page beside the map |
| settings | theme | string | The theme |
Table 5.3. pioneers environment
| Variable | Description |
|---|---|
| PIONEERS_META_SERVER | The host name of the meta server |
When the host name is not provided in the client, this environment variable will be used. If it is not set, the default (pioneers.debian.net) will be used.