有人用 Rust 重寫了 Minecraft,還把 833 處行為差異一條條對完

Horizon 是把 Minecraft: Java Edition 26.3 用 Rust 重寫了一遍。一個壓縮檔,一個原生執行檔,不需要 Java。它讀得懂你現有的存檔,進得了原版伺服器,地形生成也跑同一套。
如果重寫遊戲是件常見嗜好,這段介紹就沒什麼稀奇。可惜不是。難的地方也不在算圖。Minecraft 的行為由一大堆歷年堆起來的特例定義,重寫要算正確,就得把這些特例一條條重現出來,包括那些從來沒人寫進文件的。
Horizon 對這個問題的處理方式,是這個倉庫值得任何人花一小時去看的原因。
移植台帳
專案裡有個叫 `port_ledger.py` 的工具,會讀原版 26.3 的每一個方法,逐一對照 Horizon 的程式碼。跑出來的結果是一個數字:還有多少原版行為,玩家感覺得到,而 Horizon 沒有。
按 README 目前的紀錄,找到 833 處,未關閉 0 處。分類列得很細:動物、怪物與頭目,實體與投射物,物品與附魔,方塊與紅石,世界生成與存檔,介面與 HUD,算圖與模型,伺服器端玩家處理,生物 AI 與突襲。每一類都掛了對應的 issue。
第二個工具 `parity_gaps.py` 負責盯這個數字往下走。Horizon 對「一致」的定義很窄:凡是已經被人指出來的差異,全都補上了。

那些 harness 到底比了什麼
接下來 README 做了件不太常見的事。它把自動化對比涵蓋了哪些東西做成一張表公布出來,每項打 0 到 1 分,並且講明,1 分代表這套 harness 涵蓋了該子系統而且跑得過,不代表除此之外沒有別的地方和原版不同。
視窗、輸入與主迴圈拿 1 分,意思是主迴圈、選項、攝影機、自動跳躍、切換疾走與潛行、影格上限全都對得上。資產與資源拿 1 分:196,290 個物品堆疊的模型一致,資源包介面在 3,000 多次工作階段裡測過。網路協定拿 1 分:進得了原版伺服器,專用伺服器的檔案、登入、設定、遊玩階段和指令樹都對得上,離線模式下測了 462 個區域網路探索案例。區塊儲存拿 1 分:用戶端和存檔用的調色盤容器,在 266 個情境裡與原版完全一致。區段網格化拿 1 分:112 個場景、超過一百萬塊四邊形,跟原版一模一樣。
最後這個數字值得停一下。一百萬塊四邊形算圖結果一致,就排除了「看起來差不多」的可能:那就是同一份幾何。
效能數字
跑分環境寫得夠細,能複製:Windows 11,Ryzen 7 9800X3D,RTX 5080,1280×720 視窗,關垂直同步,每個數字跑三次,取四個場景的平均值,括號裡是最慢的 1% 影格。
8 區塊視距下,Horizon 跑到 3,289 張影格每秒,最差影格 1,327。原版 26.3 是 2,437,最差 640。原版加 Sodium、Lithium、FerriteCore、ImmediatelyFast 是 2,375,最差 709。
16 區塊:2,074,對手是 1,661 和 1,586。32 區塊:1,207,對手是 1,031 和 879。
1% 低點那一欄更有意思。三個距離下,Horizon 最差的影格都大約比原版最差影格快一倍,這正好是「你感覺得到的頓」和「感覺不到」之間的距離。
載入時間同理。標題畫面 2.9 到 3.2 秒,原版 7.5 到 7.7 秒,裝模組的用戶端 10.8 到 11.1 秒。區塊載入快 2.9 到 3.8 倍。遊玩時工作集 1.1 到 1.7 GB,原版 1.9 到 2.9 GB。
現在這個版本裡有什麼
生存、創造、極限、旁觀四種模式。三個維度的原版地形生成。生物、村民、突襲、紅石、全部指令、HUD、配方書。1.8 到 26.2 的存檔打開就自動升級。
連線能進正版驗證模式的原版伺服器,也能開區域網路世界,還能用啟動器產生的邀請碼拉朋友進來。資源包、資料包、光影包都能載入。內容模組和原生 Rust 模組從啟動器安裝。伺服器可以在啟動器裡開,也可以在 VPS 上跑 `horizon-server`。
會改變原版觀感的畫質選項預設關閉,包括 1,024 區塊以外的遠景、HDR 和手把支援。
自己編一份
建置需要 Rust 1.90 或更新、Python 3.11 或更新、JDK 25,Linux 上還要 `libasound2-dev` 和 `libudev-dev`。
資源準備這一步是我沒料到的。`horizon-prepare` 會從你自己那份 Java Edition 26.3 裡建出遊戲資產,對著 `research-lock.json` 驗證,全程不下載任何東西。你需要在官方啟動器裡把 26.3 跑一次,再把工具指向你的 `.minecraft` 目錄,或者設 `HORIZON_MINECRAFT_DIR`。伺服器 jar 另外放。
git clone https://github.com/horizon-rust/horizon.git
cd horizon
cargo run --release -p horizon-prepare -- --prepare --server-jar ~/Downloads/server.jar
cargo run --release -p horizon-prepare -- sounds
cargo run --release -p horizon-client
送 PR 之前,貢獻者要跑 `python3 tools/pr_ready.py`,它會檢查格式、clippy、動到的 crate 的測試、Python 測試、公開目錄樹,以及受這次改動影響的原版 harness。README 裡寫明了不准提交遊戲檔案、反編譯原始碼和準備好的資源。
它為什麼不一樣
大型軟體的淨室重寫,通常只有兩種看點:更快,或者是個炫技。Horizon 兩樣都佔,但真正能帶走的東西是那套稽核結構。
大多數重寫栽在同一個地方。新版看起來對,然後在某個沒人測過的角落開始偏離,偏離再往下滾。Horizon 的做法是先把角落列清楚。台帳一個方法一個方法讀原版,產出一張有限清單。harness 再從外部證明每個子系統,數字都跟著:196,290 個物品堆疊,462 個區域網路案例,266 個存檔情境,112 個場景。
那些 0.75 或更低的分數才是實在的部分。只公布滿分的專案會顯得更好看,也會讓你少知道一些。把整張表放出來,你能看到測試沒摸到哪一塊,也能自己判斷:在 8 區塊視距、裝著你那套模組的情況下,這個 1 分到底值多少。
還有個治理層面的細節,README 寫得很隨意,其實不隨意。專案有議事會,有按主題分組並點名負責人的小組,有團隊和一套管理政策,全都寫在另一個檔案裡。一個幾百人參與的非官方遊戲重寫,總得有辦法決定誰的 PR 能合進去。這個專案在需要之前就把答案寫下來了,833 處差異能歸零,大概也跟這個有關。
MIT 授權,非官方,你得自己有遊戲。這三件事都在 README 第一段,本來就該在那裡。