This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "BZFS Command Line Options"

From BZFlagWiki
Jump to: navigation, search
(The Options)
Line 8: Line 8:
  
 
==The Options==
 
==The Options==
 +
 
*'''-a''' ''linear angular''
 
*'''-a''' ''linear angular''
 
Sets the maximum linear and angular accelerations. The units are somewhat arbitrary so you'll have to experiment to find suitable values. Positive values will set limits to the acceleration and lower they are, greater is the inertia. Zero or negative values disable acceleration limits.
 
Sets the maximum linear and angular accelerations. The units are somewhat arbitrary so you'll have to experiment to find suitable values. Positive values will set limits to the acceleration and lower they are, greater is the inertia. Zero or negative values disable acceleration limits.
Line 15: Line 16:
  
 
*'''-advertise''' ''groupname,groupname,...''
 
*'''-advertise''' ''groupname,groupname,...''
Allows control of who can see this server on the server list. Use:*'''-advertise NONE to make a private server (no one will see the server, but global logins can be used). The default, if*'''-advertise is not specified, is to alloweveryone to see the server. Otherwise, your server will only be listed to members of the groups which you specify when either*'''-filterCallsigns or*'''-filterChat is enabled.
+
Allows control of who can see this server on the server list. Use '''-advertise NONE''' to make a private server (no one will see the server, but global logins can be used). The default, if'''-advertise''' is not specified, is to alloweveryone to see the server. Otherwise, your server will only be listed to members of the groups which you specify when either'''-filterCallsigns''' or'''-filterChat''' is enabled.
  
*'''-ban''' ip{,ip}*  
+
*'''-ban''' ''ip{,ip}*''
 
Prohibits connections from the listed IP addresses. Trailing 255 bytes are treated as mask bytes.
 
Prohibits connections from the listed IP addresses. Trailing 255 bytes are treated as mask bytes.
  
*'''-banfile''' filename
+
*'''-banfile''' ''filename''
 
Specifies the name of a file where bzfs will store the banlist. It will load the banlist from this file when it starts (if the file exists), and write the banlist back to the file when someone gets banned or unbanned. If this option isn't given the banlist will not be saved.
 
Specifies the name of a file where bzfs will store the banlist. It will load the banlist from this file when it starts (if the file exists), and write the banlist back to the file when someone gets banned or unbanned. If this option isn't given the banlist will not be saved.
  
 
*'''-c'''
 
*'''-c'''
Enables the capture-the-flag style game. By default this allocates one team flag per team. This can be modified see *'''+f team. By default, the free-for-all style is used.
+
Enables the capture-the-flag style game. By default this allocates one team flag per team. This can be modified see '''+f''' ''team''. By default, the free-for-all style is used.
  
*'''-cache''' worldCacheURL
+
*'''-cache''' ''worldCacheURL''
 
Specifies the URL for the world cache file. This is a binary file that clients will attempt to download before getting the world from the bzfs server.
 
Specifies the URL for the world cache file. This is a binary file that clients will attempt to download before getting the world from the bzfs server.
  
*'''-cacheout''' filename
+
*'''-cacheout''' ''filename''
 
Save the currently specified world into a binary cache file and exit.
 
Save the currently specified world into a binary cache file and exit.
  
*'''-conf''' configfilename
+
*'''-conf''' ''configfilename''
 
Specifies the name of a configuration file to be used to set all of the bzfs options, rather than setting them on the command line.
 
Specifies the name of a configuration file to be used to set all of the bzfs options, rather than setting them on the command line.
  
*'''-cr''' Enables the capture-the-flag style game with random map.
+
*'''-cr'''
 +
Enables the capture-the-flag style game with random map.
 
You can optionally specify a building density by provid-
 
You can optionally specify a building density by provid-
 
ing a number (default is 5). One team flag per team is
 
ing a number (default is 5). One team flag per team is
provided, but more can be added thru *'''+f team.By
+
provided, but more can be added thru '''+f''' ''team''.By
 
default, the free-for-all style is used.
 
default, the free-for-all style is used.
  
