命令行
不帶參數(雙擊)運行 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 |
等待信令鎖的時間 |
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 |
結束全部遊戲前不詢問 |
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:只監視桌面 |