你的第一個 bedboo 機器人
完成本教程後,一個你用 JavaScript 編寫的機器人會加入你的基岩版服務器,在聊天欄打招呼,回應玩家說的話,並在你輸入 come 時走到你身邊。它基於 bedboo 構建,這是一個擁有 mineflayer API 的基岩版機器人庫:如果你寫過 mineflayer 機器人,機器人代碼完全相同。
大約需要半小時。
你需要準備
- 一個 1.26.42.1 到 1.26.63.1 之間的基岩版專用服務器(BDS),在你的電腦或局域網上。開你的第一個服務器中的服務器就可以;本教程使用
D:\servers\survival。 - Node.js 24 或更高版本和 Git。Windows、Linux 或 macOS 均可,但需要 x64 處理器(這裡使用的 RakNet 連接沒有 ARM 構建)。
- Minecraft 基岩版,用來在遊戲中和機器人對話。沒有它也可以完成第 1 到 5 步。
在終端中檢查 Node.js:
node -v你應該看到 v24 或更高版本。
1. 獲取 bedboo
bedboo 尚未發佈到 npm。它用 pnpm 補丁修復了幾個依賴,這些補丁只在它自己的工作區內生效,因此請在它的倉庫中使用它:
git clone https://github.com/LiteLDev/bedboo
cd bedboo
corepack enable
pnpm installcorepack enable 會提供倉庫要求的 pnpm 版本。你應該看到 pnpm 列出已安裝的包並順利結束,沒有錯誤。
找不到 corepack,或沒有權限
Node.js 25 及更新版本不再自帶 corepack:用 npm install -g corepack 安裝後,再運行一次 corepack enable。在 Windows 上,如果 Node.js 安裝在 C:\Program Files,請在以管理員身份打開的終端中運行一次 corepack enable。
2. 為機器人建一個包
你的機器人放在工作區的一個包裡,這樣它就有自己的依賴。
-
在倉庫中創建文件夾
packages/my-bot。 -
在其中創建
package.json:json{ "name": "my-bot", "private": true, "dependencies": { "bedboo": "workspace:*", "mineflayer-pathfinder": "2.4.5" } }bedboo來自工作區。mineflayer-pathfinder是 mineflayer 常用的尋路插件,在基岩版上無需修改即可使用。 -
在倉庫根目錄再次運行
pnpm install。你應該看到它添加了mineflayer-pathfinder。
3. 準備服務器
本教程中的機器人沒有 Xbox Live 賬號,並且通過 RakNet 連接。需要讓服務器知道這一點:
-
停止服務器。
-
打開服務器文件夾中的
server.properties,設置:propertiestransport=raknet online-mode=false allow-list=false server-port=19132設置 原因 transport=raknetBDS 1.26.51 及更新版本默認使用 NetherNet;除非另行指定,bedboo 通過 RakNet 連接。 online-mode=false使用 auth: 'offline'的機器人沒有 Xbox Live 身份。allow-list=false否則需要把機器人的名字加入 allowlist.json。 -
啟動服務器,等待
Server started.。記下服務器啟動時輸出的遊戲版本,例如1.26.60:機器人需要它。
離線服務器請保持私有
online-mode=false 時,任何人都能以任意名字加入。請把這樣的服務器留在自己的網絡中,或者保持 online-mode=true,並給機器人一個 Microsoft 賬號(auth: 'microsoft',見 API)。
Server started. 之後緊跟的 TRANSPORT TYPE ERROR … not set to NetherNet 一段是無害的:BDS 只是提醒原版客戶端將來可能需要 NetherNet,RakNet 客戶端可以正常連接。
4. 編寫機器人
創建 packages/my-bot/index.js:
const bedboo = require('bedboo') // 代替 require('mineflayer')
const { pathfinder, Movements, goals } = require('mineflayer-pathfinder')
const bot = bedboo.createBot({
host: process.argv[2] ?? '127.0.0.1',
port: parseInt(process.argv[3] ?? '19132'),
version: process.argv[4], // 服务器的游戏版本,例如 '1.26.60'
username: 'Bot',
auth: 'offline'
})
bot.loadPlugin(pathfinder)
bot.once('spawn', () => {
console.log(`spawned at ${bot.entity.position} in ${bot.game.dimension} (${bot.game.gameMode})`)
bot.chat('hello!')
})
bot.on('chat', async (username, message) => {
if (username === bot.username) return
if (message === 'come') {
const target = bot.players[username]?.entity
if (!target) return bot.chat("I can't see you")
bot.pathfinder.setMovements(new Movements(bot))
try {
await bot.pathfinder.goto(new goals.GoalNear(target.position.x, target.position.y, target.position.z, 1))
bot.chat('here!')
} catch (err) {
bot.chat(`I can't get there: ${err.message}`)
}
} else {
bot.chat(message) // 其他内容原样复述
}
})
bot.on('kicked', (reason) => console.log('kicked:', reason))
bot.on('error', (err) => console.log('error:', err))
bot.on('end', (reason) => console.log('disconnected:', reason))它做了什麼:
createBot連接服務器。version是服務器的遊戲版本;bedboo 接受精確的 BDS 構建(1.26.62.1)或其協議族(1.26.60)。不傳時,機器人使用 1.26.51。- 機器人進入世界後觸發
spawn;每條聊天消息都會觸發chat,並帶上發送者的名字。 bot.pathfinder.goto走到目標處,這裡是玩家一格範圍內。
方塊和物品使用基岩版的名字(grass_block、oak_log……);其餘都是 mineflayer 的 API。
5. 運行
在倉庫根目錄中,帶上你的服務器版本運行:
node packages/my-bot/index.js 127.0.0.1 19132 1.26.60幾秒內你應該在終端中看到 spawned at (…) in overworld (survival)。在服務器中輸入 list:你應該看到 There are 1/10 players online: 和 Bot。
按 Ctrl+C 斷開機器人。
6. 和它對話
- 再次啟動機器人,並從 Minecraft 加入服務器(在同一臺電腦上:地址
127.0.0.1,端口19132)。 - 在聊天欄隨便輸入些什麼:機器人會複述。
- 輸入
come:機器人會走到你身邊並說here!。
要讓機器人用 bot.chat('/time set day') 執行命令,請在 server.properties 中設置 allow-cheats=true,並在服務器控制台把它設為管理員:op Bot。
機器人進不來
| 現象 | 原因 |
|---|---|
Connect timed out |
主機或端口錯誤、服務器的 transport 不是 raknet,或防火牆丟棄了 UDP。 |
加入後立即 kicked |
allow-list=true 但機器人不在 allowlist.json 中,或 online-mode=true。原因會說明是哪一種。 |
| 以客戶端或服務器版本過舊為由被踢出 | 你傳入的 version 與服務器不一致。 |
| RakNet 後端加載失敗 | 不是 x64,或者依賴是在 bedboo 工作區之外安裝的。 |
你現在有了什麼
- 本地工作區中的 bedboo,以及作為其中一個包的你的機器人。
- 一個機器人可以加入的服務器,以及一個會聊天、會用尋路插件走路的機器人。
下一步
- 基岩版上的其他 mineflayer 插件:pvp、採集方塊等:生態插件。
createBot的所有選項和基岩版擴展,包括 NetherNet 和 Microsoft 賬號:API。- 與 Java 版機器人的不同之處:Bedrock 差異。
- 支持的服務器版本:支持的版本。
- 一個現成的生存模式機器人:生存智能體。
- BDS 對機器人的行為:BDS 備忘。
- 驅動真實的遊戲客戶端,而不是協議機器人:用 Be.D.D. 驅動遊戲客戶端。
- bedboo 是什麼、如何構建:bedboo。