*'''-d''' Increase debugging level. If more*'''-d is given, more
+
*'''-d'''
 +
Increase debugging level. If more'''-d''' is given, more
 
debugging info is obtained.
 
debugging info is obtained.
  
Line 52: Line 55:
 
using robots.
 
using robots.
  
*'''+f''' {good|bad|teamflag-id}[{count}]
+
*'''+f''' ''{good|bad|teamflag-id}[{count}]''
 
Forces the existence of the given flag. If specified
 
Forces the existence of the given flag. If specified
 
multiple times for the same flag-id, then that many
 
multiple times for the same flag-id, then that many
 
flags will appear. The good argument is equivalent to
 
flags will appear. The good argument is equivalent to
specifying *'''+f once for each kind of good flag. Same goes
+
specifying '''+f''' once for each kind of good flag. Same goes
for the bad argument.  The team argument adds a team
+
for the bad argument.  
be "*'''+s40*'''-s50*'''-f G". Similarly, "*'''+f good{40} *'''+f bad{10}
+
-f G{40}" would give you exactly 40 good flags except
+
genocide and 10 of each bad flag.
+
  
*'''-fb''' Allow flags on box buildings.
+
*'''-fb'''
 +
Allow flags on box buildings.
  
 
*'''-filterCallsigns'''
 
*'''-filterCallsigns'''
Line 84: Line 85:
 
Quit after serving one game.
 
Quit after serving one game.
  
*'''-groupdb''' file
+
*'''-groupdb''' ''file''
 
Load groups from file
 
Load groups from file
  
Line 100: Line 101:
 
Shows a help page and lists all the valid flag id's.
 
Shows a help page and lists all the valid flag id's.
  
*'''-helpmsg''' file name
+
*'''-helpmsg''' ''file name''
 
Create a help message accessible by /help name, which
 
Create a help message accessible by /help name, which
 
prints the contents of file. Restricted to 10 lines per
 
prints the contents of file. Restricted to 10 lines per
 
help message.
 
help message.
  
*'''-i interface'''
+
*'''-i''' ''interface''
Server will listen for and respond to ``pings'' (sent
+
Server will listen for and respond to ''pings'' (sent
 
via broadcast) on the given interface. Clients use this
 
via broadcast) on the given interface. Clients use this
 
to find active servers on the network. This is the
 
to find active servers on the network. This is the
Line 114: Line 115:
 
Allows jumping.
 
Allows jumping.
  
*'''-lagdrop''' warn-count
+
*'''-lagdrop''' ''warn-count''
 
Kicks players after warn-count lag warnings.
 
Kicks players after warn-count lag warnings.
  
*'''-lagwarn''' time/ms
+
*'''-lagwarn''' ''time/ms''
 
Send warnings to players that lag more than time.
 
Send warnings to players that lag more than time.
 
A single value sets the total number of players allowed.
 
A single value sets the total number of players allowed.
Line 125: Line 126:
 
players. Both forms may be provided.
 
players. Both forms may be provided.
  
*'''-mps''' max-score
+
*'''-mps''' ''max-score''
 
Sets a maximum score for individual players. The first
 
Sets a maximum score for individual players. The first
 
player to reach this score is declared the winner and
 
player to reach this score is declared the winner and
 
the game is over.
 
the game is over.
  
*'''-ms shots Allows up to shots simultaneous shots for each player.
+
*'''-ms ''shots''
This is 1 by default.
+
Allows up to shots simultaneous shots for each player. This is 1 by default.
  
*'''-mts max-score'''
+
*'''-mts''' ''max-score''
 
Sets a maximum score for teams. The first team to reach
 
Sets a maximum score for teams. The first team to reach
 
this score is declared the winner and the game is over.
 
this score is declared the winner and the game is over.
Line 141: Line 142:
 
the internet.
 
the internet.
  
*'''-p''' port
+
*'''-p''' ''port''
 
Listen for game connections on port instead of the
 
Listen for game connections on port instead of the
 
default port.Use*'''-help to print the default port, or
 
default port.Use*'''-help to print the default port, or
 
