跳到正文
本頁目錄

命令行

不帶參數(雙擊)運行 BeDD.exe 是管理窗口;帶參數就是這裡的命令行: BeDD.exe <名词> <动词> [参数] [选项]。BeDD.exe help、help <名词> 和 <命令> --help 離線輸出同樣的內容。

約定

選項 寫在命令詞之後任意位置:--name value、--name=value、-n value;開關 --name / --no-name;-- 之後不再是選項
名字 精確匹配,不分大小寫,從不按前綴匹配
時長 launch 的 --timeout、--lock-timeout:數字加 ms、s(默認)、m/min 或 h,如 90s、3m、2h;最多 30 天
stdout 只有結果
stderr 進度(-q 和 --json 時不輸出)、警告、-v 的細節
出錯 error: <信息>,然後 hint: <命令>;帶 --json 時 stdout 還會輸出 {"error":{code,message,exit,hint}}(code 如 ERR_USAGE)

所有命令都有的全局選項:

選項
--json 結果輸出為一個 JSON 文檔:列表是數組,其他是對象;鍵名 camelCase,時間 RFC 3339,大小以字節計
-q、--quiet 只輸出標識符,每行一個;不輸出進度
-v、--verbose 在 stderr 輸出執行細節
-h、--help 該命令的幫助

退出碼:0 成功,1 失敗,2 用法錯誤,4 找不到,5 衝突(如槽位正在使用),10 被拒絕。

遊戲

launch

BeDD.exe launch [<instance>](別名 play):在後臺啟動一個實例的遊戲,輸出它的端點。需要時先克隆實例,安裝或更新它的模組 (升級),打開管理窗口,並在遊戲整個生命期內持有信令鎖(規矩)。 用法:啟動遊戲。

選項 默認
--slot <n> 1 沒指定實例時,用這個槽位的克隆(基礎實例的克隆)
--dir <folder> 改為啟動這個目錄裡的實例(任意含 Minecraft.Windows.exe 的目錄)
--label <text> BEDD_LABEL,否則為調用方倉庫 遊戲在管理窗口裡的名字
--exclusive-signaling 獨佔整臺電腦:等其他遊戲全部關掉,並讓新啟動的遊戲等著
--no-manager 不啟動管理窗口
--keep-mod 保留克隆裡的 BeDD 模組,即使它和這個 BeDD.exe 帶的不同
--detach 進程一創建就返回;url 和 token 為 null
--timeout <时长> 3m 等待端點的時間
--lock-timeout <时长> 2h 等待信令鎖的時間
powershell
BeDD.exe launch --slot 3 --json
BeDD.exe launch --dir D:\games\mc-test --label smoke --detach -q

process list

BeDD.exe process list(別名 ps、process ls):正在運行、模組已公佈 WebSocket 端點(run\<pid>.json)的遊戲和服務器。 --json 輸出每個端點及其令牌:測試就是這樣找到要連接的地址(選哪個遊戲)。

選項
--all 也列出實例目錄下還沒有端點的遊戲(仍在加載,或模組較舊)

process stop

BeDD.exe process stop [<instance>](別名 stop):強制結束一個實例的遊戲(實例目錄下的文件夾名,或它的路徑)。實例目錄之外的 Minecraft 進程從不碰,除非 --pid 指定的進程公佈過 BeDD 端點。

選項
--pid <pid> 結束這個遊戲
--all 結束 BeDD 所有實例的遊戲
-y、--yes 結束全部遊戲前不詢問
powershell
BeDD.exe stop --pid 12345
BeDD.exe stop --all --yes

實例

克隆和目錄:安裝與克隆。接受 [<name>] 的命令也接受 --slot <n>(該槽位的克隆)。

命令
instance list(ls) BeDD 的遊戲實例(%LOCALAPPDATA%\BeDD\instances 下的克隆)以及各自還缺什麼。--bases:能用來克隆的 LeviLauncher 實例;--bases --all:也列出不能克隆的實例及原因
instance show [<name>] 一個實例以及它還缺什麼
instance clone 從 LeviLauncher 實例做出 <gameVersion>-<slot>(遊戲文件硬鏈接,資源通過目錄聯接,遊戲數據和 LeviLamina 複製;LeviLauncher 實例只讀),已有克隆則刷新。--slot <n>(1);--base <name>(否則 BEDD_INSTANCE,否則 LeviLauncher 的默認實例,否則第一個合適的);-f、--force:刪掉克隆重做,遊戲數據也重做
instance refresh [<name>] 讓克隆跟上它的 LeviLauncher 實例。--all:所有實例(有遊戲在運行的跳過)
instance remove [<name>](rm) 刪除一個實例;LeviLauncher 實例保持原樣。-y、--yes:不詢問
instance path <name> [dir|mods|logs|data|worlds] 輸出實例的一個目錄:dir(實例本身)、mods、logs、data(遊戲數據,Minecraft Bedrock)或 worlds(第一個玩家的 minecraftWorlds)

