Skip to content

Server Configuration ​

Complete reference for the CoD4: Modern Warfare 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 ​

ini
// ============================================================
// Server Identity
// ============================================================
set sv_hostname "My uHost CoD4 Server"
set sv_maxclients "18"
set sv_privateClients "0"

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

// ============================================================
// Network
// ============================================================
set sv_maxRate "25000"
set sv_floodprotect "4"
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 "war"
set g_allowvote "1"
set g_antilag "1"
set g_deadChat "0"
set scr_teambalance "1"
set scr_game_allowkillcam "1"
set scr_game_hardpoints "1"
set scr_game_spectatetype "2"

// ============================================================
// Team Deathmatch Settings
// ============================================================
set scr_war_timelimit "10"
set scr_war_scorelimit "750"
set scr_war_numlives "0"

// ============================================================
// Search & Destroy Settings
// ============================================================
set scr_sd_timelimit "2.5"
set scr_sd_scorelimit "9"
set scr_sd_numlives "1"
set scr_sd_bombtimer "45"
set scr_sd_planttime "5"
set scr_sd_defusetime "5"
set scr_sd_roundswitch "3"

// ============================================================
// Map Rotation
// ============================================================
set sv_mapRotation "gametype war map mp_crash map mp_backlot map mp_strike map mp_crossfire map mp_overgrown"
set sv_mapRotationCurrent ""

Settings Reference ​

Server Identity ​

CVarDescriptionDefault
sv_hostnameServer name shown in the browser and on connect.""
sv_maxclientsMaximum number of player slots.18
sv_privateClientsNumber of slots reserved for players who know the sv_privatePassword. Public slots = sv_maxclients minus sv_privateClients.0
sv_privatePasswordPassword for reserved slots.""
g_motdMessage of the day shown to players on spawn.""

Passwords ​

CVarDescription
rcon_passwordPassword for remote console access. Must be at least 8 alphanumeric characters on CoD4x.
g_passwordServer join password. Leave empty for a public server.
sv_privatePasswordPassword to access reserved private slots.

Network ​

CVarDescriptionDefault
sv_maxRateMaximum data rate per client in bytes/sec. 25000 is standard.25000
sv_minRateMinimum data rate per client.5000
sv_maxPingKick players with ping above this value. 0 = no limit.0
sv_minPingKick players with ping below this value. 0 = no limit.0
sv_floodprotectRate-limit chat messages to prevent spam.4
sv_timeoutSeconds before an idle client is dropped.40
sv_reconnectlimitMax reconnect attempts per period.5
g_antilagLag compensation. Always keep this 1 for online play.1

File Downloads ​

CVarDescriptionDefault
sv_allowDownloadAllow clients to download missing files from the server.1
sv_wwwDownloadEnable HTTP redirect for faster downloads (FastDL).Auto
sv_wwwBaseURLBase URL for HTTP downloads.Auto
sv_wwwDlDisconnected0 = stay connected while downloading. 1 = disconnect during download.0
sv_pureEnforce 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 and map 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 ​

CVarDescriptionValues
g_gametypeActive game mode.dm, war, sd, sab, dom, koth
g_allowvoteAllow players to call votes.0 off, 1 on
g_deadChatLet dead players chat to alive players.0 off, 1 on
g_gravityWorld gravity.800 (default)
scr_teambalanceAuto-balance teams.0 off, 1 on
scr_game_allowkillcamEnable killcam.0 off, 1 on
scr_game_hardpointsEnable killstreak rewards (UAV, airstrike, helicopter).0 off, 1 on
scr_game_spectatetypeSpectator mode.0 disabled, 1 team only, 2 free
scr_player_maxhealthPlayer health.100
scr_player_healthregentimeSeconds before health starts regenerating.5
scr_player_sprinttimeSprint duration in seconds.4
scr_hardcoreHardcore mode (reduced HUD, low health, friendly fire).0 off, 1 on
scr_oldschoolOld School mode (weapon pickups, no classes).0 off, 1 on

Friendly Fire ​

CVarDescriptionValues
scr_team_fftypeFriendly fire mode.0 off, 1 on, 2 reflect (damage yourself), 3 shared

Per-Game-Type Settings ​

Each game type has its own score and time limits. Replace <type> with the game type code (war, sd, dom, sab, dm, koth).

CVarDescription
scr_<type>_scorelimitScore needed to win. 0 = no limit.
scr_<type>_timelimitTime limit in minutes. 0 = no limit.
scr_<type>_numlivesLives per player per round. 0 = unlimited.
scr_<type>_roundlimitNumber of rounds.

Search & Destroy has additional settings:

CVarDescriptionDefault
scr_sd_bombtimerSeconds until planted bomb detonates.45
scr_sd_planttimeSeconds to plant the bomb.5
scr_sd_defusetimeSeconds to defuse the bomb.5
scr_sd_roundswitchSwitch sides after this many rounds.3

Killstreak Settings ​

CVarDescriptionDefault
scr_game_hardpointsEnable killstreaks globally.1
scr_hardpoint_allowhelicopterAllow attack helicopters.1
scr_hardpoint_allowuavAllow UAV.1
scr_hardpoint_allowartilleryAllow airstrikes.1

Helicopter Settings ​

CVarDescription
scr_helicopter_healthHelicopter hit points.
scr_helicopter_damageDamage dealt per hit.

Logging ​

CVarDescriptionDefault
g_logLog file name.games_mp.log
g_logsyncLogging mode. 0 = off, 1 = buffered, 2 = continuous.2
logfileEnable the log file.1
sv_log_damageLog all damage events.0

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:

ini
// TDM on Crash and Backlot, then S&D on Strike and Vacant
set sv_mapRotation "gametype war map mp_crash map mp_backlot gametype sd map mp_strike map mp_vacant"

See the Overview for the full list of map names.

FastDL (HTTP Redirect Downloads) ​

By default, CoD4 transfers mod and map 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/ and usermaps/ directories over HTTP. No setup is required.

If you need to use a custom download server instead:

ini
set sv_wwwDownload "1"
set sv_wwwBaseURL "http://your-download-server.com/cod4/"
set sv_wwwDlDisconnected "0"

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

server/
  mods/
    pml220/
      mod.ff
      z_c_r.iwd
  usermaps/
    mp_custommap/
      mp_custommap.ff
      mp_custommap.iwd
      mp_custommap_load.ff

Stop Paying for Empty Servers.