use*'''-d debug printing.
 
use*'''-d debug printing.
  
*'''-passdb fileLoad'''
+
*'''-passdb''' ''fileLoad''
 
passwords from file
 
passwords from file
  
*'''-passwd''' password
+
*'''-passwd''' ''password''
 
Specify a server administrator password for use in
 
Specify a server administrator password for use in
 
remote administration such as /kick, /ban, /mute, etc
 
remote administration such as /kick, /ban, /mute, etc
 
messages.
 
messages.
  
*'''-pidfile''' filename
+
*'''-pidfile''' ''filename''
 
Specify a file where the server will write its process
 
Specify a file where the server will write its process
 
ID so it may be used for remote administration.
 
ID so it may be used for remote administration.
  
*'''-poll''' variable=value
+
*'''-poll''' ''variable=value''
 
  Configure several aspects of the in-game polling system
 
  Configure several aspects of the in-game polling system
 
  '''banTime'''
 
  '''banTime'''
Line 175: Line 176:
 
   bzfs servers.
 
   bzfs servers.
  
*'''-publicaddr''' address[:port]
+
*'''-publicaddr''' ''address[:port]''
 
Advertise this server with the given address and port.
 
Advertise this server with the given address and port.
 
Only has an effect when used with*'''-public.Normally a
 
Only has an effect when used with*'''-public.Normally a
Line 185: Line 186:
 
should use to access this server.
 
should use to access this server.
  
*'''-publiclist''' url
+
*'''-publiclist''' ''url''
 
Advertise this server on the list servers listed at url.
 
Advertise this server on the list servers listed at url.
 
Only has an effect when used with*'''-public. A built-in
 
Only has an effect when used with*'''-public. A built-in
Line 205: Line 206:
 
and guided missiles do not.
 
and guided missiles do not.
  
*'''-rabbit''' [score|killer|random]
+
*'''-rabbit''' ''[score|killer|random]''
 
Enables the rabbit-hunt style game. By default, the
 
Enables the rabbit-hunt style game. By default, the
 
free-for-all style is used. You must specify the algo-
 
free-for-all style is used. You must specify the algo-
Line 217: Line 218:
 
the original behavior.)
 
the original behavior.)
  
*'''-recbuf''' size
+
*'''-recbuf''' ''size''
 
Start with the recording buffer active, with the speci-
 
Start with the recording buffer active, with the speci-
 
fied size (in megabytes).
 
fied size (in megabytes).
Line 230: Line 231:
 
before opening a UDP channel, kick them off the server.
 
before opening a UDP channel, kick them off the server.
  
*'''+s''' num-flags
+
*'''+s''' ''num-flags''
 
The server will have an extra num-flags random super
 
The server will have an extra num-flags random super
 
flags available at all times. The*'''-f option can be used
 
flags available at all times. The*'''-f option can be used
Line 237: Line 238:
 
in the num-flags total.
 
in the num-flags total.
  
*'''-s''' num-flags
+
*'''-s''' ''num-flags''
 
The server will have up to num-flags random super flags
 
The server will have up to num-flags random super flags
 
available at any time.The*'''-f option can be used to
 
available at any time.The*'''-f option can be used to
Line 247: Line 248:
 
Antidote flags are provided for players with bad flags.
 
Antidote flags are provided for players with bad flags.
  
