支持的版本
bedboo 支持從 1.26.42.1(2026 年 8 月 7 日)到 1.26.63.1(2026 年 11 月 6 日)的所有穩定版 Bedrock Dedicated Server(BDS),
共 11 個版本,分屬 4 個協議族。
協議族是 minecraft-data / bedrock-protocol 的基岩版版本鍵,例如 '1.26.51'。同一協議族的所有 BDS 版本使用相同的網絡協議,
並共用一套遊戲數據(@bedboo/bedrock-data 的 data/<协议族>/)。bot.version 就是協議族。版本表位於
packages/bedboo/lib/bedrock/versions.js(FAMILIES)。某個協議族同時有 FAMILIES 條目且 @bedboo/bedrock-data 提供其數據時,該
協議族即視為已測試:它會出現在 testedVersions 中,createBot 也會接受它。
版本矩陣
協議族(bot.version) |
協議 | BDS 版本(發佈日期) | BDS 默認 transport |
說明 |
|---|---|---|---|---|
'1.26.40' |
2168 | 1.26.42.1(2026-08-07)、1.26.43.1(2026-08-07)、1.26.44.3(2026-08-14) | raknet |
Bedrock 1.26.40 |
'1.26.45' |
2169 | 1.26.45.1(2026-08-28) | raknet |
Bedrock 1.26.45 |
'1.26.51'(默認) |
2193 | 1.26.50.5(2026-09-15)、1.26.51.1(2026-09-15)、1.26.52.3(2026-09-25) | nethernet |
Bedrock 1.26.51 |
'1.26.60' |
2225 | 1.26.60.6(2026-10-27)、1.26.61.1(2026-10-29)、1.26.62.1(2026-11-04)、1.26.63.1(2026-11-06) | nethernet |
Bedrock 1.26.60 |
在把一個協議族標記為已測試之前,表中的每個 BDS 版本都以原生方式啟動,並由一個機器人實際加入。機器人檢查了出生、方塊與物品、物品欄、 聊天、行走、挖掘與放置、實體以及命令樹。CI 對每個協議族各運行一次單元測試。本參考的其餘部分(基岩版差異 和 BDS 備忘)是在默認版本 BDS 1.26.51.1 上觀察得出的。各協議族頁面列出了該協議族的不同之處。
不支持預覽版、測試版以及早於 1.26.42.1 的版本。不在表中的 BDS 版本也可能使用這些協議之一,但 bedboo 未針對它做過檢查。
選擇版本
把服務器的版本傳給 createBot。協議族和具體的 BDS 版本都可以,兩者得到的機器人相同:
const bot = bedboo.createBot({
host: '127.0.0.1',
port: 19132,
username: 'Bot',
version: '1.26.62.1', // 或 '1.26.60'
transport: 'nethernet' // BDS 1.26.51 及更新版本默认 transport=nethernet
})
bot.once('spawn', () => console.log(bot.version, bot.protocolVersion)) // 1.26.60 2225- 默認值: 不傳
version,或傳version: false時,機器人使用 1.26.51。bedboo 不會檢測服務器的版本(默認不 ping 就直接加入, 因為關閉局域網可見性的 BDS 不響應 ping)。連接其他協議族的服務器時必須指定版本。 - 可接受的值:
testedVersions中的協議族、它的任一 BDS 版本,或者帶bedrock_前綴的上述兩種寫法。其他任何值都會像 mineflayer 遇到不支持的版本時一樣拋出Error,其code為'ERR_BEDBOO_VERSION',消息中列出支持的協議族和 BDS 版本。 - 協議族不匹配: BDS 會拒絕其他協議的登錄,機器人以客戶端版本過舊或服務器版本過舊為由被
kicked。 - 隨版本變化的內容:
bot.version(協議族)、bot.protocolVersion、bot.majorVersion('1.26')、bot.registry(minecraft-data 的bedrock_<协议族>加上該協議族的@bedboo/bedrock-data補充層)和bot.supportFeature(...)。 特性表按協議族取值,例如 1.26.60 上的actionPacketsHaveHand以及defaultTransportIsNethernet。 - 模塊導出:
testedVersions按從舊到新的順序列出已測試的協議族(['1.26.40', '1.26.45', '1.26.51', '1.26.60'])。oldestSupportedVersion為'1.26.40',latestSupportedVersion為'1.26.60'。supportFeature(feature, version)接受協議族、BDS 版本或不傳版本(1.26.51)。
各協議族之間的差異在於少量新增的方塊、物品和實體,部分數據包字段,命令參數類型的編號,以及默認傳輸層。bedboo 按協議族處理這些差異, 機器人的代碼無需改動。各協議族頁面列出了具體差異。
針對某個版本測試
單元測試默認使用 1.26.51。BEDBOO_VERSION 可以選擇其他協議族或 BDS 版本:
pnpm test # 1.26.51
BEDBOO_VERSION=1.26.60 pnpm test # 协议族
BEDBOO_VERSION=1.26.44.3 pnpm test # BDS 版本,映射到其协议族(1.26.40)模擬對象、序列化器、註冊表和數據包錄製(packages/bedboo/test/fixtures/<协议族>/)都隨所選版本切換。需要該協議族尚無的錄製的
測試會被跳過,並打印原因。目前只有 1.26.51 有加入過程的錄製,因此在其他協議族上,加入回放測試會被跳過;這部分改由每個 BDS 版本的
實機加入來覆蓋。CI(.github/workflows/ci.yml)在其 bedrock 矩陣中為每個協議族各運行一次 lint、單元測試和類型檢查。手動運行該
工作流時可以傳入 version 參數。
添加版本
添加 BDS 版本或協議族屬於維護者工作:步驟(bedrock-data 固定版本、探測與生成、FAMILIES 條目、CI 矩陣、這些頁面)見
CONTRIBUTING.md(英文)。