Client patches 0.2.8 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.8

• Car upside down deep under the ground, falling forever with a black screen. When a car ends up upside down far below the ground (for example after being thrown into the void), it keeps falling on your screen: the view goes black apart from the HUD, and the speedometer climbs to hundreds of km/h. Since 0.2.7 the client fixes put a car that sank under the floor back on the ground, but they skipped cars lying on their roof. Now a car that your own game simulates (you drive it, or you just hit it) and that is upside down at least one floor (about 2.5 m) below the ground is turned upright, still facing the same way, and put back on the ground in the next frame. A car on its roof on the ground or in a shallow ditch is left for you to flip back, as before. Servers running our server patches do the same when such a car is handed back to the server (when you get out or log out).

This was checked with automated tests against the real game classes, with the unpatched game as a negative control, and in a live multiplayer test on a local server: a test script turned the car upside down 20 m under the ground, the client fixes set it upright on the ground in the next frame, and it stayed there. It can be turned off with the JVM flag -Dmdc.vehicleSinkGuard=off.

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.

Also included (unchanged from 0.2.7)

• Car thrown tens or hundreds of tiles away while driving (42.21.0 bug), when everything around the car unloads at once while driving into an area that has not loaded yet.
• Engine sound cuts out, then the driver is pulled back to an old position (42.21.0 bug), when the map chunk under the car unloads.
• Car pushed under the floor in a collision, black screen: an upright car is put back on the ground in the same frame.
• 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). 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, §2ca, §2by, §2bz, §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.7: 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.8.zip

Built from commit bc887b0 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.8 新增一項開車相關修正：

• 翻覆的車掉到地面下很深的地方，畫面全黑、一直往下掉：車四輪朝天掉到地面下很深的地方時（例如被丟進虛空），在你的畫面上會一直往下掉：整個畫面全黑只剩 HUD，車速表衝到幾百 km/h。0.2.7 起會把陷到地板下的車放回地面，但會略過翻覆的車。現在自己這台電腦在模擬的車（你開的車，或你剛撞到的車）只要四輪朝天、而且低於地面一層樓（約 2.5 m）以上，就會在下一幀扶正（車頭方向不變）並放回地面。在地面上或淺溝裡翻車的，照舊留給你自己翻正。裝了我們伺服器修補的伺服器，在車交回伺服器時（下車或離線）也會這樣處理。

這項以自動測試對真實遊戲類別驗證過（含原版對照），也在本機多人伺服器實際測過：用測試腳本把車翻成四輪朝天、放到地面下 20 m，下一幀就扶正放回地面，之後一直停在地面上。可以用 JVM 參數 -Dmdc.vehicleSinkGuard=off 關掉。

沒裝的玩家沒有任何差別；它只在自己電腦上運作，不影響伺服器與其他玩家。0.2.7 的「開車時車被丟到遠處」「引擎聲消失後被拉回舊位置」「碰撞後車被推到地板下」，以及「自建房附近被斷線」「模組車停很多的地方比較不卡」「加蓋房間東西消失」「隊友、殭屍、車輛隱形」修正照舊包含在內。

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

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