*'''-sb Allow spawns on box buildings.
+
*'''-sb'''
 +
Allow spawns on box buildings.
  
*'''-set''' name value
+
*'''-set''' ''name value''
 
Set BZDB variable name to value
 
Set BZDB variable name to value
  
*'''-sl''' id num
+
*'''-sl''' ''id num''
 
Restrict flag id to num shots.
 
Restrict flag id to num shots.
  
*'''-spamtime''' time  
+
*'''-spamtime''' ''time''
 
Minimum <time> between player chat messages that are alike.
 
Minimum <time> between player chat messages that are alike.
  
*'''-spamwarn''' warnLimit
+
*'''-spamwarn''' ''warnLimit''
 
Number of warnings a player/spammer gets, whoviolates
 
Number of warnings a player/spammer gets, whoviolates
 
-spamtime.
 
-spamtime.
  
*'''-speedtol''' factor
+
*'''-speedtol''' ''factor''
 
Override the default speed auto kick factor. The factor
 
Override the default speed auto kick factor. The factor
 
should not be less then 1.0. The factor is a multiplier.
 
should not be less then 1.0. The factor is a multiplier.
  
*'''-srvmsg''' message
+
*'''-srvmsg''' ''message''
 
Define a server welcome message. This option can be used
 
Define a server welcome message. This option can be used
 
multiple times to define a multiline message.
 
multiple times to define a multiline message.
  
*'''-st''' time
+
*'''-st''' ''time''
 
Bad flags are automatically dropped after time seconds.
 
Bad flags are automatically dropped after time seconds.
  
*'''-sw''' count
+
*'''-sw''' ''count''
 
Bad flags are automatically dropped after count wins.
 
Bad flags are automatically dropped after count wins.
 
Capturing a team flag does not count as a win.
 
Capturing a team flag does not count as a win.
Line 295: Line 297:
 
game.
 
game.
  
*'''-tkkr percent
+
*'''-tkkr''' ''percent''
 
Kicks players whose team killing to normal kill ratio is
 
Kicks players whose team killing to normal kill ratio is
 
greater than percent [1-100]. A start up grace period is
 
greater than percent [1-100]. A start up grace period is
 
given to players.
 
given to players.
  
*'''-ts [micros]Include timestamp information in DEBUG output*'''- useful
+
*'''-ts''' ''[micros]''
 +
Include timestamp information in DEBUG output useful
 
for logging. If micros is specified, microseconds will
 
for logging. If micros is specified, microseconds will
 
be added to the timestamp.
 
be added to the timestamp.
  
*'''-userdb''' file
+
*'''-userdb''' ''file''
 
Load group associations from file
 
Load group associations from file
  
*'''-vars''' file  
+
*'''-vars''' ''file ''
 
Loads values for game configurable variables from file.
 
Loads values for game configurable variables from file.
 
Entries are one per line in the form: set variable
 
Entries are one per line in the form: set variable
Line 316: Line 319:
 
Prints the version number of the executable.
 
Prints the version number of the executable.
  
*'''-world''' world-file
+
*'''-world''' ''world-file''
 
Reads a specific BZFlag .bzw world layout file for the
 
Reads a specific BZFlag .bzw world layout file for the
 
game map.
 
game map.
  
*'''-worldsize''' world-size
+
*'''-worldsize''' ''world-size''
 
Changes the size for random maps
 
Changes the size for random maps
 
[[Category:Server]]
 
 
 
  
  
 
[[Category:Server]]
 
[[Category:Server]]

Revision as of 22:23, 18 February 2007

BZFS supports a number of command line options that let you set the various modes and parameters for the game.

Use

Any command line option can be passed to BZFS in the command line, or placed in a text file passed in with the -conf parameter.

Config files

A config file is simply a text file with a list of command line options, one per line. This file can be the parameter to the -conf command line option. BZFS will load all options in the config file as if they had been passed in as runtime options.

The Options

  • -a linear angular

Sets the maximum linear and angular accelerations. The units are somewhat arbitrary so you'll have to experiment to find suitable values. Positive values will set limits to the acceleration and lower they are, greater is the inertia. Zero or negative values disable acceleration limits.

  • -admsg

message Define a message which will be broadcast to all players every 15 minutes. This option can be used multiple times to define a multiline message.

  • -advertise groupname,groupname,...

Allows control of who can see this server on the server list. Use -advertise NONE to make a private server (no one will see the server, but global logins can be used). The default, if-advertise is not specified, is to alloweveryone to see the server. Otherwise, your server will only be listed to members of the groups which you specify when either-filterCallsigns or-filterChat is enabled.

  • -ban ip{,ip}*

Prohibits connections from the listed IP addresses. Trailing 255 bytes are treated as mask bytes.

  • -banfile filename

