Project Zomboid Server INI Reference

The [servername].ini file controls your server's core settings — networking, player limits, PVP, mods, and more. This is a complete reference for all settings.

File Location

Zomboid/Server/[servername].ini

On XGamingServer, go to Files and navigate to this path.

Network Settings

Setting	Default	Description
`DefaultPort`	16261	Main server port (UDP)
`UDPPort`	16262	Secondary UDP port
`MaxPlayers`	32	Maximum players allowed
`PublicName`	My Server	Server name shown in browser
`PublicDescription`		Description shown in browser
`Public`	true	Show in server browser
`PingLimit`	400	Kick players with ping above this (ms)

Access & Security

Setting	Default	Description
`Password`		Server password (empty = no password)
`Open`	true	`true` = anyone can join, `false` = whitelist only
`AutoCreateUserInWhiteList`	false	Auto-add new players to whitelist
`DropOffWhiteListAfterDeath`	false	Remove from whitelist on death
`MaxAccountsPerUser`	0	Max accounts per IP (0 = unlimited)
`AllowCoop`	true	Allow splitscreen/co-op connections
`BanKnownBlockedSteamIDs`	true	Auto-ban known cheaters

Gameplay Settings

Setting	Default	Description
`PVP`	true	Enable player vs player combat
`PauseEmpty`	true	Pause server when no players online
`SpawnPoint`	0,0,0	Force spawn location (0,0,0 = random)
`SafetySystem`	true	PVP Safety System (players must opt in)
`ShowSafety`	true	Show PVP safety status above players
`SafetyToggleTimer`	2	Minutes to wait when toggling PVP safety
`SafetyCooldownTimer`	3	Cooldown after PVP combat

Sleep Settings

Setting	Default	Description
`SleepAllowed`	false	Allow players to sleep
`SleepNeeded`	false	Require sleep for character needs

Anti-Cheat

Setting	Default	Description
`DoLuaChecksum`	true	Verify client Lua files match server
`DenyLoginOnOverloadedServer`	true	Deny logins when server is stressed
`AntiCheatProtectionType1`	true	Speed hack detection
`AntiCheatProtectionType2`	true	Player location checks
`AntiCheatProtectionType3`	true	Inventory validation
`AntiCheatProtectionType4`	true	Building placement checks
`AntiCheatProtectionType20`	true	Known exploit blocking
`AntiCheatProtectionType22`	true	Teleport detection
`AntiCheatProtectionType24`	true	Damage validation

RCON Settings

Setting	Default	Description
`RCONPort`	27015	RCON connection port
`RCONPassword`		RCON password (empty = disabled)

Mod Settings

Setting	Default	Description
`Mods`		Semicolon-separated list of mod IDs
`WorkshopItems`		Semicolon-separated Workshop item IDs

Example:

[servername].ini

Mods=Hydrocraft;Arsenal(26)GunFighter
WorkshopItems=498441420;2297098490

Voice Chat

Setting	Default	Description
`VoiceEnable`	true	Enable in-game voice chat
`VoiceMinDistance`	10.0	Distance where voice starts fading
`VoiceMaxDistance`	100.0	Maximum distance for voice
`Voice3D`	true	Directional voice audio

Map Settings

Setting	Default	Description
`Map`	Muldraugh, KY	Maps to load (semicolon-separated)

Example with mod maps:

[servername].ini

Map=Muldraugh, KY;Riverside, KY;Rosewood, KY;West Point, KY;RavenCreek

Server Messages

Setting	Default	Description
`ServerWelcomeMessage`		Message shown when players join
`LoginQueueEnabled`	false	Enable login queue when server is full
`LoginQueueConnectTimeout`	60	Seconds before queue timeout

Backup Settings

Setting	Default	Description
`SaveWorldEveryMinutes`	0	Auto-save interval (0 = disabled)
`BackupsCount`	5	Number of world backups to keep
`BackupsOnStart`	true	Create backup when server starts
`BackupsOnVersionChange`	true	Backup before version updates
`BackupsPeriod`	0	Minutes between auto-backups (0 = disabled)

Steam Settings

Setting	Default	Description
`SteamVAC`	true	Enable Valve Anti-Cheat
`SteamScoreboard`	true	Use Steam scoreboard

Complete Example

[servername].ini

PublicName=My Zomboid Server
PublicDescription=Friendly PVE server
Public=true
MaxPlayers=32
Password=
Open=true
PVP=false
PauseEmpty=true
Mods=
WorkshopItems=
Map=Muldraugh, KY
SleepAllowed=true
SleepNeeded=false

If you need help, join our Discord.

Project Zomboid Server INI Reference

On this page