跳到正文
bedboo

LeviMC · Docs

bedboo 用 mineflayer API 編寫基岩版機器人

兼容 mineflayer API 的 Minecraft 基岩版機器人庫。你的 mineflayer 機器人及其插件無需修改即可加入基岩版專用服務器(BDS)。

bedboo 是一個兼容 mineflayer API 的 Minecraft 基岩版機器人庫。它提供與 mineflayer 4.39.0 相同的 createBot()、相同的 bot.* 屬性、方法和事件、 相同的 TypeScript 類型以及相同的插件系統,但它通過 bedrock-protocol 與基岩版專用服務器(BDS)通信。為 mineflayer 編寫的機器人代碼,包括 mineflayer-pathfinder 等生態插件,都可以直接在 BDS 上運行。

js
const bedboo = require('bedboo') // 替代 require('mineflayer')

const bot = bedboo.createBot({ host: '127.0.0.1', port: 19132, username: 'Bot', auth: 'offline' })
bot.on('chat', (username, message) => {
  if (username !== bot.username) bot.chat(message)
})

從這裡開始

第一次用 bedboo?教程你的第一個 bedboo 機器人帶你 獲取代碼、準備服務器,並連接一個會走到你身邊的機器人。

給誰用

  • mineflayer 用戶:想讓自己的機器人和插件進入基岩版服務器;mineflayer 的文檔、示例和插件都可以原樣使用。
  • 服務器和模組作者:用腳本化的玩家測試 BDS(或 LeviLamina 服務器)。
  • 客戶端模組作者:通過 Be.D.D. 用同一套機器人代碼驅動真實的 Minecraft 客戶端。

為什麼

mineflayer 是用 JavaScript 編寫 Minecraft 機器人的常用方式,擁有龐大的插件生態,但它面向的是 Java 版。基岩版使用不同的協議、 不同的方塊和物品 ID、服務端權威的物品欄和方塊破壞,以及自己的一套移動物理,因此 Java 版機器人及其插件無法加入基岩版服務器。 bedboo 在不發明新 API 的前提下彌合了這一差距。

唯一的差異是 Java 版與基岩版之間的固有差異:基岩版的方塊和物品名稱、沒有隊伍、服務端權威的物品欄和方塊破壞等等。每一項都列在 基岩版差異中。

支持範圍

  • 服務器: 從 1.26.42.1(2026 年 8 月 7 日)到 1.26.63.1(2026 年 11 月 6 日)的所有穩定版 BDS,分屬 4 個協議族: 1.26.40(protocol 2168)、1.26.45(2169)、1.26.51(2193,默認)和 1.26.60(2225)。createBot({ version }) 接受協議族 或 BDS 版本;bot.version 為協議族。見支持的版本。
  • 傳輸層: 默認 RakNet;使用 transport: 'nethernet' 時為 NetherNet(BDS 的默認傳輸層) (連接服務器)。
  • 認證: auth: 'offline'(默認)用於 online-mode=false 的服務器,auth: 'microsoft' 用於 Xbox Live。
  • 真實客戶端: transport: 'bedd' 改為驅動由 Be.D.D. 託管的真實基岩版客戶端。
  • 運行時: Node.js 24 或更高版本。RakNet 需要 x64(raknet-native 只提供 x64 預編譯包);NetherNet 是純 JavaScript 實現。

在生態裡的位置

項目 作用
mineflayer bedboo 實現的 API,也是其插件的來源
Be.D.D. 託管真實的 Minecraft 基岩版客戶端,bedboo 用 transport: 'bedd' 驅動它(指南)
LeviLamina BDS 和客戶端的模組加載器:LeviLamina 服務器就是 BDS,bedboo 照常加入

構建方式

  • 使用 bedrock-protocol 建立連接(RakNet 基於 raknet-native,NetherNet 基於 node-nethernet),使用 prismarine-auth 登錄 Xbox Live;
  • prismarine-* 系列庫(block、chat、chunk、entity、item、nbt、recipe、registry、windows、world)和 minecraft-data,並以 @bedboo/bedrock-data 作為基岩版 數據補充層(每個協議族一份);
  • 一個從 prismarine-physics 分叉而來的基岩版移動引擎;
  • mineflayer 自身的插件,每個插件對應一個改編文件,各自保留原有的署名頭。

對這些依賴的小修復以 pnpm 補丁的形式放在倉庫的 patches/ 目錄中,因此目前需要在 bedboo 的 monorepo 中使用它 (教程裡有做法)。

包

包
bedboo 庫本體
@bedboo/bedrock-data minecraft-data 的基岩版數據補充層,每個支持的協議族一份
@bedboo/agent 基於 bedboo 的腳本化生存智能體(生存智能體)

名字

bedboo(Bedrock + Bangboo)得名自《絕區零》的邦布:邦布替繩匠深入空洞,你的機器人替你進入基岩版服務器。