Server Configuration

Complete reference for the CoD2 server.cfg file.

Config File Location

main/server.cfg

Edit this file via SFTP. Changes take effect after a server restart.

TIP

If you're running a mod, the mod can have its own server.cfg at mods/<modname>/server.cfg. Settings in the mod config override the main config.

Example Configuration

// ============================================================
// Server Identity
// ============================================================
set sv_hostname "My uHost CoD2 Server"
set sv_maxclients "24"
set sv_privateClients "0"

// ============================================================
// Passwords
// ============================================================
set rcon_password "changeme123"
set g_password ""
set sv_privatePassword ""

// ============================================================
// Network
// ============================================================
set sv_maxRate "25000"
set sv_floodProtect "1"
set sv_pure "1"

// ============================================================
// Downloads
// ============================================================
set sv_allowDownload "1"
// FastDL is auto-configured on uHost. No need to set
// sv_wwwDownload or sv_wwwBaseURL manually.

// ============================================================
// Gameplay
// ============================================================
set g_gametype "tdm"
set scr_teambalance "1"
set scr_friendlyfire "0"
set g_allowvote "1"
set g_antilag "1"
set sv_voice "1"

// ============================================================
// Team Deathmatch Settings
// ============================================================
set scr_tdm_timelimit "20"
set scr_tdm_scorelimit "0"

// ============================================================
// Search & Destroy Settings
// ============================================================
set scr_sd_timelimit "2.5"
set scr_sd_scorelimit "0"

// ============================================================
// Map Rotation
// ============================================================
set sv_mapRotation "gametype tdm map mp_toujane map mp_carentan map mp_brecourt gametype sd map mp_carentan map mp_dawnville"
set sv_mapRotationCurrent ""

Settings Reference

Server Identity

CVar	Description	Default
sv_hostname	Server name shown in the browser and on connect.	""
sv_maxclients	Maximum number of player slots.	20
sv_privateClients	Number of slots reserved for players who know sv_privatePassword.	0
sv_privatePassword	Password for reserved slots.	""
g_motd	Message of the day shown to players on connect.	""

Passwords

CVar	Description
rcon_password	Password for remote console access. Must be at least 8 alphanumeric characters.
g_password	Server join password. Leave empty for a public server.
sv_privatePassword	Password to access reserved private slots.

Network

CVar	Description	Default
sv_maxRate	Maximum data rate per client in bytes/sec. 25000 is standard.	25000
sv_minRate	Minimum data rate per client.	5000
sv_maxPing	Kick players with ping above this value. 0 = no limit.	0
sv_floodProtect	Rate-limit client commands to prevent spam.	1
sv_timeout	Seconds before an idle client is dropped.	40

File Downloads

CVar	Description	Default
sv_allowDownload	Allow clients to download missing files from the server.	1
sv_wwwDownload	Enable HTTP redirect for faster downloads (FastDL).	Auto
sv_wwwBaseURL	Base URL for HTTP downloads.	Auto
sv_pure	Enforce file purity. Rejects clients with modified .iwd files.	1

FastDL on uHost

FastDL is configured automatically on uHost servers. The server's built-in HTTP server (nginx) serves mod files at full speed. You don't need to set sv_wwwDownload or sv_wwwBaseURL unless you want to use your own external download server.

Gameplay

CVar	Description	Values
g_gametype	Active game mode.	dm, tdm, sd, ctf, hq
g_allowvote	Allow players to call votes.	0 off, 1 on
g_antilag	Lag compensation. Keep this 1 for online play.	0 off, 1 on
scr_teambalance	Auto-balance teams.	0 off, 1 on
scr_friendlyfire	Friendly fire mode.	0 off, 1 on, 2 reflect, 3 shared
sv_voice	Enable in-game voice chat.	0 off, 1 on

Per-Game-Type Settings

Each game type has its own score and time limits. Replace <type> with the game type code (dm, tdm, sd, ctf, hq).

CVar	Description
scr_<type>_scorelimit	Score needed to win. 0 = no limit.
scr_<type>_timelimit	Time limit in minutes. 0 = no limit.
scr_<type>_numlives	Lives per player per round. 0 = unlimited.

Search & Destroy has additional settings:

CVar	Description	Default
scr_sd_bombtimer	Seconds until planted bomb detonates.	45
scr_sd_planttime	Seconds to plant the bomb.	5
scr_sd_defusetime	Seconds to defuse the bomb.	5

Logging

CVar	Description	Default
g_log	Log file name.	games_mp.log
g_logsync	Logging mode. 0 = off, 1 = buffered, 2 = continuous.	2
logfile	Enable the log file.	1

Map Rotation

The sv_mapRotation CVar defines the map and game type cycle. Format:

gametype <type> map <internal_name> map <internal_name> gametype <type> map <internal_name>

The gametype keyword persists until the next gametype keyword. This means you can list multiple maps under the same game type without repeating it:

// TDM on Toujane and Carentan, then S&D on Carentan and Dawnville
set sv_mapRotation "gametype tdm map mp_toujane map mp_carentan gametype sd map mp_carentan map mp_dawnville"

See the Overview for the full list of map names.

FastDL (HTTP Redirect Downloads)

By default, CoD2 transfers mod files to clients over UDP, which is extremely slow. FastDL redirects these downloads to an HTTP server for full-speed transfers.

On uHost, FastDL is configured automatically. The server runs a built-in nginx instance that serves files from your mods/ directory over HTTP. No setup is required.

If you need to use a custom download server instead:

set sv_wwwDownload "1"
set sv_wwwBaseURL "http://your-download-server.com/cod2/"

The HTTP server directory must mirror your game server's file structure:

server/
  mods/
    mymod/
      mod.ff
      z_mymod.iwd