用 Be.D.D. 驅動遊戲客戶端
完成本教程後,Minecraft 基岩版會在你電腦的後臺運行,由你編寫的腳本驅動:腳本把最前面的界面讀成文字,截一張圖,然後再關掉遊戲。你完全不用碰遊戲窗口,同時還能照常使用鼠標和鍵盤。這正是 Be.D.D.(Bedrock Deep Dive)的用途:LeviLamina 客戶端模組的端到端測試,以及其他任何需要由程序控制真實遊戲客戶端的場景。
大約需要半小時,大部分時間在下載遊戲。
這是測試工具
mods\ 裡有 Be.D.D. 的遊戲不理會你真實的鼠標和鍵盤,只顯示在 Be.D.D. 的管理窗口裡。Be.D.D. 只裝進它自己的遊戲副本,從不裝進你玩的實例。
你需要準備
- 一臺 Windows 10 或 11 電腦(x64)。
- 一個擁有 Minecraft(Windows 版)的 Microsoft 賬號。
- LeviLauncher 1.1 或更高版本。如果還沒裝,請完成在 Windows 上玩模組的第 1、2 步。
- Node.js 24 或更高版本,用來運行腳本。用
node -v檢查。
不需要 PowerShell 模塊、lip 或 .NET 運行時。
1. 安裝基礎實例
Be.D.D. 0.4 驅動的是裝有 LeviLamina 26.60.x 的 Minecraft 1.26.60(GDK 正式版)。它會複製 LeviLauncher 中的這個實例,從不修改或啟動原實例,原實例稱為基礎實例。
在終端中運行 LeviLauncher 的命令行(如果 LeviLauncher.exe 不在 PATH 中,請使用它的完整路徑):
LeviLauncher.exe account login # 每台电脑一次:登录拥有 Minecraft 的账号
LeviLauncher.exe install 1.26.60 --loader # 1.26.60 GDK 正式版,带 LeviLamina
LeviLauncher.exe instance list # 检查结果你應該在列表中看到一個遊戲版本為 1.26.60.xx、加載器為 26.60.x 的實例。
如果你更喜歡 LeviLauncher 的窗口界面,也可以按在 Windows 上玩模組的第 3 步,在界面中添加帶 LeviLamina 的 1.26.60 版本,效果相同。
2. 安裝 Be.D.D.
-
從最新發布下載
bedd-windows-x64-setup.exe並運行。它不需要管理員權限:按用戶安裝到%LOCALAPPDATA%\Programs\BeDD,在開始菜單中添加 BeDD,並把該文件夾加入PATH。 -
打開一個新的終端並運行:
powershellBeDD.exe version你應該看到
Be.D.D. 0.4.0(或更新版本),以及它驅動的遊戲和 LeviLamina 版本。
不用安裝程序
同一發佈中的 bedd-windows-x64.zip 解壓到任何位置都能用:在其文件夾中運行 BeDD.exe。bedd-windows-x64.msi 可以用 msiexec /i bedd-windows-x64.msi /qn 靜默安裝,適合受管理的電腦和 CI。
3. 在後臺啟動遊戲
BeDD.exe launch --slot 1 --jsonlaunch 一次完成所有工作:
- 它為基礎實例創建一個克隆,命名為
<游戏版本>-<槽位>,例如1.26.60.05-1。克隆有自己的mods\、存檔、設置和日誌;遊戲文件是指向基礎實例的硬鏈接,幾乎不佔空間。 - 它把 Be.D.D. 模組裝進克隆。
- 它在後臺啟動遊戲,打開管理窗口,等遊戲準備好後輸出一行 JSON 並退出。遊戲繼續運行。
你應該看到類似這樣的一行:
{"pid":12345,"instance":"1.26.60.05-1","instanceDir":"…","url":"ws://127.0.0.1:53021/v1","token":"9f3c…","label":"…"}以及顯示著遊戲的管理窗口。腳本通過 url 和 token 與遊戲通信:每個遊戲在 127.0.0.1 上提供一個 WebSocket,令牌在每次啟動時都會更換。
BeDD.exe ps 隨時列出正在運行的遊戲。
4. 編寫你的第一個腳本
腳本每條消息發送一個 JSON 請求,例如 {"id": 1, "op": "ping"},遊戲處理完後回覆一條帶有相同 id 的消息。新建一個文件夾,在其中創建文件 hello-bedd.mjs:
import { execFileSync } from 'node:child_process';
import { writeFileSync } from 'node:fs';
// 找到游戏:`BeDD.exe ps --json` 列出每个运行中的游戏及其 url 和 token。
const games = JSON.parse(execFileSync('BeDD.exe', ['ps', '--json'], { encoding: 'utf8' }));
const game = games.find((g) => g.kind === 'client' && g.status === 'ready');
if (!game) throw new Error('No game runs: start one with BeDD.exe launch --slot 1');
// 连接,并用 call(op, fields) 发送请求:它会以回复作为结果。
const ws = new WebSocket(`${game.url}?token=${game.token}`);
const waiting = new Map();
let nextId = 1;
ws.onmessage = (event) => {
if (typeof event.data !== 'string') return; // 二进制帧是数据包,不是回复
const reply = JSON.parse(event.data);
waiting.get(reply.id)?.(reply);
waiting.delete(reply.id);
};
const call = (op, fields = {}) => new Promise((resolve, reject) => {
const id = nextId++;
waiting.set(id, (r) => (r.ok ? resolve(r) : reject(new Error(`${op}: ${r.error}`))));
ws.send(JSON.stringify({ id, op, ...fields }));
});
await new Promise((resolve, reject) => { ws.onopen = resolve; ws.onerror = reject; });
// 1. 这个游戏能做什么?
const ping = await call('ping');
console.log('instance:', game.instance, '| default mode:', ping.defaultMode);
// 2. 把最前面的界面读成文字。
const { view } = await call('ui');
console.log(view);
// 3. 截图。窗口隐藏时也能截。
const shot = await call('screenshot', { format: 'png' });
writeFileSync('screen.png', Buffer.from(shot.data, 'base64'));
console.log(`saved screen.png (${shot.width}x${shot.height})`);
ws.close();運行它:
node hello-bedd.mjs你應該看到實例名、default mode: bedboo,以及以文字表示的標題界面,大致如下:
screen start_screen
- button "Play" [e1]
- button "Settings" [e2]
- text "v26.60/LeviLamina-26.60.5"腳本旁邊還會出現文件 screen.png,內容是標題界面。控件後面的 [e1] 是它的 ref:call('ui', { action: 'click', ref: 'e1' }) 就會點擊 Play。
5. 停止遊戲
BeDD.exe stop 1.26.60.05-1請使用 launch 輸出的實例名。你應該看到 stopped 1.26.60.05-1 (pid …),遊戲也從管理窗口中消失。在管理窗口中關閉它也可以。
克隆會保留到下次:BeDD.exe launch --slot 1 幾秒內就能再次啟動它。--slot 2 會創建第二個克隆,讓兩個遊戲並排運行。
你現在有了什麼
- 已安裝的 Be.D.D.,以及一個在後臺運行的 Minecraft 1.26.60 克隆。
- 一個腳本,能找到運行中的遊戲,通過 WebSocket 與它通信,讀取界面並截圖。
下一步
- 該用哪種方式驅動遊戲以及原因:先用 bedboo 操作,再用 UI 樹,最後才模擬輸入:操作模式。
- 用 mineflayer 風格的機器人移動、轉視角、使用物品和戰鬥:你的第一個 bedboo 機器人,然後看 bedboo 的 驅動真實客戶端(BeDD)。
- 讀取和點擊菜單:UI 控件樹。每個請求及其字段:WebSocket 接口。
- 同時運行多個遊戲,以及管理窗口:多開。
- 讓客戶端與專用服務器一起測試:世界在哪裡運行。
- 模組的設置,例如窗口大小:配置。
- 遇到問題:常見問題。