# Project Zomboid Server INI Reference (/docs/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 [#file-location]

```
Zomboid/Server/[servername].ini
```

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

Network Settings [#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 [#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 [#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 [#sleep-settings]

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

Anti-Cheat [#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 [#rcon-settings]

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

Mod Settings [#mod-settings]

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

**Example:**

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

Voice Chat [#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 [#map-settings]

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

**Example with mod maps:**

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

Server Messages [#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 [#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 [#steam-settings]

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

Complete Example [#complete-example]

```ini title="[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
```

Related Guides [#related-guides]

See also: [Configure Your Server](/docs/project-zomboid/server-config) | [Sandbox Settings](/docs/project-zomboid/sandbox-settings) | [RCON](/docs/project-zomboid/rcon)

If you need help, join our [Discord](https://discord.xgamingserver.com/).