Specifies the name of a file where bzfs will store the banlist. It will load the banlist from this file when it starts (if the file exists), and write the banlist back to the file when someone gets banned or unbanned. If this option isn't given the banlist will not be saved.

  • -c

Enables the capture-the-flag style game. By default this allocates one team flag per team. This can be modified see +f team. By default, the free-for-all style is used.

  • -cache worldCacheURL

Specifies the URL for the world cache file. This is a binary file that clients will attempt to download before getting the world from the bzfs server.

  • -cacheout filename

Save the currently specified world into a binary cache file and exit.

  • -conf configfilename

Specifies the name of a configuration file to be used to set all of the bzfs options, rather than setting them on the command line.

  • -cr

Enables the capture-the-flag style game with random map. You can optionally specify a building density by provid- ing a number (default is 5). One team flag per team is provided, but more can be added thru +f team.By default, the free-for-all style is used.

  • -d

Increase debugging level. If more-d is given, more debugging info is obtained.

  • -density numSpecify density for buildings, i.e. the higher the inte-

ger number, the more buildings you will get. This applies to automatically generated maps only.

  • -disableBotsDisallow

clients from using the ROGER autopilot or from using robots.

  • +f {good|bad|teamflag-id}[{count}]

Forces the existence of the given flag. If specified multiple times for the same flag-id, then that many flags will appear. The good argument is equivalent to specifying +f once for each kind of good flag. Same goes for the bad argument.

  • -fb

Allow flags on box buildings.

  • -filterCallsigns

Turn on the filtering of callsigns and email addresses. Callsigns and addresses are compared against bad words provided via*-badwords.

  • -filterChat

Turn on the filtering of chat messages. Messages that contain words listed via a*-badwords file are replaced with !@#$%^&* characters.

  • -filterSimple

By default, all filtering is aggressive, matching much more than what is strictly listed in a*-badwords file for convenience.Providing this option will make the -filterCallsigns and*-filterChat comparisons exact match only.

  • -g

Quit after serving one game.

  • -groupdb file

Load groups from file

  • -h

Buildings are given random heights.

  • -handicap

Players are given a handicap advantage based on their ability in relation to the other players. Handicapped players will have faster tanks and shots. The handicap is determined by the player's score in relation to other players.

  • -help

Shows a help page and lists all the valid flag id's.

  • -helpmsg file name

Create a help message accessible by /help name, which prints the contents of file. Restricted to 10 lines per help message.

  • -i interface

Server will listen for and respond to pings (sent via broadcast) on the given interface. Clients use this to find active servers on the network. This is the TCP/UDP/IP address the server will listen on.

  • -j

Allows jumping.

  • -lagdrop warn-count

Kicks players after warn-count lag warnings.

  • -lagwarn time/ms

Send warnings to players that lag more than time. A single value sets the total number of players allowed. Five comma separated values set the maximum for each team. If a count is left blank then no limit is set for that team, except for the limit on the total number of players. Both forms may be provided.

  • -mps max-score

Sets a maximum score for individual players. The first player to reach this score is declared the winner and the game is over.

  • -ms shots

Allows up to shots simultaneous shots for each player. This is 1 by default.

  • -mts max-score

Sets a maximum score for teams. The first team to reach this score is declared the winner and the game is over.

  • -noMasterBanlist

Server will not attempt to load the master ban list from the internet.

  • -p port

Listen for game connections on port instead of the default port.Use*-help to print the default port, or use*-d debug printing.

  • -passdb fileLoad

passwords from file

  • -passwd password

Specify a server administrator password for use in remote administration such as /kick, /ban, /mute, etc messages.

  • -pidfile filename

Specify a file where the server will write its process ID so it may be used for remote administration.

  • -poll variable=value
Configure several aspects of the in-game polling system
banTime
 default number of minutes player should be banned (unspecified, the default is 300)
vetoTime
 max seconds authorized user has to abort poll(default is 20)
votePercentage
 percentage of players required to affirm a poll (unspecified, the default is 50.1%)
