常見問題
安裝與啟動
面板啟動後打不開
- 確認面板行程仍在執行。
- 確認存取位址與連接埠正確，預設
http://127.0.0.1:18233。 - 確認存取範圍設定允許目前來源。
- 檢視
logs/是否有連接埠佔用或權限錯誤。
連接埠被佔用
面板連接埠、守護行程連接埠或外掛連接埠可能被其他程式佔用。修改面板連接埠後重新啟動；外掛連接埠會自動順延。
忘記初始帳號
初始帳號在首次啟動日誌中輸出。若日誌已遺失，可停止面板後依維護工具說明重設管理員帳號。
實例
實例啟動後立即結束
檢視實例日誌。常見原因是伺服器路徑錯誤、記憶體不足、設定損壞或模組衝突。
匯入實例後找不到世界
確認所選目錄包含 Worlds 目錄。若伺服器目錄結構不同，可手動填寫世界目錄路徑。
實例狀態顯示異常
守護行程與實例通訊中斷時會顯示離線。等待自動重新連線，或重新啟動面板與守護行程。
玩家
玩家清單為空
- 確認外掛已載入並連線。
- 確認實例正在執行。
- 確認
PlayerEntities目錄存在。 - 檢視面板日誌中的目錄解析結果。
背包不顯示
玩家處於創造模式時，面板會隱藏背包卡片。切換為生存模式後重新開啟玩家詳情。
操作失敗或逾時
確認帳號具備玩家管理權限、實例外掛在線，且玩家仍在線。離線玩家部分操作不可用。
AI 助理
助理無法呼叫某個功能
在工具清單中確認該工具的開關與權限。預設關閉的工具需要手動開啟。
助理反覆嘗試錯誤方式
工具被拒絕時會回傳原因。若助理仍重複嘗試，可在對話中明確要求它先說明缺少哪個工具。
審批被拒絕
檢視拒絕理由，調整請求或改為人工審批。
網路與即時資料
遠端存取時資料刷新很慢
- 反向代理需關閉回應緩衝（
proxy_buffering off或flush_interval -1）。 - 確保 HTTPS 終結層未對
text/event-stream做壓縮或快取。 - 確認用戶端與面板之間沒有額外的代理層。
頁面載入慢
首次載入會下載前端資源，後續由瀏覽器快取。若持續緩慢，請檢查網路鏈路與代理設定。
升級與資料
升級後需要重新登入
升級會保留工作階段檔案；若安裝腳本重設了工作階段，需要重新登入。此為預期行為。
升級後外掛提示版本不一致
在實例詳情頁重新安裝外掛並重新啟動實例。
備份可以跨版本還原嗎
可以。備份是實例目錄的完整打包，與面板版本無關。
回報問題
提交 Issue 時請附上：
- 面板與外掛版本。
- 作業系統與伺服器類型。
- 相關日誌片段。
- 重現步驟與預期結果。
儲存庫位址：Gitee 公開儲存庫