]> git.xonotic.org Git - xonotic/xonotic.git/blobdiff - server/server.cfg
Restore yet another weird path in SDL lib configs
[xonotic/xonotic.git] / server / server.cfg
index 1d26ee66b4efce15795b509bbd5b43dd785aa736..b7185fe549caacde38344a39389ce5350fb94d36 100644 (file)
@@ -1,11 +1,14 @@
+// This is an example config, to actually use it, copy it to ~/.xonotic/data on linux
+// or the equivalent directory on your OS (https://xonotic.org/faq/#config).
+
 // Two slashes start a comment until the end of the line.
 // Surround settings with double quotes (e.g. cvar_name "some value") unless they're a single number or word.
 // Cvar means console variable.
 // Just "" means empty string.
 // Semicolon separates commands (in console or in aliases).
 
-// Search for settings and descriptions using the `search` command in console
-// or online: http://www.xonotic.org/tools/cacs/
+// Search for settings and descriptions using the 'search' command in console
+// or online: https://xonotic.org/tools/cacs/
 
 
 
 //hostname "Xonotic $g_xonoticversion Server"  // this name will appear on the server list (the $g_xonoticversion gets replaced with the current version)
 //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
 
-
+// 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.
+// Empty means rcon is disabled.
+//rcon_password ""
 
 
 /////////////////////////////////////////////////////////////////////
 // Everything below has some sensible defaults so you don't really need to change anything.
+// It's meant as examples for people who want to customize the server more.
+// The values shown are either defaults or examples (for up to date defaults, see 'search' (or 'apropos') in console.
 
 //maxplayers 8 // number of player slots on the server (including spectators)
 
-//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 you one of you internal IPs
-
-//rcon_password ""     // you can use rcon if this password is set.  you need to set the same password in your client if you want to issue rcon commands
-//rcon_restricted_password ""  // put here the password for a "restricted" rcon user (see below)
+//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
 
 //port 26000   // the port used by the server
 // You are RECOMMENDED to change this value to a free port number on your server
@@ -64,6 +68,8 @@
 // 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)
 //gametype dm  // default gamemode
 
+// TIPS: uncomment this if you want help messages on your server - one per match 20 seconds after the map loads
+//alias sv_hook_gamestart_all "defer 20 help_next"
 
 
 
@@ -71,8 +77,9 @@
 // Some settings you MIGHT want to change.  Again IF so remove the //
 // from the line start and change them to your liking.
 
-//skill 8      // the bots skill level
+//skill 4      // the bots skill level
 //minplayers 0 // add bots if less then that number of players playing
+//minplayers_per_team 0 // add bots to each team if less than that number of players playing
 //g_maxplayers 0 // above this player count, only allow spectators
 //bot_prefix [BOT]     // prepend this to all botnames
 //bot_suffix ""        // append this to all botnames
 //g_maplist_votable_abstain 0  // when 1, people get a "don't care" selection in the vote screen
 //g_maplist_votable_nodetail 1 // when 1, people can't see how many voted for what (to thwart abusive "influential" first votes)
 
-//sv_vote_gametype 1           // set to 1 to enable voting for gametypes after every match
-//sv_vote_gametype_options "dm kh dom jb mygametype"   // the gametypes to vote for, custom gametypes are supported
-//sv_vote_gametype_mygametype_name "My Mode"   // Name displayed for the custom gametype "mygametype" (replace "mygametype" with the name you set in sv_vote_gametype_options)
-//sv_vote_gametype_mygametype_type "ft"        // the basetype that the custom gametype is derived from
-//sv_vote_gametype_mygametype_description "This is my custom gametype" // the description for the custom gametype
-// Custom icons for custom gametypes are supported and have to be located in a server pk3 as gfx/menu/default/gametype_mygametype
+sv_vote_gametype 1     // set to 1 to enable voting for gametypes after every match
+//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)
+//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)
+//set sv_vote_gametype_mycustom_type "ft"      // the basetype that the custom gametype is derived from
+//set sv_vote_gametype_mycustom_description "This is my custom gametype"       // the description for the custom gametype
+// Custom icons for custom gametypes are supported and have to be located in a server pk3 as gfx/menu/default/gametype_mycustom
 
 //sv_vote_commands "restart fraglimit chmap gotomap nextmap endmatch reducematchtime extendmatchtime allready kick cointoss movetoauto shuffleteams"   // players can vote for those commands or use them if they are masters. You canm also add 'g_grappling_hook' for hook voting, and 'sv_fbskin_green sv_fbskin_red sv_fbskin_orange sv_fbskin_off' for fbskin voting.
 //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...
 //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
+//rcon_restricted_password ""  // put here the password for a "restricted" rcon user (see below)
 
 //sv_vote_call 1       // 0 will disable the normal voting
 //sv_vote_master 1     // 0 will disable voting to become master, good if you prefer to use the master password instead
 // No information about your server will be published - all published data sets
 // will include data from multiple servers.
 //
-sv_weaponstats_file http://www.xonotic.org/weaponbalance/
+sv_weaponstats_file "http://www.xonotic.org/weaponbalance/"
 
 
 
@@ -169,7 +177,7 @@ sv_weaponstats_file http://www.xonotic.org/weaponbalance/
 //sv_maxrate 1000000   // limits client connections to this rate in bytes/seconds
 
 // see Docs/mapdownload.txt for more info
-//sv_curl_defaulturl http://www.xonotic.com/contentdownload/getmap.php?file=   //fallback download URL
+//sv_curl_defaulturl http://www.xonotic.org/contentdownload/getmap.php?file=   //fallback download URL
 
 //sv_defaultcharacter 0        // 1 will force a specific model for all players
 //sv_defaultplayermodel models/player/erebus.iqm       // this model will be used
@@ -201,8 +209,7 @@ sv_weaponstats_file http://www.xonotic.org/weaponbalance/
 /////////////////////////////////////////////////////////////////////
 // Overkill mod settings
 
-// To enable Overkill, put 'exec defaultOverkill.cfg' at the top of this file (above any other cvar changes), don't use 'g_overkill 1' directly.
-// You should also consider enabling 'g_fullbrightplayers 1'.
+// 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.