<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<!--
Things to note when editing this file:
a) Don't mess up the colour pattern, change the class="c1" and so-on accordingly to get it right.
b) Ensure you add your new argument into the correct category, then, expand the
"rowspan" on that category by one. Otherwise, set up a new category using existing ones as templates.
c) Please keep to the style provided and make your instructions 'n00b' friendly, thanks.
d) Add an "id" to each new argument, with the arguments switch, so it can be easily linked to, if need be.
-->
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<meta name="robots" content="NOODP">
<meta name="author" content="Rabid Viper Productions">
<meta name="copyright" content="You may be able to redistribute this content under specific conditions.
Please read the licensing information, available @ http://assault.cubers.net/docs/license.html for the
conditions that would apply to what you may be redistributing.">
<title>AssaultCube Documentation :: Command line arguments</title>
<link rel="stylesheet" type="text/css" href="css/main.css">
<link rel="stylesheet" type="text/css" href="css/docs.css">
<link rel="stylesheet" type="text/css" href="css/fancytable.css">
<!--#include virtual="/SSI-HTML/docs/invisibility.html" -->
<link rel="shortcut icon" href="images/favicon.ico">
<style type="text/css">
table, tr, td {
text-align : left;
}
.verttxt {
text-align : center;
font-weight : bold;
font-size : 14px;
vertical-align: middle;
padding : 10px;
}
.c1 {
text-align : center;
background-color : #0C0C0C;
vertical-align: top;
font-size : 15px;
}
.c2 {
background-color : #0C0C0C;
}
.c3 {
text-align : center;
vertical-align: top;
font-size : 15px;
}
</style>
</head>
<body>
<div id="container">
<div id="docsheader">
AssaultCube Documentation
</div>
<div id="logo">
<a href="index.html"><img src="images/aclogo.png"
alt="AssaultCube" width="193px" height="81px"></a>
</div>
<div id="menubar">
<!--#include virtual="/SSI-HTML/docs/navigation_box_docs.html" -->
</div>
<!--#include virtual="/SSI-HTML/docs/docswarn.html" -->
<div class="docsmain">
<div id="gohome">
<a href="index.html">Go to documentation index ↵</a>
</div>
<h2>Command line arguments</h2>
<p>
When you launch AssaultCube, you're able to pass what are known as "arguments" or "switches"
to the launcher, which will force particular settings to occur when AssaultCube runs.
</p>
<p>
Depending on your operating system, the way to pass these arguments will differ, see the following:
</p>
<table>
<tr>
<td style="text-align : center; width : 290px;" class="c2">
<img src="images/windows.png" alt="Microsoft Windows">
<br><b>Microsoft Windows</b>
</td>
<td style="text-align : center; width : 290px;">
<img src="images/linux.png" alt="Linux">
<br><b>Linux</b>
</td>
<td style="text-align : center; width : 290px;" class="c2">
<img src="images/apple.png" alt="Apple Mac OS X">
<br><b>Apple Mac OS X</b>
</td>
</tr>
<tr>
<td>
In the AssaultCube folder is a file named "<i>assaultcube.bat</i>". Right
click this and open it with "notepad" to edit the launcher for the
<span class="titletext" title="the client is what you use to play the game, i.e. NOT the server.">client</span>.
<br>After running the server wizard, in this folder will be a "<i>server_autoconfigured.bat</i>".
Right click this and open it with "notepad" to edit the launcher for the server.
<br><br>
All arguments need to be placed after the phrase:
<span class="code"><span class="titletext" title="...or if it's a server: bin_win32\ac_server.exe">bin_win32\ac_client.exe</span></span>
<br>... and before the phrase: <span class="code">%1 %2 %3 %4 %5</span>
<br><br>
Remember to save the file when you've finished!
</td>
<td class="c2">
In the AssaultCube folder is a file named "<i>assaultcube.sh</i>". Open it with your
favourite text editor (such as: gedit, GNU nano, Vim, GNU Emacs, Kate, etc.) to edit
the launcher for the
<span class="titletext" title="the client is what you use to play the game, i.e. NOT the server.">client</span>.
<br>
After running the server wizard, in this folder will be "<i>server_autogenerated.sh</i>".
Open it with your favourite text editor to edit the launcher for the server.
<br><br>
For the client, all arguments must be placed within the quotes on this line:
<span class="code">CUBE_OPTIONS="--home=${HOME} /.assaultcube --init"</span><br>
For the server, just add your arguments after the phrase: <span class="code">./server.sh</span>.
<br><br>
Remember to save the file when you've finished!
</td>
<td>
After starting the AssaultCube launcher, under the "Main" tab of the AssaultCube
launcher is an "Advanced options" bar. You can type all the arguments you need for the client into there.
<br><br>
For the server, under the "Server" tab of the AssaultCube launcher is an "Advanced options" bar.
You can type all the arguments you need for the server into there.
</td>
</table>
<h2 id="clientswitch" style="padding-top : 20px;">Arguments for the AssaultCube <span class="titletext"
title="the client is what you use to play the game, i.e. NOT the server.">client</span></h2>
<p>
These arguments are specifically for the clients launcher, not the server. All of the arguments are case-sensitive!
<br><b>Note:</b> Some of these options can be changed in-game through the menus, without the need to manually force these arguments.
</p>
<table>
<tr>
<td> </td>
<td class="head01">Argument</td>
<td class="head01">Description</td>
</tr>
<tr>
<td rowspan="8" class="verttxt">
G<br>R<br>A<br>P<br>H<br>I<br>C<br>A<br>L
</td>
<td class="c1" id="client-w">
-w<b>X</b>
</td>
<td class="c2">
Sets the desired screen width to <span class="code">X</span>.
The default is <span class="code">-w1024</span>
</td>
</tr>
<tr>
<td class="c3" id="client-h">
-h<b>Y</b>
</td>
<td>
Sets the desired screen height to <span class="code">Y</span>.
The default is <span class="code">-h768</span>
</td>
</tr>
<tr>
<td class="c1" id="client-t">-t</td>
<td class="c2">
Forces AssaultCube to run in "window" mode (turns fullscreen off).
<br>You can explicitly force fullscreen mode by using <span class="code">-t1</span>
</td>
</tr>
<tr>
<td class="c3" id="client-z">-z<b>N</b></td>
<td>
Sets the precision of the <a href="http://en.wikipedia.org/wiki/Z-buffering">z-buffer</a>
to <span class="code">N</span> bits.
<br>This should be at least 24 or you may experience depth problems.
</td>
</tr>
<tr>
<td class="c1" id="client-b">-b<b>N</b></td>
<td class="c2">Sets the <a href="http://en.wikipedia.org/wiki/Color_depth">colour depth</a>
to <span class="code">N</span> bits per pixel
(example: <span class="code">-b16</span> would set the colour depth to 16-bits).</td>
</tr>
<tr>
<td class="c3" id="client-s">-s<b>N</b></td>
<td>
Sets the stencil buffer precision to <span class="code">N</span> bits.
<br>This needs to be either 8 to enable shadowing effects, or 0 to turn it off (the default).
</td>
</tr>
<tr>
<td class="c1" id="client-a">-a<b>N</b></td>
<td class="c2">
Sets <a href="http://en.wikipedia.org/wiki/Spatial_anti-aliasing#Super_Sampling_.2F_Full-scene_anti-aliasing">full-scene
anti-aliasing</a> to <span class="code">N</span> samples (example: <span class="code">-a4</span> is 4x).
</td>
</tr>
<tr>
<td class="c3" id="client-v">-v<b>N</b></td>
<td>
Enables <a href="http://en.wikipedia.org/wiki/Screen_tearing#V-sync">v-sync</a> if <span class="code">N</span> is greater than 0.
If <span class="code">N</span> equals -1 then system defaults will be used.
</td>
</tr>
<tr>
<td rowspan="3" class="verttxt">
O<br>N<br><br>L<br>A<br>U<br>N<br>C<br>H
</td>
<td class="c1" id="client--loadmap">--loadmap=<b>FILE</b></td>
<td class="c2">
Forces AssaultCube to load the map named <span class="code">FILE</span> when launched.
</td>
</tr>
<tr>
<td class="c3" id="client--loaddemo">--loaddemo=<b>FILE</b></td>
<td>Forces AssaultCube to playback the demo named <span class="code">FILE</span> when launched.
</tr>
<tr>
<td class="c1" id="client-e">-e<b>"C"</b></td>
<td class="c2">
Executes the command <span class="code">C</span> on launch (i.e. -e"echo hello"). Refer to the
<a href="reference.xml">CubeScript command reference</a> for a list of all possible commands.
</td>
</tr>
<tr>
<td rowspan="6" class="verttxt">
M<br>O<br>D<br>D<br>I<br>N<br>G
</td>
<td class="c3" id="client--init">--init</td>
<td>
Executes the init script before starting the graphics and sound subsystems (recommended).
By default, the file <i>./config/init.cfg</i> is used. This can be overriden by setting
<span class="code">--init=yourfile.cfg</span>
</td>
</tr>
<tr>
<td id="client--mod" class="c1">--mod=<b>PATH</b></td>
<td class="c2">
Adds the specified path to the list of directories to be searched when loading resources.
Use this to "MOD" the game in a clean way without having to place/replace files in the main directory.
<br>See the <a href="mods.html">custom mods</a> page for more information.
<br>Note: Mods need to be added into the <a href="commandline.html#client--home">--home</a>
directory if one is specified.
</td>
</tr>
<tr>
<td class="c3" id="client--home">--home=<b>PATH</b></td>
<td>
Specifies the <a href="faqs.html#n10">AssaultCube home folder</a>.
<br>AssaultCube will write custom settings and files to this directory (recommended).
</td>
</tr>
<tr>
<td class="c1" id="client-m">-m<b>HOSTNAME/IP</b></td>
<td class="c2">
Sets the client to update its serverlist from the hostname or IP address of a different masterserver.
<br>The default is <span class="code">-massault.cubers.net</span>
</td>
</tr>
<tr>
<td class="c3" id="client--masterport">--masterport=<b>PORT</b></td>
<td>
Sets the port of the masterserver the client will use, the default is 28760.
</td>
</tr>
<tr>
<td class="c1" id="client--mastertype">--mastertype=<b>TYPE</b></td>
<td class="c2">
Sets the method the client will use to contact the masterserver. 0 is UDP, 1 is HTTP (default).
</td>
</tr>
<tr>
<td rowspan="4" class="verttxt">
M<br>I<br>S<br>C
</td>
<td class="c3" id="client-T">-T</td>
<td>Tags a timestamp to each line of text output to the console.</td>
</tr>
<tr>
<td class="c1" id="client-d">-d</td>
<td class="c2">
This starts the executable file for the AssaultCube CLIENT, as an AssaultCube SERVER instead.
You don't need this argument if you're using the server executable. There is no need to use
this argument unless you know what you're doing.
</td>
</tr>
<tr>
<td class="c3" id="client--version">--version</td>
<td>Prints out the version number (example: 1.104) instead of running AssaultCube.</td>
</tr>
<tr>
<td class="c1" id="client--protocol">--protocol</td>
<td class="c2">Prints out the protocol number (example: 1140) instead of running AssaultCube.</td>
</tr>
</table>
<h2 id="serverswitch" style="padding-top : 20px;">Arguments for the AssaultCube server</h2>
<p>
These arguments are specifically for the servers launcher, not the client. All of the arguments are case-sensitive!
</p>
<table>
<tr>
<td> </td>
<td class="head01">Argument</td>
<td class="head01">Description</td>
</tr>
<tr>
<td class="verttxt">
S<br>I<br>Z<br>E
</td>
<td class="c1" id="server-c">-c<b>N</b></td>
<td class="c2">
Sets the maximum number of players that can play on the server to N (default 6).
The masterserver will only register servers with N set to a value less or equal 16.
If extra players try to connect they will receive a "server full" error message.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="4">
N<br>A<br>M<br>I<br>N<br>G
</td>
<td class="c3" id="server-n">-n<b>S</b></td>
<td>
Sets the server description that shows in the server list.
Make sure you keep it short, otherwise it'll become truncated, example: -n"Fruity: Bananas & Cherry"
</td>
</tr>
<tr>
<td class="c1" id="server-n1">-n1<b>S</b></td>
<td class="c2">
Sets a prefix for the server description that remains when the server description is changed using the
<a href="http://assault.cubers.net/docs/reference.xml#identifier_serverdesc" class="code">/serverdesc</a>
command. A prefix AND/OR suffix MUST be specified for the <span class="code">/serverdesc</span> command to work.
</td>
</tr>
<tr>
<td class="c3" id="server-n2">-n2<b>S</b></td>
<td>
Sets a suffix for the server description that remains when the server description is changed using the
<a href="http://assault.cubers.net/docs/reference.xml#identifier_serverdesc" class="code">/serverdesc</a>
command. A suffix AND/OR prefix MUST be specified for the <span class="code">/serverdesc</span> command to work.
</td>
</tr>
<tr>
<td class="c1" id="server-o">-o<b>N</b></td>
<td class="c2">
Sets the servers MOTD (message of the day), which appears on the client's console after they connect to the server.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="2">
I<br>P<br><br>&<br><br>P<br>O<br>R<br>T
</td>
<td class="c3" id="server-i">-i<b>IP</b></td>
<td>
Binds the AssaultCube server to a single IP address. This option is only of use for servers that have multiple
IP addresses. Don't use this unless you know what you're doing.
</td>
</tr>
<tr>
<td class="c1" id="server-f">-f<b>PORT</b></td>
<td class="c2">
The AssaultCube server uses 2 ports (UDP), the default ports are 28763 and 28764.
You need to use different ports if you want to run several servers on the same IP address.
This argument allows you to bind the AssaultCube server to other ports.
For example: <span class="code">-f9000</span> would run a server on ports 9000 and 9001.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="3">
P<br>R<br>I<br>V<br>A<br>T<br>I<br>S<br>I<br>N<br>G
</td>
<td class="c3" id="server-p">-p<b>PASSWD</b></td>
<td>
Sets the password of the server PASSWD. Only clients that know the password will be able to connect.
Clients will be required to append the password to the end of the
<a href="reference.xml#identifier_connect">connect</a> command.
</td>
</tr>
<tr>
<td class="c1" id="server-m">-m<b>HOSTNAME/IP</b></td>
<td class="c2">
Forces the server to register with the hostname or IP address of a different masterserver.
<br>The default is <span class="code">-massault.cubers.net</span>
<br>If you want your server to be hidden and not report to the masterserver, use <span class="code">-mlocalhost</span>
</td>
</tr>
<tr>
<td class="c3" id="server--masterport">--masterport=<b>PORT</b></td>
<td>
Sets the port on the masterserver to which the server will register, the default is 28760.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="2">
A<br>D<br>M<br>I<br>N<br>I<br>S<br>T<br>R<br>A<br>T<br>O<br>R
</td>
<td class="c1" id="server-x">-x<b>PASSWD</b></td>
<td class="c2">
Sets the <a href="server.html#serveradmin">administrator</a> password to <span class="code">PASSWD</span>.
If you don't want your commandline to contain the password, or if you need
more than one admin password, use the file "config/serverpwd.cfg".
<br><br>Once logged in with the administrator password (by using
<span class="code">/setadmin 1 YOURPASS</span>), further administrator options
are presented to you when opening the menu (however, not all, check the
<a href="reference.xml">CubeScript command reference</a> for other options).
</td>
</tr>
<tr>
<td class="c3" id="server-P">-P<b>fkbMASRCDEPw</b></td>
<td>
Sets whether the role required to call a specific vote belongs to a "player" or an "administrator".
The characters <span class="code">fkbMASRCDEPw</span> are used to set these requirements. <br>A lower-case character
enables normal players to call that vote, whereas an upper-case character will only allow an administrator to call
the vote. <br>If a character doesn't appear, then the defaults for that setting will be used.<br><br>
<table>
<tr>
<td> </td>
<td><span title="Is upper or lower case the default?" class="titletext">DEFAULT?</span></td>
<td>Vote description</td>
</tr>
<tr><td>f</td><td>Lower</td><td><a href="reference.xml#identifier_forceteam">Force</a> a player to the enemy team.</td></tr>
<tr><td>k</td><td>Lower</td><td><a href="reference.xml#identifier_kick">Kick</a> a player.</td></tr>
<tr><td>b</td><td>Lower</td><td><a href="reference.xml#identifier_ban">Ban</a> a player (and remove bans).</td></tr>
<tr><td>m</td><td>Upper</td><td><a href="reference.xml#identifier_mastermode">Change mastermode</a> (open/private/match).</td></tr>
<tr><td>a</td><td>Upper</td><td>Enable/disable <a href="reference.xml#identifier_autoteam">autoteam</a>.</td></tr>
<tr><td>s</td><td>Upper</td><td><a href="reference.xml#identifier_shuffleteams">Shuffle</a> the teams.</td></tr>
<tr><td>r</td><td>Upper</td><td>Record a demo of the next game (if autorecording is disabled).</td></tr>
<tr><td>c</td><td>Upper</td><td><a href="reference.xml#identifier_cleardemos">Clear all demos</a> on the server.</td></tr>
<tr><td>d</td><td>Upper</td><td><a href="reference.xml#identifier_serverdesc">Change server description</a>.</td></tr>
<tr><td>e</td><td>Upper</td><td>Can vote for <a href="reference.xml#identifier_coop">co-op edit mode</a>.</td></tr>
<tr><td>p</td><td>Upper</td><td>Can vote for a gamemode that isn't supported by the map.</td></tr>
<tr><td>t</td><td>Lower</td><td>Can send private messages to any player.</td></tr>
<tr>
<td>w</td><td>Lower</td>
<td>
Can vote to kick/ban for "weak" reasons. A "weak" reason is one where the server can't detect
if the player being voted against is lagging, teamkilling, spamming or cheating.
</td>
</tr>
</table>
<br>
For example: -PbmA enables ban & mastermode to be voted by normal players, but only an administrator can change autoteam.
<br>The '-P' argument can be used several times, for example: '-Pb -Pm -PA' is the same as '-PbmA'.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="7">
L<br>O<br>G<br>G<br>I<br>N<br>G
</td>
<td class="c1" id="server-V">-V</td>
<td class="c2">
Verbose mode. This enables additional log messages to be printed, including the server configuration files after parsing.
Using this argument twice will also enable logging of DEBUG messages. Be careful as your logs will show a part-obscured version
of the serverpwd.cfg file.
</td>
</tr>
<tr>
<td class="c3" id="server-T">-T</td>
<td>Tags a timestamp to each line of text output to the console/log files.</td>
</tr>
<tr>
<td class="c1" id="server-N">-N<b>ID</b>
<td class="c2">
Sets the log identity to <span class="code">ID</span> . By default, the log identity is 'IP[port]'.
<br>On Linux systems, the log identity is used for the syslog to identify server log entries.
<br>On Windows and Apple systems, the log identity is used to create the server log filename.
</td>
</tr>
<tr>
<td class="c3" id="server-F">-F<b>n</b></td>
<td>
Sets the syslog facility to <span class="code">n</span>.
Values from 0 to 7 are allowed, to make use of the facilities "local0" through to "local7".
By default, local6 is used. For further information, read the documentation of your installed syslog daemon.
</td>
</tr>
<tr>
<td class="c1" id="server-LF">-LF<b>n</b></td>
<td class="c2">
Sets the level of logging to <span class="code">n</span> for logging to file.
On Linux systems, this argument enables ADDITIONAL logging, as Linux systems already log to syslog.
<br>The following levels can be selected:<br><br>
<table>
<tr>
<td>0</td><td>DEBUG</td><td>Logs all messages.</td>
</tr>
<tr>
<td>1</td><td>VERBOSE</td>
<td>
Logs all messages of level VERBOSE and above
<br>This is the same as using the <span class="code">-V</span> argument.
</td>
</tr>
<tr>
<td>2</td><td>INFO</td>
<td>Logs all messages of level INFO and above.<br>This is the default on Windows/Mac.</td>
</tr>
<tr>
<td>3</td><td>WARNING</td><td>Log only messages of level WARNING and above.</td>
</tr>
<tr>
<td>4</td><td>ERROR</td><td>Log only messages of level ERROR.</td>
</tr>
<tr>
<td>5</td><td>NONE</td><td>Don't log to file. This is the default on Linux systems.</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="c3" id="server-LS">-LS<b>n</b></td>
<td>
Sets the level of logging to <span class="code">n</span> for logging to syslog.
This argument is ignored on non-Linux systems.
The following levels can be selected:<br><br>
<table>
<tr>
<td>0</td><td>DEBUG</td><td>Logs all messages.</td>
</tr>
<tr>
<td>1</td><td>VERBOSE</td>
<td>
Logs all messages of level VERBOSE and above
<br>This is the same as using the <span class="code">-V</span> argument.
</td>
</tr>
<tr>
<td>2</td><td>INFO</td>
<td>Logs all messages of level INFO and above.<br>This is the default for Linux.</td>
</tr>
<tr>
<td>3</td><td>WARNING</td><td>Log only messages of level WARNING and above.</td>
</tr>
<tr>
<td>4</td><td>ERROR</td><td>Log only messages of level ERROR.</td>
</tr>
<tr>
<td>5</td><td>NONE</td><td>Don't log to syslog. This is the default on Windows/Mac systems.</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="c1" id="server-l">-l</td>
<td class="c2">Disables periodic logging of the game's current status/score (enabled by default).</td>
</tr>
<tr>
<td class="verttxt" rowspan="4">
T<br>H<br>R<br>E<br>S<br>H<br>O<br>L<br>D<br>S
</td>
<td class="c3" id="server-k">-k<b>N</b></td>
<td>
Sets the kick threshold to <span class="code">N</span>. If a players score drops below it,
he will be kicked automatically. The default is -5, all negative values DO require a minus sign.
</td>
</tr>
<tr>
<td class="c1" id="server-y">-y<b>N</b></td>
<td class="c2">
Sets the ban threshold to <span class="code">N</span>. If a players score drops below it,
he will be banned automatically. The default is -6, all negative values DO require a minus sign.
</td>
</tr>
<tr>
<td class="c3" id="server-kA">-kA<b>N</b></td>
<td>
Sets the threshold (in seconds) for the "<span class="titletext" title="Away from keyboard">AFK</span>"
auto-kick to <span class="code">N</span>. The server won't auto-kick if:
<ul style="margin : 5px; list-style-type : square;">
<li>The servers mastermode is PRIVATE or MATCH.</li>
<li>If there are 4 or less players.</li>
<li>If the mode isn't team-based AND the server isn't full.</li>
</ul>
The server will assume inactive players, even if chatting or in spectate mode, as AFK.
If the value is set lower than 30 seconds, then AFK auto-kick is disabled.
The default setting is 45 seconds.
</td>
</tr>
<tr>
<td class="c1" id="server-kB">-kB<b>N</b></td>
<td class="c2">
Sets the amount of minutes a banned player will remain banned from the server to
<span class="code">N</span><br>The default is 20 minutes.
</td>
</tr>
<tr>
<td rowspan="3" class="verttxt">
M<br>A<br>P<br>S<br><br>&<br><br>M<br>O<br>D<br>E<br>S
</td>
<td class="c3" id="server-A">-A<b>N</b></td>
<td>
Restricts voting to administrators for a specific map OR a specific mode OR a specific mode on a specified map.
To restrict a specific mode only, use a <span class="titletext" title="#">hash</span> and append the
<a href="reference.xml#identifier_mode">mode number</a> to the end of this argument.
To restrict a specific map only, append the map name to this argument.
To restrict a specific mode on a map, append the map name to this argument, followed by a
<span class="titletext" title="#">hash</span> and the <a href="reference.xml#identifier_mode">mode number</a>.
<br>This argument can be used several times.
<br><br>Example: -Aac_desert#13 would restrict mode 13 on ac_desert.
<br>-Aac_shine restricts map ac_shine
<br>-A#11 restricts mode 11 (tosok) with any map.
</td>
</tr>
<tr>
<td class="c1" id="server-M">-M<b>curd</b></td>
<td class="c2">
Sets whether the role required to sendmap belongs to a "player" or an "administrator".
The characters <span class="code">curd</span> are used to set these requirements.
<br>A lower-case character enables normal players to do the listed sendmap action, whereas
an upper-case character will only allow an administrator to do the listed sendmap action.
If a character doesn't appear, then the defaults for that setting will be used.
<table>
<tr>
<td> </td>
<td><span title="Is upper or lower case the default?" class="titletext">DEFAULT?</span></td>
<td>Sendmap action description</td>
</tr>
<tr><td>c</td><td>Upper</td><td>Upload new maps to the server.</td></tr>
<tr><td>u</td><td>Upper</td><td>Update existing maps (with the same, or a newer revision).</td></tr>
<tr><td>r</td><td>Upper</td><td>Revert existing maps (to an older revision).</td></tr>
<tr><td>d</td><td>Upper</td><td>Delete a map from the server.</td></tr>
</table>
For example: -MCuD enables updating maps for normal players, but only admins can create or delete maps.
The '-M' argument can be used several times on the commandline. For example: '-MC -Mu -MD' is equivalent to '-MCuD'.
<br>Note: Only maps in the "incoming" folder are affected. Maps in the "official" and "servermaps" folders are
treated as <i>read only</i>. Also note that deleting maps is disabled for BOTH players AND admins by default; to enable
deletion of maps, you MUST use this argument.
</td>
</tr>
<tr>
<td class="c3" id="server-Z">-Z<b>i</b></td>
<td>
Sets the size limit (in megabytes) for maps being uploaded to the "incoming" folder to <span class="code">i</span>.
Any map being uploaded exceeding this limit, will be rejected. The default is 10 megabytes.
</td>
</tr>
<tr>
<td rowspan="6" class="verttxt">
D<br>E<br>M<br>O<br>S
</td>
<td class="c1" id="server-D">-D<b>n</b></td>
<td class="c2">
All games DO record demos (which can't be disabled). This argument however, sets the maximum number of recorded demos
to be held in the servers RAM at a time to <span class="code">n</span>.
As demos can become quite large (sometimes up to 2 megabytes),
it may be wise not to keep this setting too high if you're low on RAM and/or are running many servers.
Up to 5 demos are kept in RAM by default.
The oldest demo will be deleted automatically as necessary, to allow for recording of further demos.
If an invalid number is specified (example: 0), then this argument will revert to the default of 5 demos.
</td>
</tr>
<tr>
<td class="c3" id="server-DI">-DI</td>
<td>
Limit downloading of demos until the intermission (this will increase the intermission time if someone is downloading a demo).
</td>
</tr>
<tr>
<td class="c1" id="server-W">-W<b>f</b></td>
<td class="c2">
Sets the path (and optionally, the filename prefix) to write recorded demos to from RAM.
As an example: <span class="code">-Wserverdemos/mydemo</span> would save all demos to the
directory "serverdemos", with a prefix in the filenames of "mydemo".
<br>Demo filenames will contain the (optional) prefix, the (encoded) time, game mode and map.
To set a path without filename prefix, ensure you add a '/' to the end of this argument.
<br>The server owner has to take precautions that demo files don't fill up the file system,
as demos can become quite large (sometimes over 2 megabytes).
</td>
</tr>
<tr>
<td class="c3" id="server--demofilenameformat">--demofilenameformat=<b>s</b></td>
<td>
Changes the format used for saving demos (if the <span class="code">-W</span> argument
is used) to <span class="code">s</span>.
See <a href="reference.xml#identifier_demonameformat">demonameformat</a> for options.
</td>
</tr>
<tr>
<td class="c1" id="server--demotimestampformat">--demotimestampformat=<b>s</b></td>
<td class="c2">
Changes the timestamp format used for saving demos (if the <span class="code">-W</span> argument
is used) to <span class="code">s</span>.
See <a href="reference.xml#identifier_demotimeformat">demotimeformat</a> for options.
</td>
</tr>
<tr>
<td class="c3" id="server--demotimelocal">--demotimelocal=<b>s</b></td>
<td>
Changes whether timestamps are converted to localtime (if <span class="code">s</span> is set to 1)
or to use UTC (if <span class="code">s</span> is set to 0 - this is the default) when saving demos
(if the <span class="code">-W</span> argument is used).
See <a href="reference.xml#identifier_demotimelocal">demotimelocal</a>.
</td>
</tr>
<tr>
<td rowspan="9" class="verttxt">
C<br>H<br>A<br>N<br>G<br>E<br><br>C<br>F<br>G<br><br>F<br>I<br>L<br>E<br>P<br>A<br>T<br>H<br>S
</td>
<td class="c1" id="server-C">-C<b>f</b></td>
<td class="c2">
Reads commandline arguments from a file (no files are read by default).
For example, <span class="code">-Cconfig/servercmdline.txt</span>
will read arguments from that file. Only one argument per line is allowed in the file.
Empty lines, and any text after '//' in the file gets ignored.
The file is only read once at server startup, so changing the file's content will not affect a
running server; you would need to restart it.
<br>See ./config/servercmdline.txt for additional info.
</td>
</tr>
<td class="c3" id="server-X">-X<b>f</b></td>
<td>
Changes the location of the administrator password file.
<br>The default is: <span class="code">-Xconfig/serverpwd.cfg</span>
</td>
</tr>
<tr>
<td class="c1" id="server-r">-r<b>f</b></td>
<td class="c2">
Changes the location of the <a href="server.html#maprotation">map rotation</a> file.
<br>The default is: <span class="code">-rconfig/maprot.cfg</span>
</td>
</tr>
<tr>
<td class="c3" id="server-B">-B<b>f</b></td>
<td>
Changes the location of the IP blacklist file.
<br>The default is: <span class="code">-Bconfig/serverblacklist.cfg</span>
</td>
</tr>
<tr>
<td class="c1" id="server-K">-K<b>f</b></td>
<td class="c2">
Changes the location of the nickname blacklist file.
<br>The default is: <span class="code">-Kconfig/nicknameblacklist.cfg</span>
</td>
</tr>
<tr>
<td class="c3" id="server-g">-g<b>f</b></td>
<td>
Changes the location of the forbidden words file.
<br>The default is: <span class="code">-gconfig/forbidden.cfg</span>
</td>
</tr>
<tr>
<td class="c1" id="server-E">-E<b>f</b></td>
<td class="c2">
Changes the location of the kill messages file.
<br>The default is: <span class="code">-gconfig/serverkillmessages.cfg</span>
</td>
</tr>
<tr>
<td class="c3" id="server-I">-I<b>f</b></td>
<td>
Changes the location of the "serverinfo text" filename prefix.
The server automatically adds "_en.txt" as a suffix to complete the filename.
<br>The default is: <span class="code">-Iconfig/serverinfo</span>
</td>
</tr>
<tr>
<td class="c1" id="server-O">-O<b>f</b></td>
<td class="c2">
Changes the location of the MOTD (message of the day) filename prefix.
The server automatically adds "_en.txt" as a suffix to complete the filename.
<br>The default is: <span class="code">-Oconfig/motd</span>
<br>The MOTD will only be read from a file if the <a href="#server-o" class="code">-o</a>
argument hasn't been specified.
</td>
</tr>
<tr>
<td class="verttxt" rowspan="2">
M<br>I<br>S<br>C
</td>
<td class="c3" id="server-SW">-SW<b>r</b></td>
<td>
Starts the server as Microsoft Windows service and sets the name of the windows service
that should be used to <span class="code">r</span>.
This will only work if the server is started directly from the windows service manager.
</td>
</tr>
<tr>
<td class="c1" id="server-u">-u<b>N</b></td>
<td class="c2">
Sets the up-stream bandwidth (per player) to <span class="code">N</span> bytes per second.
Only set this argument if you know what you're doing, as specifying a incorrect value is
worse than not specifying it.
</td>
</tr>
</table>
</div>
<div id="author">
<a href="license.html">© Copyright, Rabid Viper Productions</a>
</div>
<div id="donatedocs">
<a href="http://sourceforge.net/p/actiongame/donate/">
We would be grateful for any donations considered towards AssaultCube
</a>
</div>
<!--#include virtual="/SSI-HTML/adsense_footer.html" -->
</div>
</body>
</html>
