跳到正文
本頁目錄

bedboo 的工作方式

bedboo 就是去掉了 Java 部分、換上了基岩版部分的 mineflayer。機器人看到的 API 是 mineflayer 的;在它之下,連接、遊戲數據、 實現 bot.* 的插件和物理引擎都是基岩版的。本頁介紹這些層次,以及機器人的一次調用如何穿過它們。每一層與 Java 版有何不同, 逐條列在基岩版差異中。

層次

text
你的脚本、生态插件(pathfinder、pvp……)
        │  mineflayer API:createBot()、bot.*、事件
        ▼
bedboo 的插件(每个 mineflayer 插件一个文件)  ── bot.registry(minecraft-data + @bedboo/bedrock-data)
        │  基岩版数据包                          ── bot._bedrock(输入队列、生命周期、item stack request……)
        ▼
bot._client
        ├── 基于 RakNet 的 bedrock-protocol(raknet-native)     transport: 'raknet',默认 ──┐
        ├── 基于 NetherNet 的 bedrock-protocol(node-nethernet) transport: 'nethernet' ─────┤
        └── 由 Be.D.D. 托管的真实客户端                          transport: 'bedd' ──────────┤
                                                                                             ▼
                                                                                  基岩版专用服务器(BDS)

createBot 與插件

createBot() 是改編過的 mineflayer 加載器(lib/loader.js):選項相同、插件的選擇方式相同、事件順序相同,只是用 bedrock-protocol 客戶端代替了 minecraft-protocol。bot.loadPlugin() 就是 mineflayer 自己的插件加載器,所以生態插件無需修改 即可加載。

內部插件構成了 bot.*。mineflayer 4.39.0 的每個插件名(共 41 個:blocks、chat、digging、entities、inventory、 physics……)在 bedboo 中都有一個對應文件,另外還有 abilities(來自 mineflayer 的 master 分支)和 sign(編輯告示牌,從 blocks 中拆出)。每個文件都改編自 mineflayer 的同名文件並保留其署名頭:參數檢查、返回值、錯誤消息和事件仍然是 mineflayer 的,Java 數據包換成了基岩版數據包。因此 options.plugins 和 loadInternalPlugins 按與 mineflayer 相同的名字選擇插件。

連接

bedboo 通過 bedrock-protocol 連接,由它處理登錄、加密和各版本的數據包格式。 transport 選項決定由什麼來承載數據包:

  • RakNet('raknet',默認),基於 raknet-native。BDS 需要以 transport=raknet 運行。
  • NetherNet('nethernet'),基於 node-nethernet:WebRTC 數據通道, 從 1.26.51 起是 BDS 的默認傳輸層。信令默認通過服務器端口上的 HTTP 進行。
  • 真實客戶端('bedd'):bedboo 自己不建立到服務器的連接。一個由 Be.D.D. 託管的 Minecraft 客戶端已經在世界中;bedboo 讀取它收發的每個數據包,並把自己本來要發送的內容轉換為對該客戶端的控制請求 (工作方式)。

三種方式下機器人的 API 完全相同。如何選擇和配置:連接服務器。

版本與遊戲數據

基岩版的版本按協議族分組:同一協議族的所有 BDS 版本使用相同的網絡協議,共享一套遊戲數據。bedboo 支持 4 個協議族: 1.26.40、1.26.45、1.26.51(默認)和 1.26.60;bot.version 為協議族(支持的版本)。 bedboo 不會探測服務器的版本:面向其他協議族的機器人需要在 createBot({ version }) 中指明。

遊戲數據(方塊、方塊狀態、物品、實體、效果、生物群系、碰撞箱、食物……)來自 minecraft-data,並由 @bedboo/bedrock-data 補充:每個協議族一個 data/<协议族>/ 目錄,其中的數據集替換 minecraft-data 中 bedrock_<协议族> 的對應數據集。這個補充層是 require('bedboo') 做的第一件事,早於 bedrock-protocol 或任何 prismarine 庫讀取基岩版數據。bedboo 還讓 require('minecraft-data')(bot.version) 返回基岩版數據,正如 mineflayer 文檔所承諾的,這樣 prismarine-physics 的 PlayerState 之類的代碼才能工作。

bot.registry 在收到第一個數據包之前就由這些數據構建好,再由服務器補全:start_game 提供方塊的運行時 ID(在 BDS 上是方塊 狀態的哈希),item_registry 提供物品的網絡 ID。因此名稱和 ID 都是基岩版的(wooden_door、lit_furnace……):見 名稱、ID 與數據。

基岩版狀態

基岩版需要一些 Java 版沒有、且由多個插件共享的狀態。它們放在 bot._bedrock 中(內部使用,可能變化):

  • input:tick 時鐘和 player_auth_input 隊列,機器人每個 tick 發送這個數據包(服務端權威);
  • lifecycle:加入、重生和維度切換,是唯一發出 spawn 的地方;
  • stackRequests 和 windows:item stack request,以及映射到 Java 窗口類型的基岩版容器;
  • ids:實體的運行時 ID 和唯一 ID、物品的網絡 ID。

機器人在基岩版上可能需要、而 mineflayer 沒有對應成員的東西,公開在 bot.bedrock 下(遊戲規則、方塊變體、物品欄重新同步、 BeDD 的能力),絕不會作為新的頂層 bot 成員出現:見 API。

移動

physics 插件運行一個從 prismarine-physics 分叉而來的移動引擎(lib/physics/)。它保留了模塊結構和 bot.physics 的字段名, 因此 mineflayer-pathfinder 可以用它模擬移動,但實現的是基岩版的移動規則(臺階高度、摩擦、跳躍、攀爬、液體……),並經過反覆 擬合,直到能復現服務器自身的模擬(移動與物理)。在基岩版上,服務器會檢查每一次 移動:見服務端權威。

依賴與補丁

對依賴(bedrock-protocol、node-nethernet、raknet-native、prismarine 系列庫)的少量修復,以及生態插件中的 Java 假設,都以 pnpm patch 的形式放在倉庫的 patches/ 目錄中。pnpm-workspace.yaml 中的 overrides 讓每個包都加載同一份打過補丁的副本。 這就是目前需要在 bedboo 的 monorepo 中使用它的原因(教程 裡有做法),也是生態插件在 monorepo 之外需要同樣補丁的原因(生態插件、 生態插件補丁)。

倉庫包含三個包:bedboo(庫本體)、@bedboo/bedrock-data(數據補充層)和 @bedboo/agent(基於 bedboo 的 生存智能體)。