模組

配置項及取值:配置。

命令
mod install <instance> 把 BeDD.dll 和 manifest.json 複製到 <instance>\mods\BeDD,config\config.json 只寫入給出的設置,並把 LeviLamina 切換到內置崩潰記錄器。會替換之前的安裝,配置也一起替換。--from <dir>:要安裝的構建,之後的 launch 都以它為準,直到下一次不帶 --from 的安裝(否則 BEDD_MOD_DIR,否則 BeDD.exe 旁的 mod\BeDD,否則當前目錄所在檢出的 bin\BeDD)
mod uninstall <instance> 從實例裡移除模組
mod config <instance> 應用 --set、--unset 和 --world-mode 後輸出 mods\BeDD\config\config.json;遊戲啟動時讀取它。--unset <key>(可重複):恢復模組默認值

mod install 和 mod config 都接受:

選項
--set <key=value> 一項配置,可重複;值能解析為 JSON 就按 JSON,否則按文本
--world-mode <mode> ClientOnly、ClientServer 或 Remote(配置 mode;世界在哪裡運行)
--server-host <host> 配合 --world-mode Remote:遊戲要加入的服務器;*:join 指定的任何服務器

世界

BeDD.exe world singleplayer <instance> [<world folder>]:清除世界 level.dat(以及 level.dat_old)裡的多人遊戲和廣播設置, 讓共用同一登錄的遊戲不再互相踢掉("Blaze")。不寫世界目錄:實例的所有世界。在世界沒打開時運行。

選項 默認
--recent 只處理 level.dat 最近寫過的世界(剛恢復的測試世界)
--minutes <n> 15 --recent 指多少分鐘內

服務器

用於客戶端 + 服務端模式的專用服務器,放在 servers 目錄裡。

命令
server init <name> 準備服務器:通過 lip 安裝 BDS 和 LeviLamina、BeDD 的服務端模組、server.properties。沒缺東西時很快;再運行一次可更新模組或修改設置。--port <N>:IPv4 端口,IPv6 為 N+1(默認:服務器自己的,否則從 19140 起第一對空閒端口);--from <dir>:服務端模組(否則 BEDD_SERVER_MOD_DIR、BeDD.exe 旁的 mod\BeDD-server、最近的 bin\BeDD-server);--set <key=value>:一項 server.properties,可重複(準備服務器)
server start <name> 無窗口啟動服務器(控制台寫到 logs\console.log),等它啟動、BeDD 公佈端點;輸出 name、pid、port、portV6、url、token。已在運行的服務器照原樣輸出。--detach:不等端點(url、token 可能為 null);--timeout <秒>(180);--allow-firewall-prompt:啟動沒有 BeDD 迴環綁定的服務器
server stop <name> 停止服務器(它會保存世界)。--all:所有服務器;--timeout <秒>(30):超時後強制結束
server list(ls) 服務器、端口以及是否在運行
server remove <name>(rm) 刪除已停止服務器的目錄,世界也一起刪。-y、--yes:不詢問(沒有控制台時必須加)
server path <name> 輸出服務器的目錄

管理窗口

命令
manager status 管理窗口是否在運行及其進程 id;兩種情況退出碼都是 0
manager stop 關閉管理窗口及其中的所有遊戲(每個收到 {op:"close"},10 秒後強制結束),然後等它退出。-y、--yes:不詢問;--timeout <秒>(60)

其他命令

命令
version 版本信息
dev 模組開發循環:為 --slot(9)克隆基礎實例,安裝構建到 --from 的模組(默認檢出的 bin\BeDD),啟動遊戲(--label,默認 dev)並保持運行,把前臺窗口和光標限制區域的每次變化記到 --watch-log(默認檢出的 tools\out\desktop-watch.log;以 MINECRAFT HAS THE FOREGROUND 結尾的行表示有遊戲搶了焦點)。Ctrl+C 或創建 <日志目录>\dev.stop:關閉遊戲(除非 --keep)並退出;創建 <日志目录>\dev.restart:關閉遊戲、重裝模組、重新啟動。--watch-only:只監視桌面