Repo ↗ · 原始 README ↗ · 文件包（Markdown／授權）

封面參考（原作）： Project Zomboid · 原作宣傳圖，由 IGDB 提供。圖片版權屬原權利人，供辨識原作使用，不代表此重寫／模組專案的實際畫面。

來源維護者： Lumi-nary · 版本： 40a080378a26 · 整理日期： 2026-10-12

文件授權： MIT · LICENSE · 本文形式： README 翻譯

下文為來源 README 的繁中翻譯，由 Kirikirin 使用 AI 輔助整理；功能、完成度與測試結果均為原作者描述，本站未逐項實機驗證。圖片改為來源連結，指令與技術識別保留原文。

Project ZombCraft

本專案已停止開發。 最後一個發行版本為 v0.13.1。若需要這類更完整的專案，請參閱 https://www.youtube.com/watch?v=uLQqniyj14g

Project ZombCraft 將 Project Zomboid Build 42 與真實的 Minecraft Fabric 客戶端連接起來。Project Zomboid 仍負責世界與殭屍模擬；Minecraft 則提供 Steve、移動、方塊、物品欄、生存與 HUD。兩個客戶端透過本機共享記憶體連結進行通訊。

本發行版本為實驗性的單人整合。它不包含 Project Zomboid、Minecraft、Viewpoint、ZombieBuddy、GeckoLib、私人參考檔案，或授權的模型與音訊資產。

玩家需求

  • Project Zomboid Build 42.21
  • ZombieBuddy 2.3.4 與 Viewpoint，需另行安裝於 Project Zomboid 中
  • Prism Launcher，並具備 Minecraft 26.3 的執行個體
  • 在該 Prism 執行個體中，需有 Fabric Loader 0.19.5、Fabric API 0.161.0+26.3，以及適用於 Fabric/Minecraft 26.3 的 GeckoLib 5.5.7
  • Java 25
  • Windows，用於目前的共享記憶體橋接實作

Better Combat 為選用。 若你想要其近戰動畫，請安裝與 Minecraft 26.3 及 Fabric Loader 0.19.5 相容的版本。沒有它，PzCraft 仍支援原版戰鬥。

這些版本描述的是發行組建。多人遊戲及其他遊戲/載入器版本尚未驗證。

安裝

  1. 在 Prism Launcher 中，建立一個含 Fabric 的 Minecraft 26.3 執行個體：在 New Instance 對話方塊中選擇版本 26.3，並在 Mod loader 下選擇 Fabric 0.19.5。若執行個體已存在，請開啟 Edit → Version → Install Loader 並選擇 Fabric。Version 分頁必須在 Minecraft 旁列出 Fabric Loader；只把模組 jar 放進 mods 資料夾並不夠，因為沒有載入器時 Minecraft 會以純原版啟動並忽略它們。
  2. 將 Fabric API 0.161.0+26.3 與適用於 Fabric/Minecraft 26.3 的 GeckoLib 5.5.7 加入該執行個體的 mods 資料夾。Better Combat 為選用。
  3. 將發行版本中的 Project-ZombCraft-Fabric-0.13.1.jar 複製到同一個 mods 資料夾。將 Prism 的 Java 執行階段保持設為 Java 25。
  4. 將 Project-ZombCraft-Zomboid-0.13.0.zip 解壓縮到你的 Project Zomboid 使用者 mods 資料夾。它應會建立 PzCraft/42/mod.info 與 PzCraft/42/media/java/PzCraft.jar。
  5. 在 Project Zomboid 模組清單中啟用 ZombieBuddy、Viewpoint 與 PzCraft。
  6. 啟動 Prism 執行個體，然後啟動 Project Zomboid 並載入單人世界。Minecraft 不需要點擊：在其標題畫面出現約一秒後，它會開啟自己的空白 pzcraft 世界並等待 Project Zomboid。若 PzCraft 嘗試啟動本機設定的 Minecraft 指令，請在 Zomboid/Lua/pzcraft.properties 中設定 autolaunch=false，並先從 Prism 啟動 Minecraft。
  7. 在 Viewpoint 的 3D 檢視中，按下 O 進入第一人稱並捕捉滑鼠。Minecraft 的 HUD 與 Steve 應會出現在 Project Zomboid 場景中。

此模組每次啟動時會將此執行個體的 Music 滑桿設為 0%，因此只會播放 Project Zomboid 的配樂；其他 Minecraft 音效不變。

Project Zomboid 結束後幾秒，Minecraft 會自行關閉並儲存其世界。若要讓它保持開啟，請將 -Dpzcraft.autoexit=false 加入該執行個體的 Java 引數。

若 Minecraft 當機或關閉，請從同一個 Prism 執行個體再次啟動它。載入完成後，返回 Project Zomboid 世界並重新進入 Viewpoint 的 3D 檢視以重新連接。若連結未恢復，請在 Minecraft 執行後重新載入單人世界。

疑難排解

