Build 42 Error Fixes — console.txt Triage for 42.21 & 42.22

"Sorry, an unexpected error occurred" is the single most-reported failure across Build 42's road to stable — it dominated the unstable forums and still shows up on 42.20 and 42.21, usually because of mod incompatibility or unpatched minor versions. This guide branches by symptom instead of guessing: Lua errors, Workshop mismatches, "Loading Map" hangs, vanishing zombie hordes, startup black screens, multiplayer connection failures, lag, and corrupted saves each need different fixes. Sources: The Indie Stone official hotfix releases (42.20.1 through 42.20.4, and 42.21), pzfans.com troubleshooting hub, and Steam support discussions, checked 2026-10-30.

42.20.1 through 42.21 patch fixes — what the devs fixed

A sequence of official hotfixes and updates shipped across August and September 2026 addressing widespread support issues:

42.20.1 STABLE hotfix (August 5, 2026):

• Multiplayer anti-cheat & high-pop lag: improved Lua checksum validation; fixed severe performance bottlenecks with chunk unloading on multiplayer servers; fixed crashes when selecting Multiplayer in certain languages; fixed vehicles temporarily disappearing when another player disconnected.
• Save isolation: prevented broken B41 worlds from being accidentally hosted on B42 servers, and fixed missing main-menu entries after switching versions.
• Memory: patched a memory leak that degraded performance over extended sessions; added cleaner memory diagnostics.

42.20.2 STABLE hotfix (August 5, 2026):

• Percent-sign handling: mods must use %% to escape percent signs in translation and script files; added highlighted error logging for mod authors.
• Quick tips displaying % as %% fixed; memory debugging info added to the FPS overlay.

42.20.3 STABLE hotfix (August 17, 2026):

• "Loading Map" infinite hang: fixed the game-breaking issue where players were stuck indefinitely on the "Loading Map" screen when connecting to multiplayer servers.
• Black and gray boxes: reduced visual chunk voids and streaming lag when traveling quickly (driving vehicles or running across chunks).
• Lighting crashes: resolved errors and exceptions triggered during ambient lighting updates.
• Extended player cap: server player limit expanded up to 254 players with dedicated admin override slots.

42.20.4 STABLE hotfix (August 26, 2026):

• Security vulnerabilities patched: removed loadstring and loadstream from the Lua sandbox to block remote exploits.
• Mod error alert: if an older mod used loadstring, the console threw attempt to call global 'loadstring' (a nil value).

42.21 update (Unstable September 23, stable September 28, 2026 — "Re-population of the Dead"):

• Vanishing zombies resolved: completely fixed the bug where large zombie hordes vanished after a player left and re-entered a chunk (single-player and multiplayer).
• Multiplayer zombie duplication tackled: addressed instances where zombies multiplied across client reconnects/desync.
• loadstring and loadstream re-enabled: restored both functions in the Lua sandbox after security review, clearing the loadstring nil errors for mods on 42.21.
• High-ping driving desync fixed: addressed map voids in front of fast vehicles, passenger teleportation, and severe car judder when latency exceeds 150 ms.
• Split-screen vehicle crash resolved: fixed fatal crashes triggered when two players shared a moving vehicle in same-screen co-op.
• XXL tree cutaway: trees no longer hide furniture/houses or block the camera while driving.

42.22 Pre-Release fixes (October 27, 2026):

• Server-side damage: PvP damage is now calculated on the server, fixing hits that silently failed to register.
• Doppelganger/cloned character bug: fixed the duplicated character at chunk edges that could get the real player killed.
• "Entity is already registered" server freeze: fixed a dedicated-server hang, plus a StackOverflowError in ItemContainer.getCharacter() and an IsoGridSquare.BurnWalls hang with multi-tile objects.
• Trailers and vehicles: multiple trailer physics and towing-desync fixes, and moving vehicles no longer disappear permanently after a reconnect or server restart.
• Map knowledge: the "All Known On Start" sandbox option works in MP again, and map notes no longer vanish after being stored in a container.
• Save-adjacent fixes: animal deaths on zone unload, rabbit kits starving, and chickens disappearing from full hutches are all addressed in the same build.

Takeaway: if you are on stable, update to 42.21 — it is the default build since September 28, 2026, and it fixes the vanishing hordes, the MP duplication bug and the disabled loadstring. Only opt into the Pre-Release branch (Properties → Game Versions & Betas → Pre-Release) if you want to test 42.22, and back up your save first.

Open issues reported on 42.21 (no fix in the 42.22 notes)

These are player reports on the official PZ Support forum, not confirmed engine bugs, and none of them appear in the 42.22 patch notes. Treat them as "known complaints to check against" if you hit the same symptom, not as documented defects:

