Clarify autobuild-bsp time estimate message
[xonotic/xonotic.git] / server / server.cfg
1 // This is an example config, to actually use it, copy it to ~/.xonotic/data on linux
2 // or the equivalent directory on your OS (https://xonotic.org/faq/#config).
3
4 // Two slashes start a comment until the end of the line.
5 // Surround settings with double quotes (e.g. cvar_name "some value") unless they're a single number or word.
6 // Cvar means console variable.
7 // Just "" means empty string.
8 // Semicolon separates commands (in console or in aliases).
9
10 // Search for settings and descriptions using the 'search' command in console
11 // or online: https://xonotic.org/tools/cacs/
12
13
14
15
16 /////////////////////////////////////////////////////////////////////
17 // Things you SHOULD change to make the server "yours" (remove the // and change the value):
18
19 //sv_public 1   // 0 or -1 (see description) if the server should not be on the public servers list
20 //hostname "Xonotic $g_xonoticversion Server"   // this name will appear on the server list (the $g_xonoticversion gets replaced with the current version)
21 //sv_motd ""    // displayed on connect - good place for contact info (IRC, forum nick, etc.) so players can reach you when something is wrong with your server
22 //sv_termsofservice_url "https://yourdomain.tld/path/to/tos"    // URL for the Terms of Service for playing on your server
23 // It is RECOMMENDED to supply such a document containing information about if and how you collect and process user data (bridging to IRC, player stats etc),
24 // contact information, rules and similar information.
25 // This document will be shown in the server join dialog.
26
27 // This sets the remote console password on the server, you also need to set the cvar to the same value on your client to use the 'rcon' command.
28 // Empty means rcon is disabled.
29 //rcon_password ""
30
31
32 /////////////////////////////////////////////////////////////////////
33 // Everything below has some sensible defaults so you don't really need to change anything.
34 // It's meant as examples for people who want to customize the server more.
35 // The values shown are either defaults or examples (for up to date defaults, see 'search' (or 'apropos') in console.
36
37 //maxplayers 8  // number of player slots on the server (including spectators)
38
39 //net_address 0.0.0.0   // ONLY change this if you have problems with your server. Specifies the network interface used by the engine.  Set it to one of your internal IPs
40
41 //port 26000    // the port used by the server
42 // You are RECOMMENDED to change this value to a free port number on your server
43 // above 1024. The reason is that some bad ISPs might filter "gaming" ports, and
44 // changing the port your server runs on may make your server available to these
45 // people. Changing the port breaks nothing, the default simply matches Quake as
46 // we use a Quake-derived protocol and didn't do our own IANA port assignment yet
47 // (if anyone wants to go through that process, we'd be glad).
48
49 //log_file "server.log" // server console output will also be copied to this file. This: "${serverconfig}.log" uses variable substitution to make the logfile have the same name as your config file with .log appended which is useful if you run several servers
50 //g_start_delay 15      // delay before the game starts to let players join the server first
51
52 // List of maps to play on the server.  Set to "" to autodetect (which would enumerate ALL maps.  Maps that don't support the current game mode will be skipped, so you don't need to remove them here.
53 //g_maplist "afterslime atelier boil catharsis courtfun dance drain erbium finalrage fuse geoplanetary glowplant implosion leave_em_behind nexballarena oilrig runningman runningmanctf silentsiege solarium space-elevator stormkeep techassault vorix warfare xoylent"
54 //g_maplist_shuffle 1   // 0 always selects the next map out of g_maplist (but then better set g_maplist_votable 0 below to prevent repetitive votes), 1 will select random maps each time
55 //g_maplist_mostrecent_count 3  // number of maps that have to be played before a map can be repeated
56
57 // LIMITS: how long a match will last before the next map starts (-1 means use the map default, 0 = unlimited, please note that the variables fraglimit/timelimit can NOT be globally used for this but only DURING a match is being played)
58 //timelimit_override -1 // global timelimit for all maps and gametypes
59 //fraglimit_override -1 // global frag/point limit for all maps and gametypes
60 //capturelimit_override -1      // capture limit for CTF
61 //g_domination_point_limit -1   // frag/point limit for DOM
62 //g_keyhunt_point_limit -1      // frag/point limit for KH
63 //g_lms_lives_override -1       // lives for LMS
64 //g_nexball_goallimit -1        // goals for NEXBALL
65
66 //g_ctf_ignore_frags 0  // set to 1 to ignore kills except for FC kills
67
68 // TEAMS for key hunt (change this to 2, 3, 4 to set a fixed keyhunt style)
69 //g_keyhunt_teams_override -1   // teams for KH
70
71 // GAME MODE: what type of server do you want to host?
72 // possible values: dm (deathmatch), tdm (team deathmatch), ctf (capture the flag), ca (clan arena), ft (freeze tag), kh (keyhunt), as (assault), dom (domination), lms (last man standing), ka (keepaway), inv (invasion), ons (onslaught), rc (race), cts (complete the stage), nb (nexball)
73 //gametype dm   // default gamemode
74
75 // TIPS: uncomment this if you want help messages on your server - one per match 20 seconds after the map loads
76 //alias sv_hook_gamestart_all "defer 20 help_next"
77
78
79
80 /////////////////////////////////////////////////////////////////////
81 // Some settings you MIGHT want to change.  Again IF so remove the //
82 // from the line start and change them to your liking.
83
84 //skill 8       // the bots skill level
85
86 // if changing either of these two minplayers settigs, you should consider editing the `bots` alias so that the `bots` vote adds the right number of bots
87 //minplayers 0  // add bots if less then that number of players playing
88 //minplayers_per_team 0 // add bots to each team if less than that number of players playing
89 //alias bots "minplayers 4; minplayers_per_team 2"
90
91 //g_maxplayers 0 // above this player count, only allow spectators
92 //bot_prefix [BOT]      // prepend this to all botnames
93 //bot_suffix "" // append this to all botnames
94 //g_maplist_check_waypoints 0   // set this to 1 to skip maps without waypoints if there aren't enough players to play without bots
95
96 //g_maplist_votable 6   // number of maps to vote between.  set to 0 to disable the map voting screen (please enable g_maplist_shuffle above when this is enabled, or votes will be repetitive)
97 //g_maplist_votable_suggestions 2       // number of suggestions to accept using the suggestmap command
98 //g_maplist_votable_abstain 0   // when 1, people get a "don't care" selection in the vote screen
99 //g_maplist_votable_nodetail 1  // when 1, people can't see how many voted for what (to thwart abusive "influential" first votes)
100
101 sv_vote_gametype 1      // set to 1 to enable voting for gametypes after every match
102 //sv_vote_gametype_options "dm kh dom tdm mycustom"     // the gametypes to vote for, custom gametypes are supported (max 9 chars for the gametype identifier because sv_vote_gametype_hook_* can have max 31 chars)
103 //set sv_vote_gametype_mycustom_name "My Custom Mode"   // Name displayed for the custom gametype "mycustom" (replace "mycustom" with the name you set in sv_vote_gametype_options)
104 //set sv_vote_gametype_mycustom_type "ft"       // the basetype that the custom gametype is derived from
105 //set sv_vote_gametype_mycustom_description "This is my custom gametype"        // the description for the custom gametype
106 // Custom icons for custom gametypes are supported and have to be located in a server pk3 as gfx/menu/default/gametype_mycustom
107
108 //sv_vote_commands "restart fraglimit gotomap nextmap endmatch reducematchtime extendmatchtime allready kick cointoss movetoauto shuffleteams bots nobots"      // players can vote for those commands or use them if they are masters. You can also add 'g_grappling_hook' for hook voting, and 'sv_fbskin_green sv_fbskin_red sv_fbskin_orange sv_fbskin_off' for fbskin voting.
109 //sv_vote_master_commands "movetored movetoblue movetoyellow movetopink"        // add commands masters can use if logged in or elected. You may want to put 'kickban' here, so masters can keep out punks. It may be good to also put "sv_status_privacy 0" then...
110 //rcon_restricted_commands "restart fraglimit chmap gotomap endmatch reducematchtime extendmatchtime allready kick kickban \"sv_cmd bans\" \"sv_cmd unban\" status \"sv_cmd teamstatus\" movetoauto movetored movetoblue movetoyellow movetopink"       // commands for the (stronger) rcon restricted
111 //rcon_restricted_password ""   // put here the password for a "restricted" rcon user (see below)
112
113 //sv_vote_call 1        // 0 will disable the normal voting
114 //sv_vote_master 1      // 0 will disable voting to become master, good if you prefer to use the master password instead
115 //sv_vote_master_password ""    // when set, vlogin PWD will allow people to become master to run master commands directly using vdo
116 //sv_vote_majority_factor 0.5   // What percentage of the PLAYERS constitute a majority to win a vote? must be at least 0.5
117 //sv_vote_majority_factor_of_voted 0    // What percentage of the VOTERS who already voted constitute a majority to win a vote? must be at least 0.5
118 // note: to JUST support simple majorities, set these two factors equal
119
120 //sv_maxidle 0  // idle time in seconds after which players will get kicked
121
122 //sv_taunt 1    // 0 to disallow taunts
123 //sv_autotaunt 1        // 0 to disallow autotaunts
124
125
126
127
128 /////////////////////////////////////////////////////////////////////
129 // Settings you MIGHT want to change for PRIVACY reasons.
130
131 //sv_status_privacy 1   // 1 hides IP addresses from "status" replies shown to clients, 0 shows them. Enables players to identify wellknown punks on your server OR is a threat to anonymity.. depending on your point of view :)
132
133 // This line sends the following data to our servers:
134 // - Date and time
135 // - Your server IP address
136 // - Your server ID hash, which is a fingerprint of the public key of your
137 //   server and does not impact security of your private key (use "crypto_keys"
138 //   on the console to show it)
139 // - Your server name ("hostname")
140 // - Current game type
141 // - Current map
142 // - Balance settings you have modified from defaults (only those that make
143 //   your server "impure")
144 // - For each weapon pairing (A, B), separately for player-player, player-bot,
145 //   bot-player, bot-bot pairings:
146 //   - Number of hits of players/bots holding A against players/bots holding B
147 //   - Number of frags of players/bots holding A against players/bots holding B
148 //   - Total damage of players/bots holding A against players/bots holding B
149 //
150 // We use this data to:
151 // - Optimize the game balance for future releases
152 // - Identify problems in the bot AI and improving it
153 // - Find settings that make servers "impure" that should not, so we can
154 //   whitelist them in future releases
155 //
156 // We will or might publish:
157 // - Global weapon pairing statistics for players vs players, or bots vs bots,
158 //   or any vs any, on a selection of servers
159 // - Per-gametype and per-map weapon pairing statistics players vs players, or
160 //   bots vs bots, or any vs any, on a selection of servers
161 // - Lists of commonly changed cvars, together with counts on how often they
162 //   are modified
163 //
164 // No information about the players on the server is sent, so as a server admin
165 // you need no permission of your players for this.
166 //
167 // No information about your server will be published - all published data sets
168 // will include data from multiple servers.
169 //
170 sv_weaponstats_file "http://www.xonotic.org/weaponbalance/"
171
172
173
174
175 /////////////////////////////////////////////////////////////////////
176 // Some more advanced settings.  You probably are not interested in changing them at all.
177
178 //sv_ready_restart_after_countdown 0    // if set to 1 the players and map items are reset after the countdown ended, otherwise they're reset already at the beginning of the countdown
179 //sv_autoscreenshot 0   // 1 will force a screenshot for all clients when the map ends.  Useful for competitions or the ladder.
180
181 //g_antilag 2   // 0 to disable the antilag feature, 1 and 2 use different methods
182
183 //sv_maxrate 1000000    // limits client connections to this rate in bytes/seconds
184
185 //sys_ticrate 0.0333333 // 0.0166667 for twice as many server frames per second; smoother gameplay but somewhat higher CPU use.
186
187 // see Docs/mapdownload.txt for more info
188 //sv_curl_defaulturl http://www.xonotic.org/contentdownload/getmap.php?file=    //fallback download URL
189
190 //sv_defaultcharacter 0 // 1 will force a specific model for all players
191 //sv_defaultplayermodel models/player/erebus.iqm        // this model will be used
192 //sv_defaultplayerskin 0        // this skin number will be forced for all players
193 //sv_defaultplayercolors ""     // you can even force player colors here (16*shirt+pants)
194 //g_fullbrightplayers 0 // 1 to make players fullbright
195 //g_fullbrightitems 0   // 1 to make items fullbright
196
197 //g_balance_teams 1     // 0 will show players the team selection menu after joining instead of automaticly putting them on the smaller team
198 //g_balance_teams_prevent_imbalance 1   // 0 to prevent switchint to a bigger/begger team
199
200 //g_ban_sync_uri "http://46.38.241.138/~xonotic/bans/" // sync bans using this ban list provider (disabled by default, uncomment this line to enable)
201 //g_ban_sync_trusted_servers "" // accept bans that were initially set on the server IPs listed here (if not set, your bans are just sent to the sync URIs, but no bans are retrieved from there)
202
203 //g_spawnshieldtime 1   // time for which players are protected after spawn
204
205
206
207
208 /////////////////////////////////////////////////////////////////////
209 // "Obvious" mutators that are allowed on a "pure" server
210 //g_instagib 0  // set to 1 for InstaGib
211 //g_weapon_stay 0 // set to 1, 2 or 3 for different weapon-stay modes (1 = traditional, 2 = no ammo but allow throwing, 3 = ghost weapon stay)
212 //g_powerups -1 // set to 0 to turn off strength/quad and shield/invincible, and set to 1 to turn them on even in game modes that normally have them turned off
213
214
215
216
217 /////////////////////////////////////////////////////////////////////
218 // Overkill mod settings
219
220 // To enable Overkill, put 'exec ruleset-overkill.cfg' at the top of this file (above any other cvar changes), don't use 'g_overkill 1' directly.
221
222
223
224
225 /////////////////////////////////////////////////////////////////////
226 // WARNING: anything below this line makes your server "impure"!
227
228 // enable some mutators you'd like
229 //g_cloaked 0   // set to 1 for transparent hard to see players
230 //g_grappling_hook 0    // set to 1 to enable the hook (allowed on "pure" server in InstaGib)
231 //g_jetpack 0   // set to 1 to enable the jetpack (allowed on "pure" server in InstaGib)
232 //g_midair 0    // set to 1 to make only midair damage count
233 //g_vampire 0   // set to 1 to give players the damage they cause as health
234 //sv_gravity 800        // for low gravity, set this somewhere between 50 and 400
235
236 // select AT MOST one of these arena mutators (if you didn't select g_instagib)
237 //g_nix is "0" ["0"] No Items Xonotic - instead of pickup items, everyone plays with the same weapon. After some time, a countdown will start, after which everyone will switch to another weapon, and so on
238 //g_nix_with_healtharmor is "0" ["0"] when 1, health and armor still show up in NIX
239 //g_nix_with_blaster is "0" ["0"] always carry the blaster as an additional weapon in NIX
240 //g_nix_with_powerups is "0" ["0"] when 1, powerups still show up in NIX