[教學]安裝MCP(Minecraft Coder Pack) 3.1 開發套件@Java Eclipse

ringle

Eclipse 設定 MCP 目的：
在 Windows-based OS (XP, Win7 x32/x64)下，利用 Java Eclipse IDE 編程工具設定 MCP 套件，以開發 MineCraft MOD 擴充模組。

MCP 描述
MCP, Minecraft Coder Pack，係由一群熱愛 Mincraft 遊戲的 Hacker 高手所提供出專為其開發 MOD 擴充模組的 Java 編程套件。該套件的作用主要在於可將 Minecraft 軟件反組譯 (de-compile)為 Java 原始程式碼，以便於 MOD 開發人員撰寫模組，而可以覆載 (override)並擴展 (extend)遊戲的功能，豐富遊戲的內涵。

準備工具：
　o WinRar: http://www.rarlab.com/download.htm , 或 7zip: http://www.7-zip.org/ 。
　　Eclipse(本例使用 3.6 版): http://www.eclipse.org/downloads/

　o (Eclipse IDE for Java EE Developers will work fine)。

　o Minecraft server software: http://www.minecraft.net/download.jsp ,下載 "minecraft_server.jar" 。

　o Java JDK (本例使用 1.6.0 版本): http://www.oracle.com/technetwork/java/javase/downloads/index.html

　o MCP: <http://mcp.ocean-labs.de/index.php/MCP_Releases

安裝導引與步驟

1. 安裝 JDK 並確實設定 JRE 與 JDK 環境變數路徑 (Environment Variable Path)，可參考：http://www.java.com/en/download/help/path.xml

2. 下載 MCP (Minecraft Coder Pack)套件。目前使用版本為 3.1，相容於 Minecraft Beta 1.5_01 client and 1.5_02 server。

3. 將所下載的 mcp31.zip 解壓縮至 \MCPs\mcp31 目錄。後述步驟即以該起始目錄簡稱為 %mcp%。

4. 可先執行 %mcp% 目錄內 updatemcp.bat 將 MCP 套件作最新更新。

5. 將 "%APPDATA$\.minecraft" (遊戲安裝預設資料夾)內的 "bin" 與 "resources" 資料夾複製 (copy)至 %mcp%/jars 目錄下。
(P.S.  複製後位於  %mcp%\jars\bin\ 目錄下的 minecraft.jar，可將 ModLoader 壓縮檔內的所有檔案，均拖曳至 minecraft.jar 內，以方便爾後開發的 MOD 程式均能與 ModLoader 相容。

6. 將 "minecraft_server.jar" (從官方網站下載)複製至 %mcp%/jars 目錄下。

7. 執行  %mcp%\decompile.bat ，稍待，系統會花上一段時間執行反組譯工作。
(P.S. 若有安裝 ModLoader 則反組譯過程會顯示一些錯誤訊息，可以忽略之。)

8. 利用 7zip or WinRAR 開啟 %mcp%\jars\bin\minecraft.jar，將壓縮檔內所有檔案，除了 \net 資料夾與副檔名為 .class 不要解壓外，其它所有檔案均解壓拖曳至 %mcp%\src\minecraft 目錄下。

9. 將 %mcp%\conf\pathches 目錄內的 "Start.java" 與 "hy.java" 複製至  %mcp%\src\minecraft 目錄下。

10. 執行 eclipse，並將 workspace 設定至 %mcp%\src 目錄 ([File] → [Switch Workspace] → [Other...])。

11. 新增 Java 專案 ( [File] → [New] → [Java Project]  )，在 "Project Name" 欄位填入 "minecraft" 並按下 [FINISH] 按鍵。

12. 開啟 [Project] → [Properties] → [Java Build path]，切換至 [Libraries] Tab，點擊 [Add external jars] 按鍵，新增下列四個位於 %mcp%\jars\bin 目錄下的 .jar 檔：minecraft.jar, jinput.jar, lwjgl.jar, lwjgl_util.jar。

13. 在上一步驟的設定視窗下 ( [Java Build path] → [Libraries] )，個別展開 (expand)包括 jinput.jar, lwjgl.jar, lwjgl_util.jar 等三個檔案 (除了 minecraft.jar 不用外)，選擇 [Native Library] 並按下 [Edit] 按鍵，將其位置 (Location)設定為 %mcp%\jars\bin\native。

14. 按下 [OK] 按鍵回至 eclipse 主畫面後，開啟 [Run] → [Run Configurations...]，在出現的對話框左側的列表下，選擇並雙擊 (double click) "Java Application"，會再出現對話框。在 [Name] 欄位下可填入如 "MC_Config" 的執行名稱；在 [Main Class] 欄位的右側，按下 [Search...] 按鍵，選擇 "Start - (default package)"，按下 [Apply] 按鍵最後再按下 [Run] 按鍵，即可開啟 Minecraft 遊戲。



完成！ 至此即可以在 Java Eclipse IDE 開發環境下開發 Minecraft MOD 模組。至於程式撰寫指引，可參考 MCP Wiki 教學 (若有安裝 ModLoader，則亦須下載 Javadoc API 文件 參考撰寫介面規範 (interface)。