|
|
Line 1: |
Line 1: |
− | BZFS is the BZFlag server. To be lazy, the man page is located at [http://my.bzflag.org/bzfman.cgi?bzfs.6.in] | + | BZFS is name of the the [[[BZFlag]] server application. It is a command line application that can ether be run manually or started from within the game. The server supports a large list of [[BZFS Command Line Options|command line options]] that can be used. |
| | | |
− | The man page is pasted below for your convenience (it is in need of heavy wiki formatting).
| + | [[Category:Server]] |
− | == Man Page ==
| + | |
− | SYNOPSIS
| + | |
− | | + | |
− | bzfs [-a linear angular] [-admsg message] [-advertise GROUPNAME,GROUP-
| + | |
− | NAME,...] [-autoTeam] [-b] [-badwords badwordfile] [-ban ip{,ip}*]
| + | |
− | [-ban ip[,ip]...] [-banfile filename] [-c] [-cache worldCacheURL]
| + | |
− | [-cacheout filename] [-conf configfile] [-cr] [-d] [-density num]
| + | |
− | [-disableBots] [+f {good|bad|team||flag-id}[{count}]] [-f
| + | |
− | {good|bad|flag-id}] [-fb] [-filterCallsigns] [-filterChat] [-filterSim-
| + | |
− | ple] [-g] [-groupdb file] [-h] [-handicap] [-help] [-helpmsg file name]
| + | |
− | [-i interface] [-j] [-lagdrop warn-count] [-lagwarn time/ms] [-master-
| + | |
− | BanURL URL/s] [-maxidle time/s] [-mp
| + | |
− | {count|[rogue-count],[red-count],[green-count],[blue-count],[pur-
| + | |
− | ple-count],[observer-count]}] [-mps {max-score}] [-ms shots] [-mts
| + | |
− | {max-score}] [-noMasterBanlist] [-p port] [-passdb file] [-passwd pass-
| + | |
− | word] [-pidfile filename] [-poll variable=value] [-printscore] [-public
| + | |
− | description] [-publicaddr address[:port]] [-publiclist url] [-q] [+r]
| + | |
− | [-rabbit [score|killer|random]] [-recbuf size] [-recbufonly] [-recdir
| + | |
− | directory] [-replay] [-reportfile filename] [-reportpipe command]
| + | |
− | [-requireudp] [+s flag-count] [-s flag-count] [-sa] [-sb] [-set name
| + | |
− | value] [-sl id num] [-spamtime time] [-spamwarn warnLimit] [-speedtol
| + | |
− | factor] [-srvmsg message] [-st time] [-sw count] [-synctime] [-t]
| + | |
− | [-tftimeout time-limit] [-time time-limit] [-timemanual] [-tk] [-tkkr
| + | |
− | percent] [-trackplayhistory] [-ts [micros]] [-userdb file] [-vars file]
| + | |
− | [-version] [-world world-file] [-worldsize world size]
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | DESCRIPTION
| + | |
− | | + | |
− | Bzfs is the server for BZFlag, and it must be running to play. It can
| + | |
− | be run on any system on the network (including a player's system or one
| + | |
− | without graphics). Terminating the server terminates the game in
| + | |
− | progress.
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | OPTIONS
| + | |
− | | + | |
− | -a linear angular
| + | |
− | Sets the maximum linear and angular accelerations. The
| + | |
− | units are somewhat arbitrary so you'll have to experi-
| + | |
− | ment 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 accel-
| + | |
− | eration 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 allow
| + | |
− | everyone to see the server. Otherwise, your server will
| + | |
− | only be listed to members of the groups which you spec-
| + | |
− | 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 num Specify density for buildings, i.e. the higher the inte-
| + | |
− | ger number, the more buildings you will get. This
| + | |
− | applies to automatically generated maps only.
| + | |
− | | + | |
− | -disableBots Disallow 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. The team argument adds a team
| + | |
− | 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.
| + | |
− | | + | |
− | -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 file Load 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 <time> between player chat messages that are
| + | |
− | alike.
| + | |
− | | + | |
− | -spamwarn warnLimit
| + | |
− | Number of warnings a player/spammer gets, who violates
| + | |
− | -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.
| + | |
− | | + | |
− | first player joins. With -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.
| + | |
− | | + | |
− | -trackplayhistory
| + | |
− | Has the server track players with good runs of kills and
| + | |
− | anounces them. Also anounces those players that stop
| + | |
− | the runs of good 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
| + | |
− | | + | |
− | Notes
| + | |
− | The server uses nearly zero CPU time when nobody is playing, and even
| + | |
− | during a game the server uses very little CPU, so it's not a burden on
| + | |
− | the system to leave one running and it won't interfere with a player
| + | |
− | using the same system (except on Windows 95, which really sucks at mul-
| + | |
− | titasking). The server will continue to run until terminated. If a
| + | |
− | game is in progress when the server goes down, all players will be
| + | |
− | kicked off and the game will be aborted without warning. The server
| + | |
− | resets itself when all players have quit. All players must quit to
| + | |
− | reset the server when a game is over (because of a score or time
| + | |
− | limit).
| + | |
− | | + | |
− | The following game styles are recommended starting points.
| + | |
− | | + | |
− | games where lag/jitter can cause unfair advantage. Single shot, non-
| + | |
− | Jump games will teach valuable lessons in dodging, however, and are
| + | |
− | excellent starting points for the beginner.
| + | |
− | | + | |
− | Networking
| + | |
− | Communication between the server and clients (i.e. between bzfs and
| + | |
− | bzflag) during a game is via TCP and UDP. Use the -help option to get
| + | |
− | the server's default port. If there's a firewall between the server
| + | |
− | and client, the firewall must accept connections from the client to
| + | |
− | this port and forward them to the server.
| + | |
− | | + | |
− | Clients can search for servers by sending broadcast UDP packets. But
| + | |
− | they must be on the same local area network for this to work. Clients
| + | |
− | can also find servers advertised using -public by querying list
| + | |
− | servers.
| + | |
− | | + | |
− | Game information is relayed through the server. Some communication
| + | |
− | between clients, such as position and orientation information, is nor-
| + | |
− | mally sent via UDP packets. Other data, like flag grab and kill mes-
| + | |
− | sages, are sent to the server via TCP. The server then turns around and
| + | |
− | broadcasts these packets to all players. Since being in a game implies
| + | |
− | connection to the server, all players are guaranteed to get all mes-
| + | |
− | sages sent via TCP. But the UDP packets may be discarded. If other
| + | |
− | players can see your tank in the game but it never appears to move and
| + | |
− | shots go through it, chances are high that your UDP connection is not
| + | |
− | working.
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | GENERAL SERVER COMMANDS
| + | |
− | | + | |
− | /lagstats
| + | |
− | Lists network delays, jitter and number of lost resp. out of
| + | |
− | order packets by player. Example:
| + | |
− | MrApathyCream 335 +- 10ms
| + | |
− | Gerbol 210 +- 3ms
| + | |
− | captain_macgyver 155 +- 0ms 12% lost/ooo
| + | |
− | | + | |
− | | + | |
− | /idlestats
| + | |
− | Displays the idle time in seconds for each player. A player is idle when
| + | |
− | he is dead and has not respawned yet.
| + | |
− | | + | |
− | MrApathyCream: 0s
| + | |
− | Gerbol: 80s
| + | |
− | captain_macgyver: 13s
| + | |
− | | + | |
− | | + | |
− | /flaghistory
| + | |
− | Lists what flags players have grabbed in the past. Example:
| + | |
− | MrApathyCream: (<-) (->) (O) (CB) (M) (B) (JM) (WA)
| + | |
− | Gerbol: (L) (GM) (L) (GM) (CL) (ST) (GM) (L)
| + | |
− | captain_macgyver: (SB) (SW)
| + | |
− | | + | |
− | | + | |
− | | + | |
− | /clientquery [callsign]
| + | |
− | Retrieve client version info from all users, or just CALLSIGN if given Example:
| + | |
− | /clientquery MrApathyCream
| + | |
− | MrApathyCream: Version: BZFlag 1.11.6-20040729-gnu-linux-SDL
| + | |
− | | + | |
− | | + | |
− | /report {message}
| + | |
− | Write a message to the server administrator. Example:
| + | |
− | /report I like this map!
| + | |
− | | + | |
− | | + | |
− | /part {message}
| + | |
− | Leave the server with a goodbye message (similar to IRC's /part)
| + | |
− | /part Gotta go! bye everyone!
| + | |
− | | + | |
− | | + | |
− | /quit {message}
| + | |
− | Quit the game with a goodbye message (similar to IRC's /quit)
| + | |
− | /quit Gotta go! bye everyone!
| + | |
− | | + | |
− | | + | |
− | /me
| + | |
− | This command displays an "action" that is conveyed to another player. It allows
| + | |
− | for a little more expressivity in the game. For example: "/me is hunting wabbits"
| + | |
− | turns into a message like "TimRiker is hunting wabbits" that gets displayed
| + | |
− | differently to other players.
| + | |
− | | + | |
− | | + | |
− | /msg some player some message
| + | |
− | | + | |
− | This command allows a player to send a message to another player. Similar to using
| + | |
− | the "," and "." message keys in the game and then selecting your recipient, this
| + | |
− | will send some message to particular player. The quotes are optional.
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | SERVER ADMINISTRATIVE COMMANDS
| + | |
− | | + | |
− | | + | |
− | /viewreports
| + | |
− | View the server's report file.
| + | |
− | | + | |
− | | + | |
− | /record list
| + | |
− | List all files in the recordings directory
| + | |
− | | + | |
− | /record start
| + | |
− | Start recording into the memory buffer
| + | |
− | | + | |
− | /record stop
| + | |
− | | + | |
− | /record file <filename>
| + | |
− | Start recording directly to a file
| + | |
− | | + | |
− | /record save <filename> [seconds]
| + | |
− | Save the recording buffer into a file. If seconds is specified,
| + | |
− | then only save that many previous seconds into the file.
| + | |
− | | + | |
− | | + | |
− | /replay list
| + | |
− | List all files in the recordings directory
| + | |
− | | + | |
− | /replay load <filename|#index>
| + | |
− | Load the specified recording file by name, or by index (same
| + | |
− | indices as produced by the 'replay list' command)
| + | |
− | | + | |
− | /replay play
| + | |
− | Start playing the recording. This will oftentimes require that
| + | |
− | all players connected to the server rejoin (to reload the map,
| + | |
− | etc...)
| + | |
− | | + | |
− | /replay loop
| + | |
− | Start looping the recording. This will oftentimes require that
| + | |
− | all players connected to the server rejoin (to reload the map,
| + | |
− | etc...)
| + | |
− | | + | |
− | /replay skip [+/- seconds]
| + | |
− | If seconds is specified, then skip that amount of time in the
| + | |
− | recording. Otherwise, skip forwards until there is activity.
| + | |
− | /replay stats Show the current replay status (filename, posi-
| + | |
− | tion, etc...)
| + | |
− | | + | |
− | | + | |
− | /shutdownserver
| + | |
− | Stop serving BZFlag on this server
| + | |
− | | + | |
− | /superkill
| + | |
− | Kick all players off the server
| + | |
− | | + | |
− | /gameover
| + | |
− | Ends the current game
| + | |
− | | + | |
− | /flag reset {unused}
| + | |
− | Repositions flags. If unused is specified, flags carried by
| + | |
− | tanks are not affected.
| + | |
− | | + | |
− | /flag up
| + | |
− | Removes all flags from the game
| + | |
− | | + | |
− | /flag show
| + | |
− | Shows all flags with information. Example:
| + | |
− | 0: p:-1 r:1 g:1 1:V s:1 p:159.1x43.2x0.0
| + | |
− | A reason is required
| + | |
− | | + | |
− | | + | |
− | /kill <"Player name" | playerName | #slot> [reason]>
| + | |
− | Kill a player just like when shooting.
| + | |
− | | + | |
− | Example:
| + | |
− | /kill Gerbol
| + | |
− | kill the player named Gerbol
| + | |
− | /kill #4 teamkilling
| + | |
− | Kill the player using slot 4 because teamkilling
| + | |
− | | + | |
− | | + | |
− | /playerlist
| + | |
− | List player names and IP addresses. Example:
| + | |
− | /playerlist
| + | |
− | [0]MrApathyCream: 35.23.65.44:4808 udp id
| + | |
− | [1]Gerbol: 130.123.1.55:4909 udp id
| + | |
− | [2]captain_macgyver: 15.32.122.51:3201 udp id
| + | |
− | | + | |
− | | + | |
− | /ban <ip | ipList | #slot | Player name | playerName > <duration> <reason>
| + | |
− | | + | |
− | Ban players using the specified IPs for certain length of time
| + | |
− | from using this server.
| + | |
− | <duration> can be:
| + | |
− | 'short' or 'default' for the default ban time
| + | |
− | 'forever' or 'max' for infinite bans
| + | |
− | a time in the format <weeks>W<days>D<hours>H<minutes>M
| + | |
− | just a number of minutes
| + | |
− | | + | |
− | Examples:
| + | |
− | /ban 35.23.43.66 2 cheating
| + | |
− | bans player with specific ip for 2 minutes
| + | |
− | /ban 35.23.*.*,47.23.17.* 0 Cheaters
| + | |
− | bans all ips in this range forever
| + | |
− | /ban 36.37.2.8 2h30m "ShootMe" was abusing players
| + | |
− | bans specific ip for 2.5 hours with given reason
| + | |
− | /ban #5 60m Rejoining
| + | |
− | bans player using slot 5 for 60 minutes with given reason
| + | |
− | /ban "Tanker" max cheating
| + | |
− | bans the player Tanker forever because cheating
| + | |
− | | + | |
− | Note: Slots numbers are only displayed in admins clients.
| + | |
− | Duration and reason are required.
| + | |
− | | + | |
− | | + | |
− | /banlist
| + | |
− | List all of the IPs currently banned from this server. Example:
| + | |
− | /banlist
| + | |
− | IP Ban List
| + | |
− | ------------
| + | |
− | | + | |
− | | + | |
− | /hostbanlist
| + | |
− | List all of the host patterns currently banned from this server.
| + | |
− | | + | |
− | /say {message}
| + | |
− | Generate a public message sent by the server. Example:
| + | |
− | | + | |
− | /say This is a servermessage
| + | |
− | | + | |
− | | + | |
− | /sendhelp <"Player name" | playerName | #slot> <help page>
| + | |
− | Send the specified help page to a user
| + | |
− | | + | |
− | /send register "Foo"
| + | |
− | Send the the help page 'register' to the player Foo
| + | |
− | | + | |
− | | + | |
− | /countdown [seconds]
| + | |
− | Starts the countdown sequence for a timed game. The countdown
| + | |
− | sequence length can optionally be specified in seconds. Examples:
| + | |
− | | + | |
− | /countdown
| + | |
− | /countdown 3
| + | |
− | | + | |
− | | + | |
− | /lagwarn
| + | |
− | | + | |
− | Dynamic change the maximum allowed lag time. Example:
| + | |
− | | + | |
− | /lagwarn 300
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | USER MANAGEMENT
| + | |
− | | + | |
− | Generally, you start with empty files for the user and password data-
| + | |
− | bases. These are maintained by the server, and modifiable through
| + | |
− | server commands. Users in turn belong to groups. Groups are generally
| + | |
− | customized to perhaps allow administrative control to trusted users.
| + | |
− | | + | |
− | There are both local and global groups, i.e. groups that are available
| + | |
− | across the entire BZFlag network. In setting up a server, you may want
| + | |
− | to specify global groups that will allow already well known and trusted
| + | |
− | users to police your server and help maintain control against cheaters
| + | |
− | and abuse.
| + | |
− | | + | |
− | The server will automatically create three groups: EVERYONE, VERIFIED,
| + | |
− | and LOCAL.ADMIN. EVERYONE has ACTIONMESSAGE, ADMINMESSAGESEND, DATE,
| + | |
− | FLAGHISTORY, IDLESTATS, LAGSTATS, PRIVATEMESSAGE and SPAWN by default.
| + | |
− | VERIFIED has POLL, POLLKICK, POLLBAN, POLLSET, POLLFLAGRESET, and VOTE.
| + | |
− | The LOCAL.ADMIN group has almost every permission possible (similar to
| + | |
− | granting admin powers via /password).
| + | |
− | | + | |
− | | + | |
− | A group database file is set up to contain the specific local and
| + | |
− | global groups you care to have on your server in addition to default
| + | |
− | groups and exactly which permissions are granted by each. These files
| + | |
− | are laid out with one line per group, using the following format:
| + | |
− | | + | |
− | GROUP_NAME: [*Group] [+|-|!]perm1 [+|-|!]perm2 ... permN
| + | |
− | | + | |
− | | + | |
− | *Group: inhert permissions from existing group "Group"
| + | |
− | | + | |
− | +perm: add perm to this group
| + | |
− | | + | |
− | -perm: remove perm from this group
| + | |
− | | + | |
− | !perm: forbid perm for this group. makes perm inaccessable whether it's
| + | |
− | granted from another group or not
| + | |
− | | + | |
− | If no operator is given with a permission it is handled like +perm. A
| + | |
− | group line for a previously existing group adds to already granted per-
| + | |
− | missions. That way you can spread a group's definition over several
| + | |
− | lines:
| + | |
− | | + | |
− | GROUP_NAME: +perm1 +perm2
| + | |
− | GROUP_NAME: +perm3 +perm4 -perm5
| + | |
− | | + | |
− | Group names cannot have spaces, quotes, or other special characters in
| + | |
− | them. This would be a sample line defining a "cop" group:
| + | |
− | | + | |
− | COPS: +KICK +SHORTBAN +BANLIST
| + | |
− | | + | |
− | Now a group USERADMIN with all permissions granted to COPS plus some
| + | |
− | additional could look like this:
| + | |
− | | + | |
− | USERADMIN: *COPS +BAN +UNBAN
| + | |
− | | + | |
− | Probably you want to define customized permissions for the default
| + | |
− | group "VERIFIED" instead of those automatically asigned by the server:
| + | |
− | | + | |
− | VERIFIED: -ALL +perm1 +perm2 ...
| + | |
− | | + | |
− | Or you want to disable the /poll command entirely?
| + | |
− | | + | |
− | EVERYONE: !POLL
| + | |
− | | + | |
− | To distinguish between a group that is local and one that is global,
| + | |
− | use the "LOCAL." prefix as part of the group name, e.g.:
| + | |
− | | + | |
− | LOCAL.OPERATOR: BANLIST
| + | |
− | | + | |
− | | + | |
− | The available permissions are as follows:
| + | |
− | KICK /kick
| + | |
− | LAGSTATS /lagstats
| + | |
− | LAGWARN /lagwarn
| + | |
− | LISTPERMS not implemented
| + | |
− | MUTE /mute
| + | |
− | PLAYERLIST /playerlist
| + | |
− | POLL /poll
| + | |
− | POLLBAN /poll ban
| + | |
− | POLLFLAGRESET /poll flagreset
| + | |
− | POLLKICK /poll kick
| + | |
− | POLLSET /poll set
| + | |
− | PRIVATEMESSAGE /msg
| + | |
− | REJOIN allows instant rejoin, regardless of _rejoinTime
| + | |
− | REMOVEPERMS /removegroup
| + | |
− | REQUIREIDENTIFY user must /identify when using this locally regis-
| + | |
− | tered callsign
| + | |
− | SAY /say
| + | |
− | SETALL use of all set/remove commands
| + | |
− | SETPERMS /setgroup
| + | |
− | SETPASSWORD not implemented
| + | |
− | SETVAR /set /reset
| + | |
− | SHOWOTHERS not implemented
| + | |
− | SHUTDOWNSERVER /shutdownserver
| + | |
− | SPAWN join game as a player. observers don't need this
| + | |
− | flag.
| + | |
− | SUPERKILL /superkill
| + | |
− | TALK allows all players to send messages
| + | |
− | UNBAN /unban /hostunban
| + | |
− | UNMUTE /unmute
| + | |
− | VETO /veto
| + | |
− | VOTE /vote
| + | |
− | | + | |
− | | + | |
− | /register {password}
| + | |
− | | + | |
− | Register your current callsign to the specified password. Pass-
| + | |
− | words must be at least 3 characters long, and the callsign may
| + | |
− | not contain quotes or other non-alphanumeric/space characters
| + | |
− | | + | |
− | | + | |
− | /identify {password}
| + | |
− | | + | |
− | Log in to a registered callsign
| + | |
− | | + | |
− | | + | |
− | /setpass {password}
| + | |
− | | + | |
− | Changes your password
| + | |
− | | + | |
− | | + | |
− | /ghost {callsign} {password}
| + | |
− | | + | |
− | | + | |
− | Lists the groups that a registered user is a member of
| + | |
− | | + | |
− | | + | |
− | /setgroup {callsign} {group}
| + | |
− | | + | |
− | Add a user to a group
| + | |
− | | + | |
− | | + | |
− | /removegroup {callsign} {group}
| + | |
− | | + | |
− | Remove a user from a group
| + | |
− | | + | |
− | | + | |
− | /reload
| + | |
− | | + | |
− | Reloads the user, group, and password files (for synchronization
| + | |
− | between multiple servers on the same machine)
| + | |
− | | + | |
− | | + | |
− | /deregister [callsign]
| + | |
− | | + | |
− | With an argument, it deregisters another user's callsign. With-
| + | |
− | out, it removes your own registration.
| + | |
− | | + | |
− | | + | |
− | /poll ban|kick|vote|veto [...]
| + | |
− | | + | |
− | Interact and make requests of the bzflag voting system via the
| + | |
− | /poll command. The ban and kick subcommands request a vote to
| + | |
− | respectively ban or kick some player. The playername is
| + | |
− | expected as the next argument. The vote and veto commands
| + | |
− | behave identical to the /vote and /veto command counterparts,
| + | |
− | expecting the same arguments in following. By default, you must
| + | |
− | be registered to request and vote on a poll.
| + | |
− | | + | |
− | | + | |
− | /vote yes|no
| + | |
− | | + | |
− | If there is a poll active, this command will place a vote in
| + | |
− | favor or in opposition to the poll. Multiple languages are sup-
| + | |
− | ported as a vote argument in addition to "yes" and "no". By
| + | |
− | default, you must be registered to vote on a poll.
| + | |
− | | + | |
− | | + | |
− | /veto If there is a poll active, this will cancel the poll. By
| + | |
− | default, you must be an admin to veto a poll.
| + | |
− | | + | |
− | | + | |
− | /masterban flush|reload
| + | |
− | | + | |
− | Forces the server to flush any bans from the master server. If
| + | |
− | | + | |
− | Allows a server admin to restore the TALK permission to a previ-
| + | |
− | ously muted player. usage: /unmute <#slot> | <playername>
| + | |
− | | + | |
− | | + | |
− | | + | |
− | Worlds
| + | |
− | | + | |
− | BZFlag worlds come in two varieties, randomly generated ones, and human
| + | |
− | designed ones. By default, bzfs uses randomly generated world unless
| + | |
− | you specify the -world command line or configuration file option. The
| + | |
− | world file specified by the -world option is a text based file that
| + | |
− | contains a list of world objects. This file can be created using pro-
| + | |
− | grams found on sourceforge.net through cvs, or can be hand edited. See
| + | |
− | the bzw(5) manual page for more details.
| + | |
− | | + | |
− | | + | |
− | | + | |
− | | + | |
− | SEE ALSO
| + | |
− | | + | |
− | bzflag(6), bzadmin(6), bzw(5)
| + | |
− | | + | |
− | | + | |
− | | + | |
− | bzfs-2.0.4 2006-04-17 bzfs(6)
| + | |
BZFS is name of the the [[[BZFlag]] server application. It is a command line application that can ether be run manually or started from within the game. The server supports a large list of command line options that can be used.