常見問題
| 現象 | 原因 → 解決 |
|---|---|
| HTTP 401 | 令牌錯誤或過期（每次啟動都換新）→ 從 ps --json 同時取 url 和 token |
| HTTP 403 | Origin 請求頭 → 去掉它，或列進 allowOrigins |
| 連接被拒絕 | 還沒啟動好或已退出 → 不帶 --detach 運行 launch |
| 連接太多 | 超過 wsMaxClients（8）→ 關掉一些 |
| 遊戲約 30 秒後關閉 | 沒有管理窗口（見 latest.log）→ manager status、logs\manager.log，去掉 --no-manager；CI：配置 manager=false |
| 克隆要幾分鐘、幾 GB | 跨卷複製 → 把 BEDD_INSTANCES_DIR 設到基礎實例所在盤，重新克隆（克隆） |
| 找不到 LeviLauncher | 沒裝或低於 1.1 → 更新，或設 BEDD_LEVILAUNCHER |
| 找不到實例 | → LeviLauncher.exe install 1.26.60 --loader；有多個：BEDD_INSTANCE；見 instance list --all |
| 沒有 WebSocket，模組沒加載 | 不是 1.26.60 + LeviLamina 26.60.x（latest.log）→ LeviLauncher.exe loader install、instance refresh |
| 克隆裡的 BeDD 模組舊了或不對 | --keep-mod、遊戲在運行或 --from 固定 → mod install <instance>（升級） |
| "發生錯誤"（"Blaze"） | 共用登錄 → world singleplayer；在線：--exclusive-signaling |
| 遊戲用了我平時的存檔和設置 | 不是用 launch 啟動的，或基礎實例不是 LeviLauncher 1.1+ 裝的 |
| 每個克隆都彈防火牆提示 | loopbackOnly 關了 → 打開；沒有 BeDD 的服務器會問一次（點取消） |
| 啟動時閃控制台窗口 | CrashLogger.exe → launch 會修好（配置） |
| 關掉了別人的遊戲 | 按進程名找 → 按實例找；每次運行一個槽位 |
斷開後 button 沒起作用 | 無終點的 down 被鬆開 → 用 click/holdTicks/releaseOn（多條連接） |
look 超時，遊戲操作無反應 | 世界暫停（不走刻）→ key ESC |
ui stale_ref / occluded / not_ready / unsupported | → 重新讀 ui / force:true / 重試 / 模擬輸入（UI 樹） |
code:"disabled" | 功能開關為 false；unknown op：本版本沒有該操作 |
報告 bug
提 issue，附上 BeDD.exe version、請求和結果、
mod config <instance>，以及開啟 trace=true 時的 logs\latest.log（會顯示輸入，模擬的還是真實的）。