教學:開發模組API/開始之前

開始之前

系列教學

所屬系列

模組API

難易度

初級

前置知識

• Python
• 附加包

實踐裝置

編輯、除錯、打包與作品上傳 ►►

概述

在正式開始之前，您需要做一些準備工作。儘管其中某些事項不是必要的（用「*」標出），但是滿足所有要求將會大大提升您的開發舒適程度與速度。

基礎環境準備

因為網易並沒有為手機端提供可以實時測試腳本的工具，所以建議使用電腦進行腳本的編寫和測試。

• 組態要求：
  • 一台電腦
  • 記憶體：4GB+ RAM
  • 文字編輯器： VSCode 或 PyCharm *
  • 系統：windows 7 及以上
  • 可用儲存空間：2GB+
• 至少了解 Python (2.7版本)中的以下內容（教學在此檢視）：
  • 資料型別和變數
  • 條件判斷和循環
  • 使用dict
  • 呼叫函式
  • 定義函式
  • 函式的參數
  • 使用模組（module）
  • 類和範例
• 擁有網易開發人員賬號和我的世界開發工作枱

基本結構

模組API是以腳本形式置於行為包中的。其結構相對Mojang的腳本引擎而言較為鬆散，其從行為包根目錄開始的最簡結構如下：

•  behavior_packs_xxx：行為包
  •  entities
  •  xxxScripts：腳本資料夾
    •  __init__.py：腳本資料夾標記檔案
    •  modmain.py：系統註冊檔案
    • ...
  • ...
  •  manifest.json

其中「xxxScripts」資料夾的名稱不限定，可為任何不包含中文及標點符號的名稱。建議在取名時加入特色因素以防出現可能存在的衝突

網易的腳本系統在識別腳本時，並不會根據資料夾的名稱，而是根據資料夾下的 __init__.py 檔案進行識別。故在每個放有腳本檔案的資料夾下（包含腳本資料夾下的子資料夾）都需要放置一個名稱為 __init__.py 的檔案，否則該資料夾下的腳本便無法識別。該檔案內什麼都不需要寫，只起到一個辨別的作用。

編輯、除錯、打包與作品上傳 >