October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk9 min

Project Zomboid Server Configuration Files Explained

A practical guide to Project Zomboid’s INI, SandboxVars, spawn and save files, with profile-name checks, safe editing steps, Workshop mod setup and troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Project Zomboid loads a dedicated server’s settings from several files that share the profile name in Zomboid/Server/. The matching <servername>.ini controls identity, access, ports, slots and other server behavior; <servername>_SandboxVars.lua controls world rules; the spawn files define region choices and coordinates. If an edit appears to do nothing, first verify that you changed the files for the profile the server actually starts, then restart and check the live world and logs.

Where Project Zomboid stores dedicated-server settings

A dedicated server uses a profile name. The default is commonly servertest, so a typical set is servertest.ini, servertest_SandboxVars.lua, servertest_spawnregions.lua and servertest_spawnpoints.lua. A hosting panel or startup configuration can use another name. The server reads the files whose base name matches that active profile; editing a different profile creates the classic “my change had no effect” problem.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

All four configuration files are in Zomboid/Server/. The persistent map is separate, under Zomboid/Saves/Multiplayer/<server>. Keep the save and the matching profile files together when making backups. NolimitHost’s documentation, updated September 18, 2026, summarizes the arrangement as four server-settings files inside the Zomboid/Server/ folder.

How the profile name is selected

The name comes from the server start command or the hosting panel’s server-name field. If you rename a profile, the game can generate a new default set under the new name. Before changing anything, note the exact name shown by the panel or launch configuration, including capitalization and punctuation, and use that name in every file.

#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter | 4Pack Type C Female to A Male Cable Converter for Apple Duo 17 16 15 14 Plus,iWatch Watch 12 11 10,iPad 9 8 Air,Airpods 5 4
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

File-by-file map

File or folder What it controls What to check when editing
<servername>.ini Server identity, listing visibility, password, access mode, player slots, PvP, ports, anti-cheat, voice, save behavior and mod fields Use one Key=Value entry per line. The file must match the active profile name.
<servername>_SandboxVars.lua World simulation and difficulty: zombie population and distribution, loot, time, weather, survival systems and vehicles Preserve valid Lua syntax. These settings are not substitutes for port, password or slot options.
<servername>_spawnregions.lua The named regions that players can select when spawning Confirm that the region you edited is actually offered by the active profile.
<servername>_spawnpoints.lua Exact coordinates associated with occupations or other spawn definitions Check that the selected occupation or spawn definition references the entry you changed.
Zomboid/Saves/Multiplayer/<server> Persistent multiplayer world data Back up this directory with the matching configuration files; either alone is an incomplete recovery set.

What belongs in the main INI file

The INI is the server’s operational control panel in text form. It describes how the server is presented, who may join and which network and administration features are enabled.

Identity and access

  • Public=true makes the server eligible for the in-game public browser. PublicName= and PublicDescription= supply the listing text.
  • Password= sets the password players enter to join. It is separate from any RCON or administrator credential.
  • Open=true permits open joining. With Open=false, approved-account or whitelist handling is required.
  • PVP controls the player-versus-player rule exposed by the server configuration. Make the value explicit rather than assuming the game’s current default.

Slots and networking

MaxPlayers= sets the configured player-slot ceiling. A cited example servertest.ini uses MaxPlayers=32 and warns that higher counts can hurt map streaming and synchronization. Treat 32 as an example from that file, not a universal limit for every build or machine.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The same example contains DefaultPort=16261, SteamPort1=8766 and SteamPort2=8767. These are recorded configuration values, not a promise that every release, panel or hosting environment uses identical ports. Check the generated file after updates and make firewall or forwarding rules match the values the running server reports.

Administration, anti-cheat and voice

The INI also contains whitelist behavior, anti-cheat and checksum options, voice-chat settings and save intervals. Change these as a group when adjusting administration policy, and document the old values so a failed test can be reversed without guessing. A setting that affects access can require a fresh client connection before its effect is visible.

