How to configure your Project Zomboid
Updated July 02, 2026
Project Zomboid Project Zomboid Configuration
This guide covers the configuration files and key settings for your Project Zomboid server. For first boot and connecting, see Getting Started.
Project Zomboid uses three INI files in the server data folder (typically Zomboid/Server/):
<servername>.ini(main settings)<servername>_SandboxVars.lua(sandbox / gameplay rules)<servername>_spawnregions.lua(where players spawn)
The default <servername> is servertest.
Main INI File
Highlights:
INI
PublicName=My GSK Zomboid Server PublicDescription=Welcome to the apocalypse MaxPlayers=16 PingLimit=400 Open=true Password= ServerPlayerID= AutoCreateUserInWhiteList=false DisplayUserName=true ShowFirstAndLastName=false SpawnPoint=0,0,0 SafetySystem=true ShowSafety=true SafetyToggleTimer=2 SafetyCooldownTimer=3 SpawnItems= DefaultPort=16261 ResetID= Mods= Map=Muldraugh, KY DoLuaChecksum=true DenyLoginOnOverloadedServer=true LoginQueueEnabled=false LoginQueueConnectTimeout=60 WorkshopItems= SteamScoreboard=true SteamVACDocs=true BackupsCount=5 BackupsOnStart=true BackupsOnVersionChange=true BackupsPeriod=0 PVP=true PauseEmpty=true GlobalChat=true ChatStreams=s,r,a,w,y,sh,f,all ServerWelcomeMessage=Welcome to GSK Zomboid! Type /help for commands. LogLocalChat=false AutoCreateUserInWhiteList=false KickFastPlayers=false ServerPlayerID= RCONPort=27015 RCONPassword= DiscordEnable=false DiscordToken= DiscordChannel= DiscordChannelID= Public=false PingFrequency=10 PingLimit=400 HoursForLootRespawn=0 MaxItemsForLootRespawn=4 ConstructionPreventsLootRespawn=true DropOffWhiteListAfterDeath=false NoFireSpread=false NoFire=false AnnounceDeath=false MinutesPerPage=1.0 SaveWorldEveryMinutes=0 PlayerSafehouse=false AdminSafehouse=false SafehouseAllowTrepass=true SafehouseAllowFire=true SafehouseAllowLoot=true SafehouseAllowRespawn=false SafehouseDaySurvivedToClaim=0 SafeHouseRemovalTime=144 SafehouseAllowNonResidential=false AllowDestructionBySledgehammer=true KickFastPlayers=false SneakModeHideFromOtherPlayers=true SpeedLimit=70.0
Key fields to change first:
| Field | Notes |
|---|---|
| PublicName / PublicDescription | Server identity |
| MaxPlayers | Slot count |
| PVP | True for PvP, false for PvE |
| Password | Server password (leave blank for public) |
| Open | Whether server is open to new connections |
| WorkshopItems | Comma-separated workshop IDs |
| Mods | Comma-separated mod folder names |
| RCONPassword | Set for RCON tools |
| Public | True to show in PZ public server list |
Restart after editing.
SandboxVars (Gameplay Rules)
The <servername>_SandboxVars.lua file controls everything about the world: zombie population, loot rarity, weather, time speed.
A few key lines:
LUA
SandboxVars = {
Zombies = 3, -- 1=Insane, 2=High, 3=Normal, 4=Low
Distribution = 1, -- 1=Urban Focused, 2=Uniform
DayLength = 3, -- 1=15min, 2=30min, 3=1hr, 4=2hr...
StartYear = 1,
StartMonth = 7,
StartDay = 9,
StartTime = 2, -- 1=7am, 2=9am, 3=noon, 4=2pm, 5=5pm, 6=9pm, 7=midnight
WaterShut = 14, -- Days until water is shut off
ElecShut = 14, -- Days until electricity is shut off
LootRespawn = 1, -- 1=None, 2=Every Day, 3=Every Week, 4=Every Month
StarterKit = false,
Nutrition = true,
FoodRotSpeed = 3, -- 1=Very Fast, 5=Very Slow
XpMultiplier = 1.0,
StatsDecrease = 3, -- 1=Very Fast, 5=Very Slow
-- ... many more
}The PZ wiki and pzwiki.net have the full list. Or use the in-game Host > Server Settings menu to generate a config interactively and copy it to the server.
What to Read Next
- Getting Started for first boot and the basics
- Project Zomboid Admin Setup
- Installing Workshop Mods on Project Zomboid