Provided by: assaultcube-data_1.1.0.4+repack1-2_all bug

NAME

       assaultcube-server - AssaultCube server

SYNOPSIS

       assaultcube-server  [  -cN  ]  [  -nS  ]  [  -n1S ] [ -n2S ] [ -oN ] [ -iIP ] [ -fPORT ] [
       -pPASSWD ] [ -mURL ] [ -xPASSWD ] [ -PfkbMASRCDEPw ] [ -V ] [ -T ] [ -lN ] [ -NID ] [  -Fn
       ]  [  -LFn ] [ -LSn ] [ -kN ] [ -yN ] [ -kAN ] [ -kBN ] [ -Amapname ] [ -Mcurd ] [ -Zi ] [
       -Dn ] [  -DI  ]  [  -Wf  ]  [  --demofilenameformat=s  ]  [  --demotimestampformat=s  ]  [
       --demotimelocal=s  ] [ -Cf ] [ -Xf ] [ -rf ] [ -Bf ] [ -Kf ] [ -gf ] [ -Ef ] [ -If ] [ -Of
       ] [ -SWr ] [ -uN ] [ --wizard outfile relbinarypath ] [ --help ]

DESCRIPTION

       AssaultCube, formerly ActionCube, is a first-person-shooter based on the game Cube. Set in
       a  realistic  looking  environment,  as  far  as  that's  possible with this engine, while
       gameplay stays fast and arcade. This game is all about team oriented multiplayer fun.

       assaultcube-server  is  a  script  which  executes   /usr/lib/games/ac_server   from   the
       /usr/share/games/assaultcube/ directory. It will accept any additional options

