跳到正文
本頁目錄

用 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 中,請使用它的完整路徑):

powershell
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.

  1. 從最新發布下載 bedd-windows-x64-setup.exe 並運行。它不需要管理員權限:按用戶安裝到 %LOCALAPPDATA%\Programs\BeDD,在開始菜單中添加 BeDD,並把該文件夾加入 PATH。

  2. 打開一個新的終端並運行:

    powershell
    BeDD.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. 在後臺啟動遊戲

powershell
BeDD.exe launch --slot 1 --json

launch 一次完成所有工作:

  1. 它為基礎實例創建一個克隆,命名為 <游戏版本>-<槽位>,例如 1.26.60.05-1。克隆有自己的 mods\、存檔、設置和日誌;遊戲文件是指向基礎實例的硬鏈接,幾乎不佔空間。
  2. 它把 Be.D.D. 模組裝進克隆。
  3. 它在後臺啟動遊戲,打開管理窗口,等遊戲準備好後輸出一行 JSON 並退出。遊戲繼續運行。

你應該看到類似這樣的一行:

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:

js
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();

運行它:

powershell
node hello-bedd.mjs

你應該看到實例名、default mode: bedboo,以及以文字表示的標題界面,大致如下:

text
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. 停止遊戲

powershell
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 與它通信,讀取界面並截圖。

下一步