voteRepeatTime
 minimum seconds required before a player may
 description. By default, a server will respond to
 broadcast queries, allowing clients to find servers run-
 ning on the standard port on the local subnet.The
 -public option causes the server to register itself with
 a list server, which clients can query to get a list of
 bzfs servers.
  • -publicaddr address[:port]

Advertise this server with the given address and port. Only has an effect when used with*-public.Normally a server advertises itself at the local address and port. Some servers are not accessible from the internet at this address (for example servers behind a firewall using Network Address Translation). Use this option to specify the address and/or port that internet users should use to access this server.

  • -publiclist url

Advertise this server on the list servers listed at url. Only has an effect when used with*-public. A built-in url is used by default. The BZFlag clients use the same built-in url so, by default, clients will see public servers automatically. This argument may be provided multiple times to publicize a server to multiple list servers.

  • -q

If specified, the server will not listen for nor respond to ``pings. BZFlag sends out these pings to give the user a list of available servers.This effectively makes the server private, especially if the*-p option is also used.

  • +r

Makes most shots ricochet. Super bullets, shock waves, and guided missiles do not.

  • -rabbit [score|killer|random]

Enables the rabbit-hunt style game. By default, the free-for-all style is used. You must specify the algo- rithm used to pick a new rabbit when the old one dies. The score algorithm uses a modified wins/(wins*+losses) score and picks the top scoring player to be the new rabbit. The killer algorithm specifies a reverse tag game where whomever kills the rabbit becomes the new rabbit. The random algorithm randomly picks a new rab- bit without regard to score. (The score algorithm is the original behavior.)

  • -recbuf size

Start with the recording buffer active, with the speci- fied size (in megabytes).

  • -recbufonly

Disable recording straight to files

  • -reportfile
  • -requireudp

Require clients to use parallel UDP. If players fire before opening a UDP channel, kick them off the server.

  • +s num-flags

The server will have an extra num-flags random super flags available at all times. The*-f option can be used to restrict which types of flags will be added. Required flags given by the *+f option are not included in the num-flags total.

  • -s num-flags

The server will have up to num-flags random super flags available at any time.The*-f option can be used to restrict which types of flags will be added.Required flags given by the *+f option are not included in the num-flags total.

  • -sa

Antidote flags are provided for players with bad flags.

  • -sb

Allow spawns on box buildings.

  • -set name value

Set BZDB variable name to value

  • -sl id num

Restrict flag id to num shots.

  • -spamtime time

Minimum

  • -spamwarn warnLimit

Number of warnings a player/spammer gets, whoviolates -spamtime.

  • -speedtol factor

Override the default speed auto kick factor. The factor should not be less then 1.0. The factor is a multiplier.

  • -srvmsg message

Define a server welcome message. This option can be used multiple times to define a multiline message.

  • -st time

Bad flags are automatically dropped after time seconds.

  • -sw count

Bad flags are automatically dropped after count wins. Capturing a team flag does not count as a win.

  • -synctime

Forces all clients to use the same time of day.The current time is determined by the server's clock. This disables the *+ and*- keys on the clients.

  • -t

Adds teleporters to the game.

  • -timemanual

the countdown has to be started manually using the /countdown command. This is useful for matches.

  • -tk

Changes the default behavior where a player dies when he kills a teammate. When using this option, he will just get a*-1 score penalty for the kill but not be killed in game.

  • -tkkr percent

Kicks players whose team killing to normal kill ratio is greater than percent [1-100]. A start up grace period is given to players.

  • -ts [micros]

Include timestamp information in DEBUG output useful for logging. If micros is specified, microseconds will be added to the timestamp.

  • -userdb file

Load group associations from file

  • -vars file

Loads values for game configurable variables from file. Entries are one per line in the form: set variable value. For a list of variables that are configurable, in the BZFlag client, send a message with /set as the text.

  • -version

Prints the version number of the executable.

  • -world world-file

Reads a specific BZFlag .bzw world layout file for the game map.

  • -worldsize world-size

Changes the size for random maps