Inner Core Tool Chain開發環境設定教學

InnerCore的作者有在Github上釋出Inner Core Tool Chain工具，方便開發者在Windows上「高效率」地開發Inner Core Minecraft模組。

什麼是InnerCore？

本文介紹如何透過這個工具撰寫和打包JavaScript的InnerCore模組，需要打大量指令。

1. 前置作業
#

需要的工具：

Inner Core Tool Chain ( Github)
Git for Windows
Python 3
Node JS
ADB (Platform Tools)
VS Code
Horizon啟動器
Windows 10以上電腦
Android手機，開啟ADB除錯模式

如果要開發C++原生模組，還要用到JDK、NDK，暫且不提。

這個工具只能在Windows執行，不過將bat檔自行改寫成shell也是能在Linux上執行，因為大部分操作還是依賴python完成。

VS Code能在編輯程式時顯示每個函數的定義，或者按Ctrl+Shift+B來執行專案資料夾裡的bat檔。

Windows 10如何用指令執行bat檔：開啟Powershell，cd切換到bat檔所在的資料夾，輸入.bat檔名，例如：./build-scripts-and-resources.bat

2. 設定專案
#

複製儲存庫

git clone https://github.com/zheka2304/innercore-mod-toolchain

cd innercore-mod-toolchain

建立一個InnerCore專案

python ./toolchain-setup.py mymod

之後終端機會詢問一些問題，可照填：

Enter your pack directory name [Inner_Core]: mymod （資料夾名稱）

Enter project name: My Mod （專案名稱）

Enter Author Name: Ivon （作者）

Enter Project Version: 1.0 （版本）

Enter Project Description: A test mod. （說明）

Do you want to initialize a new native directory? [y/N]: N

Do you want to initialize a new java directory? [y/N]: N

Do you want to clean up the project? [Y/n]: y

接著就會建立一個叫做mymod的資料夾，這就是專案的根目錄。
切換至專案目錄mymod

cd mymod

初始化專案

npm init -y

安裝Typescript

npm install tsc

npm install typescript

執行toolchains目錄下的bat檔，下載InnerCore的TypeScript定義，這樣輸入函數時就會顯示相關用法：

./download-declartions.bat

這樣"mymod"根目錄下應該有這些東西了：

mymod
├── make.json
├── package.json
├── src/
└── toolchain/

4. 開始撰寫主程式
#

開啟VS Code，檔案 → 開啟資料夾 → 開啟專案mymod根目錄。

打包時，腳本會按照根目錄的make.json所設定的來建構檔案。剛剛在創建專案時，已經輸入好開發所需的資訊了，因此make.json裡global的info欄位已填入模組的基本資訊:

{
   "global":{
      "info":{
         "name":"My Mod",
         "author":"Ivon",
         "version":"1.0",
         "description":"A test mod."
      },
      "api":"CoreEngine"
   },
   "make":{
      "debugAbi":"armeabi-v7a",
      "abis":[
         "armeabi-v7a",
         "x86"
      ],
      "linkNative":[
         "minecraftpe",
         "innercore",
         "nativejs"
      ],
      "excludeFromRelease":[
         
      ],
      "pushTo":"storage/emulated/0/games/horizon/packs/mymod/innercore/mods/mymod",
      "ndkPath":null
   },
   "resources":[
      {
         "path":"src/assets/res",
         "type":"resource_directory"
      },
      {
         "path":"src/assets/gui",
         "type":"gui"
      },
      {
         "path":"src/assets/resource_packs/*",
         "type":"minecraft_resource_pack"
      },
      {
         "path":"src/assets/behavior_packs/*",
         "type":"minecraft_behavior_pack"
      }
   ],
   "sources":[
      {
         "source":"src/dev",
         "target":"main.js",
         "type":"main",
         "language":"typescript"
      },
      {
         "source":"src/launcher.js",
         "type":"launcher",
         "language":"javascript"
      },
      {
         "source":"src/lib/*",
         "type":"library",
         "language":"javascript"
      },
      {
         "source":"src/preloader/*",
         "type":"preloader",
         "language":"javascript"
      }
   ],
   "compile":[
      {
         "source":"src/native/*",
         "type":"native"
      },
      {
         "source":"src/java/*",
         "type":"java"
      }
   ],
   "additional":[
      {
         "source":"src/assets/root/*",
         "targetDir":"."
      }
   ]
}

resources:[]代表這個專案，相關紋理的儲存位置。

sources:[]代表這個專案包含的JS，維持預設。

pushTo屬性代表的是輸出到手機的目錄。手機Horizon儲存模組的位置通常位於內部儲存空間/games/horizon/packs/Inner_Core/innercore/mods。

excludeDirectories，打包輸出時要排除的目錄。

在目錄src/dev/下新增一個main.ts，這是模組主程式。

建議使用TypeScript (ESNext標準）撰寫，再編譯成JS，因為InnerCore的JS是ES5標準。

main.ts輸入以下內容，這樣會在玩家進入Minecraft世界後顯示"Hello World!“的訊息：

Callback.addCallback("LevelDisplayed", function () {
        Game.message("Hello World!");
});

把src/icon.png移動到src/assets/root/，改名mod_icon.png，這是模組的縮圖。
在src/assets/root/新增config.json

裡面輸入：

{
  "enabled":true
}

這樣可讓玩家在Horizon中任意啟用或停用模組。

如果要新增物品/方塊，紋理貼圖應放在src/assets/res資料夾。

到此為止，根目錄/src下應該有這些檔案：

mymod/src
├── assets
│   ├── behavior_packs
│   ├── gui
│   ├── res
│   │   ├── items-opaque
│   │   └── terran-atlas
│   ├── resource_packs
│   └── root
│       ├── config.json
│       └── mod_icon.png
├── dev
│   ├── header.js
│   ├── main.ts
│   └── tsconfig.json
├── launcher.js
├── lib
├── native
└── preloader