Client patches 0.2.7 for Project Zomboid 42.21.0

Unofficial client-side fixes for Project Zomboid 42.21.0 on Windows. This package only works with that exact game version: the installer checks the SHA-256 of projectzomboid.jar and refuses any other build.

New in 0.2.7

• Car thrown tens or hundreds of tiles away while driving (42.21.0 bug). When you drive into an area that has not loaded yet, everything around the car can go black and the car suddenly lands in a forest or in water far away; AutoDrive then stops with "too far from the road". The game sometimes unloads all map chunks around a moving car at once. The car keeps pointing at its old chunk, that chunk gets reused for a different place, and the game then moves the car into that place. The client fixes now keep the car in its own chunk or the chunk next to it; if nothing around it has loaded yet, the car waits where it is until the area loads.
• Engine sound cuts out, then the driver is pulled back to an old position (42.21.0 bug). When the map chunk under a car you are in unloads, the game cannot remove the car and stops updating it: the engine goes silent, the car slows down by itself and stops sending its position. A later vehicle update can then pull you back to where the server last saw you, hundreds of tiles away, sometimes into a river with a black screen. The car now keeps updating, and the driver of a car that your own game simulates is no longer moved to that old position.
• Car pushed under the floor in a collision, black screen. A slow bump into another vehicle can push the car below the ground. The camera follows the car's height, so the whole view goes black (the HUD and minimap stay), and after you get out the car is stuck half in the ground. A car that your own game simulates (you drive it, or you just hit it) is now put back on the ground in the same frame. Servers running our server patches also lift such a car when it is handed back to the server.

Players who do not install the package see no difference: everything here runs only on your own computer and changes nothing on the server or for other players.

The new vehicle fixes were checked with automated tests against the real game classes, with the unpatched game as a negative control. These situations cannot be triggered on demand, so they have not been reproduced in a live game yet. Each fix can be turned off with a JVM flag: -Dmdc.vehicleClampGuard=off, -Dmdc.vehicleOrphanUpdate=off, -Dmdc.driverRecallGuard=off, -Dmdc.vehicleSinkGuard=off.

Also included (unchanged from 0.2.6)

• Disconnected to the main menu near player-built houses (42.21.0 bug), when someone builds or removes something nearby while that part of the map is still loading.
• Less lag where many mod vehicles are parked: an unchanged pose of a door, hood, window or armor part is not recalculated every frame (KI5 series, W900 semi trucks and similar).
• Objects vanish in player-built rooms (42.21.0 bug). In an enclosed room built next to or on top of a pre-built building, furniture, trees and fences disappear as soon as you walk in. TIS has fixed this internally (forum thread).
• Invisible players, zombies and vehicles (only the shadow and name tag remain): texture-pipeline leak fixes, plus a higher texture wait limit in the standard variant.
• A chunk-streaming log for black-edge reports (logging only, no behavior change).

Technical details: client patches, §2by, §2bz, §2ca, §2bu, §2br, §2bs, §2bl and §2j.

Install

1. Close the game and extract the whole zip into any folder: your Desktop or Downloads is fine, it does not need to be in the game folder. The installer finds the game through Steam by itself, even on another drive, and asks you to paste the path only if it cannot.
2. Run Install-Patches.bat, type 1 (install or update), then 1 (client fixes).
3. Press Enter to take the recommended variant (standard for 32 GB RAM or more, low-memory otherwise), then Y.

The menus follow your Windows display language (English or Traditional Chinese). Press L in the main menu to switch, or start it with Install-Patches.bat -Lang en.

Before any game update, run Uninstall-Patches.bat from the extracted folder and choose A. Keep that folder, or download the same zip again when you need it. Updating with the patches still installed can stop you from joining servers or cause errors right after connecting.

Upgrading from 0.2.0–0.2.6: run the new installer the same way; there is no need to uninstall first.

Verify the download

SHA256SUMS.txt lists the SHA-256 of the zip. In PowerShell:

Get-FileHash .\MinidoracatClientPatches-42.21.0-0.2.7.zip

Built from commit 52aeb2d against projectzomboid.jar SHA-256 e1a69eb743ede60b213a0fe7f8b83d4fcab773036d256cc4543a336f3b058a33 (42.21.0). The installer also verifies every file it writes against the package manifest.

Notes

• The zip contains modified copies of a few classes from projectzomboid.jar (© The Indie Stone), generated from the unmodified official 42.21.0 jar by the patcher in this repository. This is an unofficial project with no affiliation with The Indie Stone.
• The installer only manages its own files, never overwrites unknown loose classes, and rolls back an interrupted install.

---

繁體中文：Project Zomboid 42.21.0 的客戶端修補（Windows）。0.2.7 新增三項開車相關修正：

• 開車時車被丟到幾十到幾百格外（42.21.0 bug）：開進還沒載入的區域時，車周圍突然一片黑，接著車掉到遠處的樹林或水裡，AutoDrive 顯示「離路太遠」而停止。遊戲有時會把行駛中的車周圍的地圖一次全部卸載，車還指著舊的那塊地圖，那塊被拿去載入別的地方後，遊戲就把車移過去。現在車只會留在自己那塊或相鄰的地圖；周圍都還沒載入時，車在原地等那一帶載入。
• 引擎聲突然消失，接著駕駛被拉回舊位置（42.21.0 bug）：車底下的地圖被卸載時，遊戲移不掉車上有人的車，就停止更新它：引擎聲消失、車自己慢下來、不再回報位置。之後一則車輛更新可能把你拉回伺服器記的舊位置（幾百格外），有時掉進河裡、畫面全黑。現在車會照常更新，自己這台電腦在模擬的車，駕駛不再被拉回舊位置。
• 碰撞後車被推到地板下、畫面全黑：低速碰到別的車時，車可能被推到地面以下。鏡頭高度跟著車，整個畫面變黑（HUD 和小地圖還在），下車後車也陷在地裡。現在自己這台電腦在模擬的車（你開的車，或你剛撞到的車）會在同一幀放回地面。裝了我們伺服器修補的伺服器，在車交回伺服器時也會把這種車抬回來。

這幾項以自動測試對真實遊戲類別驗證過（含原版對照）；這些情況無法隨時觸發，還沒在實際遊戲中重現過。每一項都可以用 JVM 參數關掉：-Dmdc.vehicleClampGuard=off、-Dmdc.vehicleOrphanUpdate=off、-Dmdc.driverRecallGuard=off、-Dmdc.vehicleSinkGuard=off。

沒裝的玩家沒有任何差別；它只在自己電腦上運作，不影響伺服器與其他玩家。原本的「自建房附近被斷線」「模組車停很多的地方比較不卡」「加蓋房間東西消失」「隊友、殭屍、車輛隱形」修正照舊包含在內。

安裝：把整個 zip 解壓縮到任何資料夾（桌面、下載都可以，不用放進遊戲目錄，程式會透過 Steam 自動找到遊戲）→ 執行 Install-Patches.bat → 輸入 1 → 1 → 按 Enter → Y。舊版直接用新安裝器安裝即可，不必先移除。選單會跟著 Windows 語言顯示中文，主選單按 L 可切換。

遊戲更新前一定要先執行解壓縮資料夾裡的 Uninstall-Patches.bat 並選 A，所以資料夾請留著（刪掉了就重新下載同一個 zip）。下載後可用 Get-FileHash 與 SHA256SUMS.txt 比對。