Server Administration

This page covers how to set up and run a dedicated Quetoo server.

Running a Dedicated Server

Quetoo ships with a quetoo-dedicated binary for headless server operation. Launch it from the command line:

quetoo-dedicated +set sv_hostname "My Server" +map edge

You can pass any cvar as a +set key value argument at startup, and any command (like map) with +command.

Minimal Startup Example

quetoo-dedicated \
  +set sv_hostname "Fragfest" \
  +set sv_max_clients 16 \
  +set sv_public 1 \
  +set g_frag_limit 30 \
  +set g_time_limit 20 \
  +map edge

Key Server Cvars

Network

Cvar	Default	Description
`net_port`	`1998`	UDP port the server listens on
`sv_hostname`	`Quetoo`	Server name shown in the browser
`sv_public`	`0`	Set to `1` to advertise on the master server

Capacity

Cvar	Default	Description
`sv_max_clients`	`64`	Maximum simultaneous players
`sv_max_entities`	(engine max)	Maximum entities; rarely needs changing
`sv_timeout`	`20`	Client connection timeout in seconds

Security

Cvar	Default	Description
`rcon_password`	(empty)	Password for remote console access (`rcon`). Set this to allow trusted admins to run server commands remotely.
`g_admin_password`	(empty)	In-game admin password (set with `admin <password>`)

Game Rules

Cvar	Default	Description
`g_frag_limit`	`30`	Frags needed to win the level
`g_time_limit`	`20`	Minutes per level
`g_capture_limit`	`8`	Flag captures to win (CTF)
`g_teams`	`0`	Set to `1` to enable Team Deathmatch
`g_ctf`	`0`	Set to `1` to enable Capture the Flag
`g_gameplay`	`default`	Game variant: `default`, `instagib`, or `arena`
`g_num_teams`	`default`	Number of teams (auto-detected by default)
`g_auto_join`	`0`	Automatically assign players to teams
`g_weapon_stay`	`0`	Weapons stay after pickup instead of respawning
`g_respawn_protection`	`0`	Spawn protection duration in seconds
`g_spawn_farthest`	`0`	Spawn players as far as possible from enemies
`g_ammo_respawn_time`	`20.0`	Ammo respawn interval in seconds
`g_weapon_respawn_time`	`5`	Weapon respawn interval in seconds

Map Rotation

Map rotation is controlled by the g_map_list cvar, which points to a map list file. By default the server reads maps.lst from the game data directory.

maps.lst Format

// maps.lst — one map per entry, with optional settings
{
    map "edge"
    message "Back to Edge!"
}
{
    map "aerowalk"
}
{
    map "bsp2"
    g_ctf "1"
    g_time_limit "30"
}

Override with a custom file:

+set g_map_list "cfg/myserver_maps.lst"

Maps rotate automatically when the frag limit or time limit is reached. You can also change the map manually from the console:

map edge

Remote Console (rcon)

If rcon_password is set, admins can run commands remotely from a Quetoo client:

rcon_password mypassword
rcon map edge
rcon status

Firewall / Port Forwarding

Quetoo uses UDP port 1998 by default. Open this port in your firewall and forward it on your router if hosting from a home network.

To list your server on the public master server, set:

+set sv_public 1

Demo Recording

The server can record demos of matches. Set sv_demo_list to a space-separated list of demo filenames to record automatically.

Getting Help

Join the Discord #server-admin channel for help running a server.

Auto-Updates

Quetoo checks for updates on launch and downloads them automatically. To disable update checks and version enforcement — for example, when pinning a server to a specific build — add +set version -1 to the command line:

quetoo-dedicated +set version -1 +map edge