Rank #2
Sale
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter | USB C Dongle with 90W Max Power Delivery, 3×5Gbps USB A Data Ports, for MacBook, Dell, and More (Charger Not Included)
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

Mod fields

WorkshopItems= is a semicolon-separated list of numeric Steam Workshop IDs. Mods= is a semicolon-separated list of text mod IDs read from each mod’s metadata. They are different identifiers and both fields matter. A Workshop ID can download files without activating the mod if its text ID is absent; a text ID without a downloadable Workshop item can leave clients unable to obtain the required files.

SandboxVars: the world and its rules

<servername>_SandboxVars.lua governs the simulation rather than the server’s public identity. Population multipliers, zombie distribution, day length, start date, loot abundance, weather, survival mechanics, vehicles and related world-generation controls belong here. If the question is “How many zombies or how much loot should this world have?”, look in SandboxVars, not the INI.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the Lua structure intact. A missing comma, unmatched brace or altered quotation mark can prevent the file from loading correctly. Make one logical group of changes at a time, restart, and verify the result in-game. Lua sandbox edits require a restart; the provider guidance that allows live option commands for some INI values does not make SandboxVars hot-reloadable.

Spawn regions and spawn points

_spawnregions.lua

This file defines the named regions offered on the character-spawn screen. Changing a region name or list does not move a player by itself; it changes which choices are available to the client.

Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter | 85W Max PD, 2 USB 3.0 & 1 USBC Data Ports, SD/TF Card Reader, for Laptops/Mac and Other Type C Devices (Charger Not Included)
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

_spawnpoints.lua

This file stores coordinate definitions tied to occupations or other spawn entries. If a coordinate edit appears ignored, verify both the profile name and the occupation or region selected by the character. An unused entry can be perfectly valid yet never affect a spawn.

Safe editing workflow

  1. Stop the server cleanly. Do not edit a profile while the process is writing it.
  2. Make a dated backup. Copy the complete Zomboid folder when practical. At minimum, copy every active profile file and the matching directory in Zomboid/Saves/Multiplayer/ to separate dated storage.
  3. Confirm the active profile. Read the startup command or hosting panel and write down the exact server name. Open only the files with that base name.
  4. Edit one logical group. Use a plain-text editor. Preserve Key=Value syntax in the INI and valid Lua syntax in SandboxVars and spawn files.
  5. Save and start the server. Wait for a clean startup, then connect with a client and test one changed value.
  6. Record the result. Note the date, changed keys and observed behavior. If the test fails, restore the backup or revert only that group before trying another change.

Some INI options can be changed through the server console commands /reloadoptions and /changeoption, according to the provider guidance. Those commands do not replace a restart for Lua sandbox or spawn-file edits, and a restart remains the clearest way to ensure the complete profile is read from disk.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Adding Workshop mods correctly

Mod setup is a four-way compatibility check: the server and clients must use the same game branch/build, the Workshop download list must be present, the text mod list must be present, and map dependencies must be loaded in a workable order.

  1. Confirm the build. Put the server and every client on the same branch and build before diagnosing a mod failure.
  2. Collect both identifiers. Copy each item’s numeric Workshop ID into WorkshopItems=. Copy the text ID shown in that mod’s metadata into Mods=.
  3. Use semicolons. Separate multiple values with semicolons, not commas or spaces that become part of an ID.
  4. Handle maps separately. A map may depend on a framework or another map. Include every dependency required by the map instead of assuming the primary Workshop item is sufficient.
  5. Change small batches. Add one mod or a small related group, restart, connect and inspect the server log before adding more. Smaller batches identify the incompatible item faster.
  6. Have clients match. Players need the same mod set and compatible versions. A server that downloads an item but does not activate its text ID can look installed while still presenting missing-content errors.

Why a servertest.ini change did nothing

Use this order of checks; it catches the most common causes without randomly changing several files.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray | Data transfer & Fast charging for MacBook, iPhone 17/16/15, iPad, Samsung Galaxy, Apple Watch
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

1. The file belongs to another profile

