Server Configuration Guide
Project Zomboid offers extensive server configuration options allowing you to customize your gaming experience. This comprehensive guide covers all available settings, their effects, and how to configure them through the Supercraft panel or directly in configuration files.
Configuration Overview
Project Zomboid uses INI + Lua configuration files for server configuration. Settings can be adjusted through the Supercraft configuration panel or by editing files directly.
Basic Server Settings
| Setting | Type | Default | Description |
|---|---|---|---|
PublicName |
String | String | `PublicName` Valid values: Server name in browser |
PublicDescription |
String | String | `PublicDescription` Valid values: Server description |
Password |
strProp` | String | `Password` Valid values: Join password |
MaxPlayers |
Integer | 1-100 | `MaxPlayers` Valid values: Max concurrent players |
Public |
Boolean | Boolean | `Public` Valid values: List in browser |
Open |
Boolean | Boolean | `Open` Valid values: Allow new accounts |
Admin Settings
| Setting | Type | Default | Description |
|---|---|---|---|
AdminPassword |
strProp` | Auto-generated | Custom Valid values: Admin access password |
RCONPassword |
strProp` | Empty | `RCONPassword` Valid values: RCON password |
PvP & Safety
| Setting | Type | Default | Description |
|---|---|---|---|
PVP |
Boolean | `true` | `PVP` Valid values: Enable PvP combat |
SafetySystem |
Boolean | `true` | `SafetySystem` Valid values: Individual PvP toggle |
ShowSafety |
Boolean | `true` | `ShowSafety` Valid values: Show PvP skull icon |
SafetyToggleTimer |
Integer | 2 | `SafetyToggleTimer` Valid values: PvP toggle delay (sec) |
SafetyCooldownTimer |
Integer | 3 | `SafetyCooldownTimer` Valid values: PvP cooldown (sec) |
PVPMeleeDamageModifier |
Float | 30.0 | `PVPMeleeDamageModifier` Valid values: Melee PvP damage |
PVPFirearmDamageModifier |
Float | 50.0 | `PVPFirearmDamageModifier` Valid values: Ranged PvP damage |
Gameplay Settings
| Setting | Type | Default | Description |
|---|---|---|---|
PauseEmpty |
Boolean | `false` | `PauseEmpty` Valid values: Pause when empty |
GlobalChat |
Boolean | `true` | `GlobalChat` Valid values: Global /all chat |
ServerWelcomeMessage |
String | "Welcome to Project Zomboid!" | `ServerWelcomeMessage` Valid values: Join welcome message |
NoFire |
Boolean | `false` | `NoFire` Valid values: Disable fire spread |
AnnounceDeath |
Boolean | `false` | `AnnounceDeath` Valid values: Announce player deaths |
SleepAllowed |
Boolean | `false` | `SleepAllowed` Valid values: Allow sleeping |
SleepNeeded |
Boolean | `false` | `SleepNeeded` Valid values: Require sleep |
Spawn Settings
| Setting | Type | Default | Description |
|---|---|---|---|
SpawnPoint |
String | "0,0,0" (disabled) | `SpawnPoint` Valid values: Fixed spawn `x,y,z` |
SpawnItems |
String | Empty | `SpawnItems` Valid values: Starting items |
Map |
String | "Muldraugh, KY" | `Map` Valid values: Map name |
Safehouse Settings
| Setting | Type | Default | Description |
|---|---|---|---|
PlayerSafehouse |
Boolean | `false` | `PlayerSafehouse` Valid values: Players can claim |
AdminSafehouse |
Boolean | `false` | `AdminSafehouse` Valid values: Admin-only claim |
SafehouseAllowTrepass |
Boolean | `true` | `SafehouseAllowTrepass` Valid values: Non-members can enter |
SafehouseAllowFire |
Boolean | `true` | `SafehouseAllowFire` Valid values: Fire damages safehouse |
SafehouseAllowLoot |
Boolean | `true` | `SafehouseAllowLoot` Valid values: Non-members can loot |
SafehouseAllowRespawn |
Boolean | `false` | `SafehouseAllowRespawn` Valid values: Respawn in safehouse |
SafehouseDaySurvivedToClaim |
Integer | 0 | `SafehouseDaySurvivedToClaim` Valid values: Days required to claim |
Loot Settings
| Setting | Type | Default | Description |
|---|---|---|---|
HoursForLootRespawn |
Integer | 0 | `HoursForLootRespawn` Valid values: Respawn interval (0=disabled) |
MaxItemsForLootRespawn |
Integer | 4 | `MaxItemsForLootRespawn` Valid values: Max items for respawn |
ItemNumbersLimitPerContainer |
Integer | 0 | `ItemNumbersLimitPerContainer` Valid values: Container item limit |
VOIP Settings
| Setting | Type | Default | Description |
|---|---|---|---|
VoiceEnable |
Boolean | `true` | `VoiceEnable` Valid values: Enable voice chat |
VoiceMinDistance |
Float | 10.0 | `VoiceMinDistance` Valid values: Min hearing distance |
VoiceMaxDistance |
Float | 300.0 | `VoiceMaxDistance` Valid values: Max hearing distance |
Voice3D |
Boolean | `true` | `Voice3D` Valid values: Directional audio |
Mods
| Setting | Type | Default | Description |
|---|---|---|---|
Mods |
String | Empty | `Mods` Valid values: Mod IDs (semicolon sep) |
WorkshopItems |
String | Empty | `WorkshopItems` Valid values: Workshop IDs (semicolon sep) |
Frequently Asked Questions
How do I enable PvP in Project Zomboid?
Enable PvP by setting the PvP or player damage option to 'Enabled' in the Gameplay Settings section. Some games also allow you to configure friendly fire separately. Save your configuration and restart the server.
How do I set a password for my Project Zomboid server?
Set a server password in the Basic Server Settings section. Enter your desired password in the 'Server Password' field. Leave it empty for a public server without password protection. Save and restart your server.
How do I configure admin access?
Admin access can be configured through the Admin/Access Control settings. Add Steam IDs or usernames to the admin list, depending on your game's authentication system. Consult the specific admin list documentation for your game.
Why aren't my configuration changes applying?
Configuration changes require a server restart to take effect. After saving your settings in the Supercraft panel, restart your server. If changes still don't apply, verify the configuration file syntax is correct and check server logs for errors.
Can I upload a custom configuration file?
Yes, you can upload custom configuration files through the Supercraft file manager. Navigate to the configuration directory, upload your file, and restart the server. Ensure your file follows the correct format for your game.
Do I need to restart the server after changing settings?
Yes, most configuration changes require a server restart to take effect. Some games support hot-reloading for specific settings, but it's recommended to always restart after making configuration changes.
Using the Supercraft Configuration Panel
Our platform provides a user-friendly interface for managing your Project Zomboid server configuration without editing files manually.
- Log in to your Supercraft panel at https://supercraft.host/my-account
- Navigate to your Project Zomboid server from the deployments list
- Click the "Configuration" tab
- Adjust settings using the intuitive form controls
- Click "Save Configuration" to apply changes
- Restart your server for changes to take effect
The configuration panel validates your inputs and prevents invalid values, ensuring your server starts correctly.
Troubleshooting
Settings not applying after save
Ensure you've restarted the server after saving configuration changes. Most settings require a full server restart. Check the server logs for any configuration errors that might prevent the server from starting.
Configuration file validation errors
Verify that your configuration file follows the correct format for your game. Check for syntax errors like missing quotes, incorrect separators, or invalid values. Use the Supercraft configuration panel to validate settings before applying them.
Server won't start after config change
Revert to the previous working configuration using the Supercraft file manager's backup feature. Check server logs for specific error messages. Common issues include invalid port numbers, malformed file paths, or out-of-range numeric values.
References
- PZwiki Server Settings
- Steam Guide - Server Configuration
- XGamingServer - servertest.ini Explained
- Nitrado PZ Configuration Files