跳到正文
本頁目錄

你的第一個 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:

shell
node -v

你應該看到 v24 或更高版本。

1. 獲取 bedboo

bedboo 尚未發佈到 npm。它用 pnpm 補丁修復了幾個依賴,這些補丁只在它自己的工作區內生效,因此請在它的倉庫中使用它:

shell
git clone https://github.com/LiteLDev/bedboo
cd bedboo
corepack enable
pnpm install

corepack enable 會提供倉庫要求的 pnpm 版本。你應該看到 pnpm 列出已安裝的包並順利結束,沒有錯誤。

找不到 corepack,或沒有權限

Node.js 25 及更新版本不再自帶 corepack:用 npm install -g corepack 安裝後,再運行一次 corepack enable。在 Windows 上,如果 Node.js 安裝在 C:\Program Files,請在以管理員身份打開的終端中運行一次 corepack enable。

2. 為機器人建一個包

你的機器人放在工作區的一個包裡,這樣它就有自己的依賴。

  1. 在倉庫中創建文件夾 packages/my-bot。

  2. 在其中創建 package.json:

    json
    {
      "name": "my-bot",
      "private": true,
      "dependencies": {
        "bedboo": "workspace:*",
        "mineflayer-pathfinder": "2.4.5"
      }
    }

    bedboo 來自工作區。mineflayer-pathfinder 是 mineflayer 常用的尋路插件,在基岩版上無需修改即可使用。

  3. 在倉庫根目錄再次運行 pnpm install。你應該看到它添加了 mineflayer-pathfinder。

3. 準備服務器

本教程中的機器人沒有 Xbox Live 賬號,並且通過 RakNet 連接。需要讓服務器知道這一點:

  1. 停止服務器。

  2. 打開服務器文件夾中的 server.properties,設置:

    properties
    transport=raknet
    online-mode=false
    allow-list=false
    server-port=19132
    設置 原因
    transport=raknet BDS 1.26.51 及更新版本默認使用 NetherNet;除非另行指定,bedboo 通過 RakNet 連接。
    online-mode=false 使用 auth: 'offline' 的機器人沒有 Xbox Live 身份。
    allow-list=false 否則需要把機器人的名字加入 allowlist.json。
  3. 啟動服務器,等待 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:

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. 運行

在倉庫根目錄中,帶上你的服務器版本運行:

shell
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. 和它對話

  1. 再次啟動機器人,並從 Minecraft 加入服務器(在同一臺電腦上:地址 127.0.0.1,端口 19132)。
  2. 在聊天欄隨便輸入些什麼:機器人會複述。
  3. 輸入 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,以及作為其中一個包的你的機器人。
  • 一個機器人可以加入的服務器,以及一個會聊天、會用尋路插件走路的機器人。

下一步