OPTIONS

       -cN    Sets the maximum number of players that can play on the server to N (default 6). If
              extra players try to connect they will receive a "server full" error message.

       -nS    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"

       -n1S   Sets  a  prefix for the server description that remains when the server description
              is changed using the /serverdesc  command. A prefix AND/OR suffix MUST be specified
              for the /serverdesc command to work.

       -n2S   Sets  a  suffix for the server description that remains when the server description
              is changed using the /serverdesc  command. A suffix AND/OR prefix MUST be specified
              for the /serverdesc command to work.

       -oN    Sets  the  servers  MOTD (message of the day), which appears on the clients console
              after they connect to the server.

       -iIP   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.

       -fPORT 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: -f9000 would run a server on ports 9000 and 9001.

       -pPASSWD
              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
              connect command.

       -mURL  Forces  the server to register with the URL of a different masterserver. When using
              this argument, you need  to  exclude  the  protocol  at  the  beginning  (i.e.  add
              everything BUT http:// on to the argument).  The default is -massault.cubers.net If
              you want your server  to  be  hidden  and  not  report  to  the  masterserver,  use
              -mlocalhost

       -xPASSWD
              Sets  the  administrator  password to PASSWD. 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".

              Once  logged  in  with  the administrator password (by using /setadmin 1 YOURPASS),
              further administrator options are presented to you when opening the menu  (however,
              not all, check the CubeScript command reference for other options).

       -PfkbMASRCDEPw
              Sets  whether the role required to call a specific vote belongs to a "player" or an
              "administrator". The characters fkbMASRCDEPw are used to set these requirements.  A
              lower-case  character  enables normal players to call that vote, where-as an upper-
              case character will only allow an administrator to call the vote.  If  a  character
              doesn't appear, then the defaults for that setting will be used.

                  Default   Description
              f   Lower     Force a player to the enemy team.
              k   Lower     Kick a player.
              b   Lower     Ban a player (and remove bans).
              M   Upper     Change mastermode (open/private/match).
              A   Upper     Enable/disable autoteam.
              S   Upper     Shuffle the teams.
              R   Upper     Record  a  demo of the next game (if autorecording
                            is disabled).
              C   Upper     Clear all demos on the server.
              D   Upper     Change server description.
              E   Upper     Can vote for co-op edit mode.
              P   Upper     Can vote for a gamemode that  isn't  supported  by
                            the map.
              w   Lower     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.

              For example: -PbmA enables ban & mastermode to be voted by normal players, but only
              an administrator can change autoteam.  The '-P' argument can be used several times,
              for example: '-Pb -Pm -PA' is the same as '-PbmA'.

       -V     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  everything  in
              your  serverpwd.cfg  file.   -T Tags a timestamp to each line of text output to the
              console/log files.

       -lN    Enables or disables game status logging in server logs (enabled by default)

       -NID   Sets the log identity to ID . By default, the log identity is 'IP[port]'.  On Linux
              systems,  the  log  identity is used for the syslog to identify server log entries.
              On Windows and Apple systems, the log identity is used to  create  the  server  log
              filename.

       -Fn    Sets  the  syslog facility to n. 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.

       -LFn   Sets the level of logging to n for logging to file. On Linux systems, this argument
              enables ADDITIONAL logging, as Linux systems already log to syslog.  The  following
              levels can be selected:

              0   DEBUG     Logs all messages.
              1   VERBOSE   Logs all messages of level VERBOSE and above. This
                            is the same as using the -V argument.
              2   INFO      Logs all messages of level INFO and above. This is
                            the default on Windows/Mac.
              3   WARNING   Log only messages of level WARNING and above.
              4   ERROR     Log only messages of level ERROR.
              5   NONE      Don't  log  to  file. This is the default on Linux
                            systems.

       -LSn   Sets the level of logging to n for logging to syslog. This argument is  ignored  on
              non-Linux systems. The following levels can be selected:

              0   DEBUG     Logs all messages.
              1   VERBOSE   Logs all messages of level VERBOSE and above. This
                            is the same as using the -V argument.
              2   INFO      Logs all messages of level INFO and above. This is
                            the default for Linux.
              3   WARNING   Log only messages of level WARNING and above.
              4   ERROR     Log only messages of level ERROR.
              5   NONE      Don't   log  to  file.  This  is  the  default  on
                            Windows/Mac systems.

       -kN    Sets the kick threshold to N. If a players score drops below it, he will be  kicked
              automatically. The default is -5, all negative values DO require a minus sign.

       -yN    Sets  the  ban threshold to N. If a players score drops below it, he will be banned
              automatically. The default is -6, all negative values DO require a minus sign.

       -kAN   Sets the threshold (in seconds) for the "AFK" auto-kick  to  N.  The  server  won't
              auto-kick if:

                  * The servers mastermode is PRIVATE or MATCH.
                  * If there are 4 or less players.
                  * If the mode isn't team-based AND the server isn't full.

              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.

       -kBN   Sets  the amount of minutes a banned player will remain banned from the server to N
              The default is 20 minutes.

       -Amapname
                    Restricts voting for a particular map (or mode for that map, if specified) to
              administrators.  To  only  restrict  a  particular mode on the map, but not the map
              itself, add the mode number to the end of it, separated by a '#'. This argument can
              be used several times.

              Example: -Aac_desert#13 would restrict mode 13 on ac_desert.

       -Mcurd Sets   whether   the  role  required  to  sendmap  belongs  to  a  "player"  or  an
              "administrator". The characters curd are used to set these requirements.  A  lower-
              case  character enables normal players to do the listed sendmap action, where-as 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.

              c   Upper   Upload new maps to the server.
              u   Upper   Update existing maps (with the same,  or  a  newer
                          revision).
              r   Upper   Revert existing maps (to an older revision).
              d   Upper   Delete a map from the server.

       -Zi    Sets the size limit (in megabytes) for maps being uploaded to the "incoming" folder
              to i. Any map being uploaded exceeding this limit, will be rejected. The default is
              10 megabytes.

       -Dn    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  n.
              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.

       -DI    Limit  downloading  of  demos  until  the  intermission  (this  will  increase  the
              intermission time if someone is downloading a demo).

       -Wf    Sets the path (and optionally, the filename prefix) to write recorded demos to from
              RAM. As an example: -Wserverdemos/mydemo would save  all  demos  to  the  directory
              "serverdemos",  with  a  prefix  in the filenames of "mydemo".  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.  The
              server owner has to take precautions that demo files don't fill up the file system,
              as demos can become quite large (sometimes up to 2 megabytes).

       --demofilenameformat=s
              Changes  the  format  used  for saving demos (if the -W argument is used) to s. See
              demonameformat for options.

       --demotimestampformat=s
              Changes the timestamp format used for saving demos (if the -W argument is used)  to
              s. See demotimeformat for options.

       --demotimelocal=s
              Changes  whether timestamps are converted to localtime (if s is set to 1) or to use
              UTC (if s is set to 0 - this is the default) when saving demos (if the -W  argument
              is used). See demotimelocal.

       -Cf    Reads  commandline  arguments  from  a  file  (no  files  are read by default). For
              example, -Cconfig/servercmdline.txt  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  files  content will not affect a running server, you would need to restart it.
              See ./config/servercmdline.txt for additional info.

       -Xf    Changes  the  location  of  the  administrator  password  file.   The  default  is:
              -Xconfig/serverpwd.cfg

       -rf    Changes the location of the map rotation file.  The default is: -rconfig/maprot.cfg

       -Bf    Changes   the   location   of   the   IP   blacklist   file.    The   default   is:
              -Bconfig/serverblacklist.cfg

       -Kf    Changes  the  location  of  the  nickname  blacklist   file.    The   default   is:
              -Kconfig/nicknameblacklist.cfg

       -gf    Changes   the   location   of   the   forbidden   words   file.   The  default  is:
              -gconfig/forbidden.cfg

       -Ef    Changes  the   location   of   the   kill   messages   file.    The   default   is:
              -gconfig/serverkillmessages.cfg

       -If    Changes  the  location  of  the  "serverinfo  text"  filename  prefix.  The  server
              automatically adds "_en.txt" as a suffix to complete the filename.  The default is:
              -Iconfig/serverinfo

       -Of    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.  The default is:
              -Oconfig/motd The MOTD will only be read from a file if the -o argument hasn't been
              specified.

       -SWr   Starts the server as Microsoft Windows service and sets the  name  of  the  windows
              service  that  should  be  used  to r. This will only work if the server is started
              directly from the windows service manager.

       -uN    Sets the up-stream bandwidth (per player) to N 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.

       --wizard outfile relbinarypath
              Starts the server setup wizard and saves the chosen settings to outfile in the form
              of  a  bash  script,  executing the file given by relbinarypath with the additional
              options specified.

              Example:
       assaultcube --wizard $HOME/myserver.sh $(which assaultcube-server)

              $(which assaultcube-server) simply expands to the  assaultcube  launcher  path  and
              would be equivalent to using e.g: /usr/games/assaultcube-server

       --help Display this manpage.

SEE ALSO

       assaultcube(6)

AUTHOR

       AssaultCube was written by the AssaultCube Team.

       This manual page was written by Martin Erik Werner <martinerikwerner@gmail.com>
       Information about options taken from:
       <http://assault.cubers.net/docs/commandline.html>

                                           May  7, 2011                            ASSAULTCUBE(6)