BZFS Parameters



Usage


bzfs [-a <vel> <rot>] [-admsg <text>] [-b] [-ban ip{,ip}*] [-c] [-cr] [-d] [+f {good|<id>}] [-f {bad|<id>}] [-fb] [-g] [-h] [-help] [-i <interface>] [-j] [-lagdrop <num>] [-lagwarn <time/ms>] [-maxidle <time/s>] [-mo <count>][-mp {<total-count> | [<rogue-count>] , [<red-count>] , [<green-count>] , [<blue-count>] , [<purple-count>]}] [-mps <score>] [-ms <shots>] [-mts <score>] [-noudp] [-p <port>] [-passwd <password>] [-pr <reconnect port>] [-printscore] [-public <server-description>] [-publicaddr <server-hostname>[:<server-port>]] [-publiclist <list-server-url>] [-q] [+r] [-r] [-requireudp] [{+s|-s} [<num>]] [-sa] [-srvmsg <text>] [-st <time>] [-sw <num>] [-synctime] [-t] [-time <seconds>] [-tk <percentage>] [-tkkr] [-ttl <time-to-live>] [-version] [-world <filename>]

Note that all parameters are case sensitive and need to be entered in lower case.



Example


bzfs +f CL +f GM +f ID +f L +f OO +f ST +f SW -f JP -f R -j -lagdrop 5 -lagwarn 600 -maxidle 300 -mo 0 -mp 3,3,3,3,3 -ms 2 -p 17200 -passwd YOUR_ADMIN_PASSWORD -pr 17201 -r +r -requireudp +s 15 -s 15 -sa -st 10 -sw 1 -t -ttl 128 -public "Now playing MAP_NAME by MAP_AUTHOR_NAME" -publicaddr "YOUR.IP.ADRESS:17200" -srvmsg "Welcome to MAP_NAME by MAP_AUTHOR_NAME" -world "MAP_FILE_NAME"

The above server configuration does the following:

Specific flags are forced and some disabled;
Players with a lag of 600ms or over are dropped after 5 warnings;
3 Players on each color are allowed, including rogues, making for a total playercount of 15;
Maximum of 2 simultaneous shots;
No ricochet bullets/laser;
Jumping enabled;
22 Flags (7 explicitly specified with +f and 15 random with -s);
Bad flags drop after 10 seconds or after 1 win and yellow anti-dote flag is given;
Set generic server information



Explanation


-a <vel> <rot>
Enables inertia (momentum) permanently for all players by setting the maximum acceleration settings for <vel> and <rot>; use floating point values between 0 and 1.

-admsg <text>
Specify a <text> which will be broadcast every 15 minutes.

-b
Randomly oriented buildings.
Only useful in default worlds (when the -world parameter is omitted).

-ban ip{,ip}*
Ban players based on ip{,ip}* address.

-c
Capture-The-Flag style game, only works for worlds that where designed for CTF (2 to 4 bases have been defined).

-cr
Capture-The-Flag style game with random world.

-d
Increase debugging level.

+f {good|<id>}
Always have flag {good|<id>} available.

-f {bad|<id>}
Never randomly generate flag {bad|<id>}.

-fb
Allow flags on box buildings, optional for any world but required if a CTF world has elevated bases.

-g
Serve one game and then exit.

-h
Use random building heights.
Only useful in default worlds (when the -world parameter is omitted).

-help
Prints version and usage information and then exits.

-i <interface>
Listen on <interface>.

-j
Allow jumping.

-lagdrop <num>
Drop player after <num> lag warnings.

-lagwarn <time/ms>
Lag warning threshhold in <time/ms>.

-maxidle <time/s>
Idle kick threshhold in <time/s>.

-mo <count>
Maximum number of additional observers allowed (default = 3).

-mp {<total-count> | [<rogue-count>] , [<red-count>] , [<green-count>] , [<blue-count>] , [<purple-count>]}
Maximum players total or per team.

-mps <score>
Set player <score> limit on each game.

-ms <shots>
Maximum simultaneous <shots> per player.

-mts <score>
Set team <score> limit on each game.

-noudp
Never use the new UDP networking.

-p <port>
Use alternative <port> (default is 5155).

-passwd <password>
Specify a <password> for operator commands.

-pr <reconnect port>
Use <reconnect port>.

-printscore
Whenever the score changes it is written to the shell (stdout); note that under Win32 you have to use a workaround: bzflag -printscore > score.txt.

-public <server-description>
Specifies the <server-description> visible to all players.

-publicaddr <server-hostname>[:<server-port>]
Specifies the <server-hostname> and [:<server-port>] to be used.

-publiclist <list-server-url>
Advertise this server on the BZFLS servers listed at <list-server-url>.

-q
Don't listen for or respond to pings.

+r
All shots ricochet.

-r
Allow rogue tanks.

-requireudp
Require clients to use UDP.

+s <num>
Always have <num> super flags (default=16).

-s <num>
Allow up to <num> super flags (default=16).

-sa
Insert antidote superflags.

-srvmsg <text>
Specify a <text> to print upon client login.

-st <time>
shake bad flags in <time> seconds.

-sw <num>
Shake bad flags after <num> wins.

-synctime
Synchronize time of day on all clients, players cannot change the time of day themselves (lighting).

-t
Allow teleporters.
Only useful in default worlds (when the -world parameter is omitted).

-time <seconds>
Set time limit on each game in <seconds>.

-tk
Player does not die when killing a teammate, but gets a -1 point instead.

-tkkr <percentage>
Kicks players whose team killing to normal kill ratio is greater than the percentage (1-100); a start up grace period is given to players.

-ttl <time-to-live>
Set <time-to-live> for pings (default=8), only 32 or higher makes the server visible on the Internet.

-version
Prints version and exits.

-world <filename>
<filename> is the name of the world file to be used.
The default world will be used if this parameter is omitted.