The configuration file (often refered to as the netrekrc) is a regular text file that can contain comments, empty lines and configuration definitions.
Every line that has hashmark (#) as its first character is a comment line and will be ignored.
The general syntax for any of the configuration options is:
keyword: <value>
All configuration option keywords are case insensitive
Most of option keywords can have three additional suffixes to enable fine tuning of options:
keyword.observer: <value>
- this suffix will enable
the option only when you are logged in as an observer
Example:
buttonmap.observer: 1l2I3i
- will set a different buttonmap when you
observe game
keyword.<servernick>: <value>
- this suffix will
set the option only if you are connected to server <servernick>
Note that in order to define <servernick> you should define
server.<servernick>: <server host name>
Example:
server.continuum: continuum.us.netrek.org
- this option sets the servernick
for continuum.us.netrek.org to be continuum
keymap.continuum: a2d%
- this option defines a custom keymap for
a server with 'continuum' as its servernick
keyword.<servertype>: <value>
- this suffix will
set the option only if you are connected to server with <servertype> type.
Note: the client will automatically set <servertype> only if you connect from the Metaserver Window
If you want to define <servertype> for a specific server that is not there or
you connect to a server from the command line, you can use servertype.<servernick>: <type of server>
where
<type of server> can be one of following:
paradise
bronco
chaos
inl
sturgeon
hockey
dogfight
Example:
server.continuum: continuum.us.netrek.org
- this will set the servernick
for continuum.us.netrek.org to be continuum
serverType.continuum: bronco
- this will set the servertype for continuum
to be bronco
keymap.bronco: a2d%
- this will set the keymap for any bronco server
The precedence for the keywords is as follows:
keyword.observer: <value>
keyword.<servernick>: <value>
keyword.<servertype>: <value>
keyword: <value>
There are three types of values that can appear in the configuration:
Examples:
keepPeace: on
- will enable the keepPeace optionplanetBitmap: 2
- will assign value of 2 to the planetBitmap optionbuttonmap: 1t2p3k
- will assign string '1t2p3k' to the buttonmap option