Minecraft 開啟到其一般標題畫面，其他什麼都沒發生。 模組未載入。檢查 Prism 中執行個體的 Version 分頁：若只顯示 Minecraft 與 LWJGL，請依照步驟 1 安裝 Fabric Loader。可運作的啟動記錄會以 Loading Minecraft 26.3 with Fabric Loader 0.19.5 開頭，之後印出 Shared link open；若記錄顯示 Main class: net.minecraft.client.main.Main，則為原版啟動。

Minecraft 位於 pzcraft 世界中，但 Project Zomboid 未顯示 Steve。 檢查 ZombieBuddy、Viewpoint 與 PzCraft 是否皆已啟用、PzCraft 的 jar 是否已在 ZombieBuddy 的提示中核准，以及你是否處於 Viewpoint 的 3D 檢視中。Zomboid/console.txt 會在連結中斷時印出 waiting for Minecraft，並在連結建立後印出 Minecraft connected。

若要解除安裝，請從 Project Zomboid 的 mods 資料夾移除 PzCraft，並從 Prism 執行個體的 mods 資料夾移除其 Fabric jar。變更模組設定前，請保留或備份兩款遊戲的存檔。

控制

輸入 動作
W/A/S/D、Space、Shift、Ctrl 行走、跳躍、疾跑、潛行
滑鼠 環顧
滑鼠左鍵 採礦或近戰；發射支援的持有中 Project Zomboid 手槍
手持支援的手槍時按 R 從已裝填的原生彈匣重新裝填；適用時處理卡彈
滑鼠右鍵 互動、放置/使用方塊，或使用支援的手槍瞄準
1–9、滑鼠滾輪 選擇快捷欄欄位
E 開啟 Minecraft 物品欄
Q 丟棄選取物品
T 或 / 開啟 Minecraft 聊天或指令
F5 變更 Minecraft 攝影機視角

指令

指令 動作
/weather clear|rain|thunder [duration] Minecraft 的天氣指令；PZ 的天氣會跟隨（PZ 繪製天空）
/weather drizzle|showers|heavy|storm|tropical|blizzard|snow [duration] PZ 的天氣變化
/weather fog [0..1] PZ 霧密度，直到 /weather clear 或 /weather fog 0
/pzgive <item> [count] 給予 Steve 一個從 PZ 匯出的物品；可 Tab 補齊物品 ID

包含內容

  • fabric-mod/：Fabric 客戶端整合與 mixins
  • pz-mod/：Project Zomboid 模組原始碼與執行階段中介資料
  • protocol/：共享橋接協定原始碼
  • GitHub 發行資產：Fabric jar 與 Project Zomboid 模組 zip

此橋接目前涵蓋移動與地形碰撞、原生世界渲染、方塊、生存/HUD、互動、部分戰鬥、天氣/時間、實體與載具。這是進行中的專案；物品欄容量/溢出、合成、服裝外觀、數種槍械類型與部分邊緣情況仍未完成。M9 視覺模型/資產未隨附；M9 渲染需要另行取得相容資產與 GeckoLib。

計畫功能

  • 支援更多 Project Zomboid 槍械與武器類型。
  • 擴充 Project Zomboid 載具支援。
  • 整合兩款遊戲的更多物品，包括跨遊戲合成。
  • 新增多人遊戲支援。
  • 改善效能並最佳化橋接。

建置原始碼

此儲存庫包含模組原始碼與最小 Gradle 專案檔案。建置工具與開發者自動化已刻意省略。Project Zomboid 模組會依據玩家提供的本機 Project Zomboid 與 ZombieBuddy API 進行編譯；它不隨附這些 API。Fabric 組建使用 Minecraft/Fabric 相依項目，且選用 M9 程式碼可能需要本機 GeckoLib jar。已發行的版本 jar 即為可直接安裝的成品。

致謝

  • Viewpoint 與 ZombieBuddy，為 Project Zomboid 渲染/模組整合生態系。
  • Vic Point Blank，作為部分武器機制、模型與動畫行為的參考。
  • Fabric Loader、Fabric API、Prism Launcher 與 GeckoLib。
  • 開發協助：OpenAI Codex 與 Anthropic Claude。

Project ZombCraft 是獨立的社群專案，與 The Indie Stone、Mojang、Viewpoint、ZombieBuddy 或 Vic Point Blank 無隸屬關係。其名稱與資產仍為各自擁有者的財產。

授權

此儲存庫中的 Project ZombCraft 程式碼依 MIT License 授權。這不授予第三方遊戲檔案、模組、商標或資產的權利。

授權與來源聲明

原始 README 與翻譯沿用 MIT 授權；本次修改為繁中翻譯、連結與排版調整。可修改的 Markdown、原始 README、LICENSE 與 NOTICE 收錄於頂部文件包。原作遊戲內容與商標不因此獲得授權。

LICENSE

MIT License

Copyright (c) 2026 Lumi-nary

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.