模組SDK

From Minecraft基岩版开发Wiki

模組SDK(ModSDK)網易為拓展更多玩法在附加包基礎上修改而成的一套遊戲模組體系。模組SDK大致分為自訂遊戲內容模組API兩方面內容。
模組SDK與原版附加包的側重方向不同,原版更期望開發人員使用JSON開發更多內容,而網易則注重將JSON與模組API結合進行開發。
模組SDK支援目前基岩引擎版本號下幾乎全部的原版附加包介面,故兼併原生附加包的優點。
官方文件位址:
網易開發人員文件
目前模組SDK的最新版本為2.1(遊戲版本1.17.3
網易開發人員申請網站:創造者計劃
*註:現在從網易MC內部抽出的所有附加包全部經過加密,不可用於其他任何地方。

自訂遊戲內容[edit]

自訂遊戲內容是網易在附加包的基礎上對原有元件進行增添而形成的一套體系。格式語言為JSON
自訂遊戲內容支援目前遊戲版本號下幾乎全部原生附加包的JSON內容,並且有許多網易增添的新元件。所有網易特色元件(即前綴為netease:的元件)都無法在原版下使用。
目前版本(網易2.1)網易的自訂遊戲內容如下表:

  • 有部分增添:
  • 完全新增或與原版可用定義方式完全不同:
    • 自訂遠程武器
    • 自訂盾牌
    • 自訂狀態效果(需配合模組API使用)
    • 自訂維度(可配合模組API使用)
      • 自訂地形
    • 自訂UI(需配合模組API使用)
    • 自訂粒子效果(需配合實體使用)
    • 自訂附魔
    • 自訂書
    • 微縮方塊
    • 自訂實體行為(需配合模組API使用)

絕大部分自訂遊戲內容可用網易的我的世界開發人員編輯器進行編輯。

Python腳本開發(模組API)[edit]

Python腳本開發(模組API,又稱PyMod或ModAPI)是網易為了使開發人員在自訂遊戲內容的基礎上對遊戲內的各種因素進行更深化的客製化而開發的引擎。其用法和地位類似於原版的腳本引擎(ScriptEngine)。顧名思義,其格式語言為Python,修改範圍包含方塊、實體、維度、玩家、物品、UI、特效、模型等等區域,覆蓋面極廣,功能強大。哪怕是高級功能很少的附加包裡,使用模組API代替原版Player.json中的許多用法也可以避免與其他包衝突,使包的相容性大大提升。
模組API的工作方式與腳本引擎的工作方式有許多相似之處,分為伺服器端用戶端,基本處理流程為[監聽事件-#响应事件-回调函数-执行逻辑(调用组件)#-銷毀事件](其中##部分為循環部分)。當然,在這個流程中也存在着很大的操作空間,比如傳送自訂事件到不同系統,以及使用Python的所有原生支援功能等。實際遊戲中大部分高級功能都是由模組API實現的。
在實際遊戲中下載的附加包裡,Python腳本開發的使用內容儲存在行為包根目錄下的Script.mcp加密檔案中,以防被拆包。

Template:ModFormat