Server INI Reference

Complete reference for all Project Zomboid server.ini configuration settings.

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

SettingDefaultDescription
DefaultPort16261Main server port (UDP)
UDPPort16262Secondary UDP port
MaxPlayers32Maximum players allowed
PublicNameMy ServerServer name shown in browser
PublicDescriptionDescription shown in browser
PublictrueShow in server browser
PingLimit400Kick players with ping above this (ms)

Access & Security

SettingDefaultDescription
PasswordServer password (empty = no password)
Opentruetrue = anyone can join, false = whitelist only
AutoCreateUserInWhiteListfalseAuto-add new players to whitelist
DropOffWhiteListAfterDeathfalseRemove from whitelist on death
MaxAccountsPerUser0Max accounts per IP (0 = unlimited)
AllowCooptrueAllow splitscreen/co-op connections
BanKnownBlockedSteamIDstrueAuto-ban known cheaters

Gameplay Settings

SettingDefaultDescription
PVPtrueEnable player vs player combat
PauseEmptytruePause server when no players online
SpawnPoint0,0,0Force spawn location (0,0,0 = random)
SafetySystemtruePVP Safety System (players must opt in)
ShowSafetytrueShow PVP safety status above players
SafetyToggleTimer2Minutes to wait when toggling PVP safety
SafetyCooldownTimer3Cooldown after PVP combat

Sleep Settings

SettingDefaultDescription
SleepAllowedfalseAllow players to sleep
SleepNeededfalseRequire sleep for character needs

Anti-Cheat

SettingDefaultDescription
DoLuaChecksumtrueVerify client Lua files match server
DenyLoginOnOverloadedServertrueDeny logins when server is stressed
AntiCheatProtectionType1trueSpeed hack detection
AntiCheatProtectionType2truePlayer location checks
AntiCheatProtectionType3trueInventory validation
AntiCheatProtectionType4trueBuilding placement checks
AntiCheatProtectionType20trueKnown exploit blocking
AntiCheatProtectionType22trueTeleport detection
AntiCheatProtectionType24trueDamage validation

RCON Settings

SettingDefaultDescription
RCONPort27015RCON connection port
RCONPasswordRCON password (empty = disabled)

Mod Settings

SettingDefaultDescription
ModsSemicolon-separated list of mod IDs
WorkshopItemsSemicolon-separated Workshop item IDs

Example:

[servername].ini
Mods=Hydrocraft;Arsenal(26)GunFighter
WorkshopItems=498441420;2297098490

Voice Chat

SettingDefaultDescription
VoiceEnabletrueEnable in-game voice chat
VoiceMinDistance10.0Distance where voice starts fading
VoiceMaxDistance100.0Maximum distance for voice
Voice3DtrueDirectional voice audio

Map Settings

SettingDefaultDescription
MapMuldraugh, KYMaps to load (semicolon-separated)

Example with mod maps:

[servername].ini
Map=Muldraugh, KY;Riverside, KY;Rosewood, KY;West Point, KY;RavenCreek

Server Messages

SettingDefaultDescription
ServerWelcomeMessageMessage shown when players join
LoginQueueEnabledfalseEnable login queue when server is full
LoginQueueConnectTimeout60Seconds before queue timeout

Backup Settings

SettingDefaultDescription
SaveWorldEveryMinutes0Auto-save interval (0 = disabled)
BackupsCount5Number of world backups to keep
BackupsOnStarttrueCreate backup when server starts
BackupsOnVersionChangetrueBackup before version updates
BackupsPeriod0Minutes between auto-backups (0 = disabled)

Steam Settings

SettingDefaultDescription
SteamVACtrueEnable Valve Anti-Cheat
SteamScoreboardtrueUse 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

See also: Configure Your Server | Sandbox Settings | RCON

If you need help, join our Discord.

How is this guide?

40% Off — Limited TimeGet your Project Zomboid server todayInstant setup, DDoS protection, and 24/7 support included.
Get a Server

On this page