bedboo 的工作方式
bedboo 就是去掉了 Java 部分、換上了基岩版部分的 mineflayer。機器人看到的 API 是 mineflayer 的;在它之下,連接、遊戲數據、
實現 bot.* 的插件和物理引擎都是基岩版的。本頁介紹這些層次,以及機器人的一次調用如何穿過它們。每一層與 Java 版有何不同,
逐條列在基岩版差異中。
層次
你的脚本、生态插件(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 的
生存智能體)。