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.