If you match one of these, do the basics first — verify files, test a fresh vanilla save, and attach logs.zip to a forum report. Do not install "fix" mods or third-party patches for them; the 42.22 Pre-Release notes do not claim to resolve any of these.

Before any fix: back up and locate your files

Quit the game and any server process first, then copy the failing save (or the whole user-data folder) to a dated backup. Never delete the user-data folder wholesale as a first step.

How to read console.txt

Reproduce the problem once, quit, then open the fresh console.txt and find the first ERROR, Exception, Caused by, or stack traceback line — everything after the first real error is usually noise. Note whether the trace names a mod folder path or a Workshop numeric ID, plus your platform, single-player vs multiplayer, and exact game build (e.g. 42.20.0). The red in-game error counter ("Error N") is just a count of recorded Lua exceptions: many are non-fatal, but a rising count naming a mod path needs isolation.

Fixing "unexpected error occurred"

The fix ladder, in order of how often each step actually works:

1. Isolate mods. Load → More → Mods, disable the suspect from your console trace, retest. Multiple suspects? Binary search — disable half the list per round after a full backup.
2. Verify integrity of game files in Steam (right-click → Properties → Installed Files).
3. Clean reinstall as last resort: uninstall, then delete leftover files in Steam\steamapps\common\ProjectZomboid, reinstall. This was the confirmed resolution path for vanilla B42.18 crash threads when mods were already ruled out.
4. Still crashing vanilla? The Indie Stone support staff ask for your logs.zip — upload it and link it in your bug report rather than reinstalling repeatedly.

Symptom triage table

Workshop mismatch and subscription errors

For version mismatches, follow the game's own hint first: either the server is outdated (restart it after Workshop updates finish) or your client is (fully exit Steam, relaunch, wait for Workshop downloads, rejoin once). Confirm both sides run the same Steam branch — stable 42.20 vs unstable — since a branch mismatch looks exactly like a mod error. Mass unsubscribe-everything and reinstalling are not first responses. For subscribe/download failures: confirm the item still exists on the Workshop, check disk space, and remember that removed mods must be disabled on the save itself — unsubscribing doesn't rewrite old mods.txt requirements.

Startup crashes and black screens

Update GPU drivers from the vendor (not third-party packs), disable the Steam Overlay if it crashes at launch, verify files, and boot once with all save mods disabled to separate install problems from save/mod problems. Window off-screen or tiny on a high-DPI monitor? Set a fixed resolution, try windowed/borderless, or override high-DPI scaling on the executable in Windows compatibility properties. Use the 64-bit client; don't fall back to 32-bit batch-file hacks, and don't paste Windows .bat steps onto macOS.

Multiplayer connection failures

Read both client and host console.txt for bind failures and timeouts before touching routers. Verify the server reached ready state and that both sides share the same branch/build. Check the host config for real listen ports — DefaultPort (join UI commonly starts at 16261) and UDPPort, plus any Steam UDP ports — and forward exactly those on the host firewall/router. "Port already in use" means a duplicate server process; stop it instead of launching another instance. If players hang indefinitely on "Loading Map," confirm both server and client are updated to 42.20.3 or higher.

Corrupt saves and "World Version is zero"

Do not transplant map_ver.bin or players.db between worlds — live saves bind those files plus vehicle DBs and chunk files to one world, mod set, and version. Rolling back to yesterday's full folder copy beats surgical file swaps every time.

Lag and OutOfMemory

Lower lighting, water, 3D corpses, and VSync first; temporarily disable heavy map/UI/texture mods — most "lag" is script or streaming load, not heap size. On servers, dense towns at high vehicle speed overload chunk streaming: lower speed limits. The 42.20.1 and 42.20.3 hotfixes eliminated major memory leaks, so update to 42.21 before reconfiguring Java heap. Touch memory flags only if the log shows real OutOfMemory errors: stock 64-bit installs often launch around -Xms1800m/-Xmx2048m, keep -Xms ≤ -Xmx, and raise in steps of a few hundred MB. Setting -Xmx above available RAM increases swapping and makes lag worse.

Verified on 42.21 stable & 42.22 Pre-Release · Last checked 2026-10-30

File paths, triage branches, and safe-recovery rules come from the pzfans.com troubleshooting hub tagged for Build 42.19; error prevalence and clean-reinstall resolutions from Steam discussions and The Indie Stone forums. The hotfix section is verified against official 42.20.1 through 42.20.4 stable release notes and the Build 42.21 release ("Re-population of the Dead", Unstable September 23, stable September 28, 2026). Exact default heap values vary by install — confirm yours before editing.