Compare the startup profile name with the filename. If the server starts as myserver, editing servertest.ini is irrelevant even if both files are in the same folder. A renamed profile may also have caused the game to generate a fresh default set.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. The process was still running

Configuration is read at boot, and a running process can overwrite edits. Stop it, save the file, then start again. Test from a newly connected client rather than relying on an already-open session.

3. The wrong file type was edited

Ports, passwords, visibility and slots are INI concerns. Zombie population, loot, time and weather are SandboxVars concerns. Spawn choices and coordinates belong in their respective spawn files. Moving a setting to another file cannot make it work.

4. Syntax or separators are invalid

Check for a missing equals sign, accidental smart quotes, a broken Lua delimiter or commas used where semicolons are required. Compare the changed line with an untouched line in the same file.

Best Value
Sale
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display | 85W Max PD, 1 Powered USB-C 5Gbps & 2 Powered USB-A 3.0 5Gbps Data Ports, for MacBook Pro, MacBook Air, Dell and More (Black)
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

5. The selected game path does not reference the edited entry

For a spawn change, choose the region and occupation that point to the edited definition. For a mod, verify both IDs and every dependency. For a public listing change, allow time for the client browser to refresh after the restart.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

6. A version or panel default replaced the value

After a game update or panel migration, reopen the active file and check the generated values. Ports, player limits and option names can be version-sensitive. Treat the current file from the running build as authoritative, not an old example copied from another release.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Recorded ports and player limits: how to interpret them

Value Where it appears Qualification
DefaultPort=16261 Example servertest.ini Recorded in a configuration example; verify the running build and hosting environment.
SteamPort1=8766 Example servertest.ini Recorded example value; forwarding requirements vary by host and network.
SteamPort2=8767 Example servertest.ini Recorded example value; recheck after updates.
MaxPlayers=32 Example servertest.ini The file warns that counts above 32 may hurt streaming and synchronization; it is not a universal performance guarantee.

Choosing a way to run the server

Choice Strength Trade-off
Listen host Fast setup and convenient for a session with friends The world depends on the host client remaining available.
Dedicated process Persistent uptime independent of a player’s game client Requires maintaining files, updates, networking and backups.
Self-hosted Direct ownership and control of configuration and save files You handle SteamCMD or equivalent installation, firewall rules, storage and recovery.
Managed hosting A control panel and provider-maintained machine can reduce setup work You trade some filesystem control for recurring cost and provider-specific limits; inspect backup, restore, mod and support features before subscribing.
Open or public Easy discovery and joining Requires stronger access, moderation and anti-cheat decisions.
Whitelist or private Predictable membership and lower exposure Every approved account must be managed deliberately.
INI edit Changes access, identity, networking and server behavior Does not change zombie, loot or weather rules.
Sandbox edit Changes world simulation and difficulty Requires valid Lua and a restart.

Backups that can actually restore a world

A useful backup is a matched set: the active profile files from Zomboid/Server/ plus the corresponding multiplayer save directory. Copy it to dated storage before an update, mod change or major rules change. An external USB hard drive or SSD is a practical generic destination; keep at least one copy disconnected from the server so a bad update or accidental overwrite cannot destroy every copy.

Use a naming scheme that records the profile and date, such as myserver-2026-10-14, and retain a known-good copy from before each mod batch. To recover, stop the process, restore the matching profile and save set together, then start and verify the world before allowing players back in. Restoring only an INI can leave the map in a different state; restoring only the save can reintroduce incompatible settings or missing mod references.

Quick preflight checklist

  • Profile name in the startup configuration matches every edited filename.
  • Server is stopped before files are changed and restarted afterward.
  • Backup contains both profile files and the matching multiplayer save.
  • INI keys use one exact Key=Value line each.
  • Sandbox and spawn files remain valid Lua.
  • WorkshopItems contains numeric IDs separated by semicolons.
  • Mods contains the corresponding text IDs, also separated by semicolons.
  • Map dependencies, server build and client build are compatible.
  • Ports and slot counts were rechecked after the last game or panel update.
  • A client test confirms the intended change before more edits are made.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.