Command options

For a list of all options, try xpilots -help. See also sections Defaults file options and Map file options.

-help

Prints a short help, including the supported commandline options.

[command] Without a parameter, this displays a brief message, listing the supported commandline options. Specifying a command displays help for the command.

-version

Prints the current version.

-dump

Prints all options with their default values in defaults file format.

-defaultsFileName or defaults string

The filename of the defaults file to read on startup.

Defaults file options

For a list of all options, try xpilots -help. See also sections Command options and Map file options.

-passwordFileName string

The filename of the password file to read on startup. This file should be protected against unwanted eyes with chmod(1) (e.g. chmod 600 password).

-robotFile string

The file containing parameters for robot details.

-/+idleRun or rawMode

Do robots keep on playing even if all human players quit?

If this option is specified, xpilots doesn't go to sleep when there are no human players logged into the game. The noquit option must be specified for this to have any effect after the first player joins the game.

-/+noQuit

Does the server wait for new human players to show up after all players have left.

If this option is specified, xpilots won't quit when the last human player exits.

-/+logRobots

Log the comings and goings of robots.

-mapFileName or map string

The filename of the map to use. Or "wild" if you want a map by The Wild Map Generator.

This option allows you to select the map you will use for this server. If it is omitted, you will have to manage with a computer generated random map. For instructions on how to create a map, see below. For example if -map fuzz2 or the equivalent -map fuzz2.xp is passed as command line arguments, the server will try to locate a file called fuzz2.xp in the current directory, or in a predefined directory (default is /usr/local/share/xpilot/maps/).

-contactPort or port integer

The server contact port number.

-serverHost string

The server's fully qualified domain name (for multihomed hosts).

Specifies to the meta server the FQDN (fully qualified domain name) of the server. This is helpful if the system has multiple identities and one is preferred over the other. Also, this option may be used to bind xpilots to a specific IP number on multihomed hosts (hosts with more than one IP number) such as virtual hosting sites. Otherwise, the default behaviour of xpilots is to listen to any IP number on the host and to try by various methods, starting with the value returned by gethostname(2) to determine the host's FQDN (fully qualified domain name) and report that to the meta servers.

-/+reportToMetaServer or reportMeta

Keep the meta server informed about our game?

The default for xpilots is -reportMeta. Specify +reportMeta to suppress reporting the xpilots server to the xpilot meta server so that other players on the Internet may find it. This should be done whenever a server is unreachable either due to a firewall that is not configured to allow access to it, or when the connection to the server is so poor that players on the Internet would not enjoy playing on it, as is arguably the case with any dialup ISP connection.

-/+searchDomainForXPilot

Search the local domain for the existence of xpilot.domain?

-denyHosts string

List of network addresses of computers which are denied service. Each address may optionally be followed by a slash and a network mask.

-/+ignore20MaxFPS

Ignore client maxFPS request if it is 20 (the default setting).

-motdFileName or motd string

The filename of the MOTD file to show to clients when they join.

-scoreTableFileName or scoretable string

The filename for the score table to be dumped to.

-/+pLockServer

Whether the server is prevented from being swapped out of memory.

-timerResolution integer

If set to nonzero xpilots will requests signals from the OS at 1/timerResolution second intervals. The server will then compute a new frame FPS times out of every timerResolution signals.

-password string

The password needed to obtain operator privileges.

Allows operator privileges to be gained during a game by those who know the password via commands typed in the client's message window. See the Message-window commands section below.

Note that specifying this on the command line is not secure unless you are the sole user of the host xpilots is started on, as ps(1) may be used to retrieve the options passed on the command-line when the server was started. A more secure way of starting a passworded server is to set the password in the password file and protect the mapfile with chmod(1) (e.g. chmod 600 password) to keep it private.

-clientPortStart integer

Use UDP ports clientPortStart - clientPortEnd (for firewalls)

When the xpilots server is behind an IP masquerading or NAT firewall, the UDP ports used for client connections (as distinct from the contact port, which by default is 15345/udp) must be defined by the server, and the firewall must be configured to forward the defined port range to the xpilots server host. Use this switch with -clientPortEnd to define the range. For example, start the server with xpilots -clientPortStart 40000 -clientPortEnd 40009 and on the firewall redirect ports 40000/udp through 40009/udp to the host that xpilots is running on. One port must be reserved for each client, so reserve the same number of ports as there are bases on the map.

-clientPortEnd integer

Use UDP ports clientPortStart - clientPortEnd (for firewalls)

Used with -clientPortStart to reserve a range of UDP ports for client connections.

Map file options

For a list of all options, try xpilots -help. See also sections Command options and Defaults file options.

-robots number

Tells the server that you want number robots instead of the default - number-of-bases/2. A value of -1 will fill the entire server with robots. Note however that there will always be room for one new player, the robots will be kicked out of the game to accomodate for new players, they will also enter the game when there is space for them.

Prompt options (owner only)

m

Send a message to the players.

k

Kick a player out of the game. Currently, this command does not stop the player from re-joining the game. Hopefully, however, he or she would have learned their lesson.

l

Lock/unlock the game. This prevents other users from joining the game.

d

Shutdown/cancel shutdown. This command will ask for a reason and a shutdown delay (in seconds) and transmit these to the server. A timer will appear showing how much time is left before the game goes down. If you don't specify a delay, you will be canceling an already initiated shutdown.

Message-window commands

All such message-window commands start with the slash (/) character. These are divided into two groups, those which can be typed by ordinary players and those which are only accessible to operators who have first supplied the correct password with the /password message-window command. If a password is not set on the server by the owner, the operator commands are not usable.

Where a name is specified in the following commands, only leading characters in the name need to be typed. If two names start with the same characters, type as many characters as are needed to uniquely identify the player.

Player message-window commands