Minecraft模組開發入門：用MCP-Reborn反編譯游戲源碼

想給《我的世界》寫模組，第一步就卡住：游戲源碼從哪來？官方從不公開代碼，模組開發者怎么“看透”游戲內部的？

答案是反編譯。老牌工具MCP（Mod Coder Pack）最高只支持到1.12版本，新版游戲怎么辦？這次我們直接上手MCP-Reborn，一個能反編譯Minecraft 1.15.1等新版的開源工具鏈。跟著走，你不僅能拿到可讀的游戲源碼，還能理解這套逆向流程如何為AI Agent開發提供底層思路——解構復雜系統的能力，正是構建智能體的基礎。

為什么是MCP-Reborn？它解決了什么問題

MCP是Minecraft模組社區的基石，它通過反編譯、反混淆、重命名，將游戲晦澀的字節碼轉換成近乎可讀的Java源碼。但自Minecraft 1.13起，游戲的構建系統和混淆映射表發生了重大變化，官方MCP停止更新，社區維護的MCP-Reborn應運而生。

核心價值：它讓模組開發者（和研究者）能夠：

1. 查看新版游戲邏輯：理解生物AI、世界生成、網絡協議等內部實現。
2. 開發新版模組：這是Forge等模組加載器的底層依賴。
3. 學習逆向工程：掌握一套完整的Java程序反編譯、調試、分析流程。
4. 為AI Agent提供“環境理解”：如果你想訓練AI來自動化游戲（比如自動建造、戰斗），理解游戲源碼是設計有效Agent的第一步。

實戰：在Ubuntu 20.04上配置并運行MCP-Reborn

我們以反編譯 Minecraft 1.15.1 為例。整個過程分為四步：環境準備、獲取工具、配置、執行反編譯。

第一步：準備Java環境

MCP-Reborn是Java項目，需要JDK。Ubuntu 20.04默認倉庫的OpenJDK 11即可。

# 更新包列表
sudo apt update
# 安裝OpenJDK 11
sudo apt install openjdk-11-jdk
# 驗證安裝
java -version

你應該能看到類似 openjdk version "11.0.xx" 的輸出。

第二步：獲取MCP-Reborn

從GitHub克隆官方倉庫。我們使用一個穩定版本的分支。

# 克隆倉庫
git clone https://github.com/Hexeption/MCP-Reborn.git
cd MCP-Reborn
# 切換到支持1.15.1的穩定分支（請以倉庫實際分支為準）
git checkout 1.15.1

第三步：配置與下載

MCP-Reborn需要一份干凈的Minecraft 1.15.1客戶端JAR文件。你需要從官方啟動器獲取它。通常，它位于 ~/.minecraft/versions/1.15.1/1.15.1.jar。

接下來，配置MCP-Reborn。主要配置文件是 build.gradle 和項目根目錄下的 conf/ 文件夾。你需要做兩件事：

1. 設置游戲JAR路徑：在 build.gradle 中，找到或添加配置，指向你本地的 1.15.1.jar。
2. 準備混淆映射表（Mappings）：這是反混淆的關鍵。MCP-Reborn使用社區維護的映射表。你需要將對應的映射文件（通常是 .csv 或 .tsrg 格式）放入 conf/ 目錄的相應位置。從MCP-Reborn的GitHub發布頁或相關社區論壇可以獲取適用于1.15.1的映射表。

第四步：執行反編譯

配置完成后，使用Gradle（項目自帶Gradle Wrapper）執行反編譯任務。

# 在項目根目錄下運行（確保有執行權限）
./gradlew setupDecompWorkspace

這個命令會做一系列事情：

1. 下載依賴項（如反編譯器 FernFlower）。
2. 應用混淆映射表，將混淆名（如 func_70020_e）替換為有意義的名稱（如 getMotion）。
3. 反編譯JAR文件，生成 .java 源碼文件。
4. 設置一個可用于開發的、包含反編譯后源碼的環境。

過程可能需要幾分鐘到十幾分鐘，取決于你的網速和機器性能。 完成后，生成的源碼通常位于 projects/src/ 或類似目錄下。

拿到源碼后能做什么？三個實際應用場景

反編譯不是終點，而是起點。拿到可讀的游戲源碼后，你可以：

1. 開發一個簡單的游戲模組（以修改生物行為為例）

假設你想讓所有僵尸在白天不燃燒。在反編譯的源碼中，找到 ZombieEntity.java 或類似的類。搜索 burn、sun 等關鍵詞，定位到控制燃燒的邏輯方法。修改該方法的返回值或條件判斷，然后重新編譯打包成模組。商業價值：在模組平臺（如CurseForge）上發布獨特功能的模組，可以獲得捐贈和流量。

2. 為游戲AI Agent提供環境狀態解析

如果你在用AI玩《我的世界》，Agent需要知道“附近有幾只僵尸”、“它們的血量如何”。直接讀取游戲內存或日志不穩定。更好的方法是：基于反編譯的源碼，編寫一個輕量級服務端插件或客戶端模組，它能直接從游戲內部結構化地提取這些信息，并通過Socket或HTTP API實時發送給你的AI Agent。這比純圖像識別或日志解析可靠得多。

3. 學習并集成逆向工程到你的工具鏈

MCP-Reborn的流程（反編譯->反混淆->重命名->調試）是Java逆向的典型范式。掌握它，你就有能力分析其他閉源的Java應用。例如，分析某個自動化工具的內部通信協議，然后為你的AI Agent編寫一個兼容的客戶端。這本質上是工具集成能力的延伸。

核心流程復盤與下一步行動

我們回顧一下關鍵路徑：

1. 目標：獲取Minecraft新版可讀源碼。
2. 工具：MCP-Reborn（社區維護的MCP繼任者）。
3. 步驟：配Java -> 拉代碼 -> 放游戲JAR和映射表 -> 跑Gradle任務。
4. 產出：反編譯后的Java項目，可用于模組開發、AI環境集成或學習。

給你的可執行下一步：

1. 立即動手：找一臺Ubuntu機器（或虛擬機），嚴格按照上述步驟操作一遍，成功拿到 ZombieEntity.java。
2. 嘗試微小修改：在反編譯的源碼中，找到一個你感興趣的簡單方法（比如修改某種物品的堆疊數量），嘗試修改它并重新編譯。感受從“閱讀”到“修改”的完整循環。
3. 思考AI集成點：如果你正在開發游戲AI，畫一張圖：你的AI Agent決策模塊需要哪些游戲狀態？這些狀態能否從反編譯出的源碼中，通過一個插件最穩定地輸出？這就是你的技術方案雛形。

理解如何解構一個復雜系統，是你構建任何智能體——無論是游戲模組還是通用AI Agent——最底層的思維訓練。開始動手吧。