玩家管理
玩家管理依賴遊戲外掛。外掛未安裝或未連線時，頁面會提示「暫無玩家」。
玩家清單
「玩家」頁面分為線上與離線兩部分：
- 線上玩家：來自伺服器記憶體快照，包含名稱、GUID、血量、模式與所在位置。
- 離線玩家：來自
PlayerEntities存檔目錄，可檢視與編輯基礎資料。
清單透過 SSE 即時更新，無需手動重新整理。若無資料變化，頁面不會重繪。
常用操作
| 操作 | 說明 |
|---|---|
| 踢出 | 斷開玩家連線，玩家可重新加入 |
| 封禁 | 記錄封禁並拒絕加入 |
| 擊殺 | 使玩家死亡並觸發重生流程 |
| 治療 | 將血量回復到滿值 |
| 設定血量 | 依比例設定目前血量 |
| 遊戲模式 | 切換創造、生存、冒險等模式 |
| 無敵 | 開關傷害免疫 |
| 清空背包 | 移除背包內全部物品 |
| 傳送 | 傳送到指定座標 |
| 回出生點 | 傳送到世界出生點 |
| 設定出生點 | 將玩家目前位置設為出生點 |
| 管理員 | 授予或移除管理員權限 |
| 體溫/疲勞 | 調整生存狀態數值 |
| 睡覺/喚醒 | 切換睡眠狀態 |
所有操作都會寫入稽核日誌，記錄操作者、目標玩家與結果。
背包
背包面板顯示玩家目前的生存模式物品欄，支援檢視與編輯欄位內容。
當玩家處於創造模式時，創造物品欄不屬於正常背包資料，面板會隱藏整個背包卡片，避免展示不完整的物品資訊。切換回生存模式後重新開啟玩家詳情即可看到背包。
離線玩家
離線玩家資料來自存檔檔案。可執行的操作包括：
- 檢視名稱、GUID 與最後更新時間。
- 編輯基礎屬性與出生點。
- 檢視背包內容。
直接修改存檔前，請先確認實例已停止或該玩家不在線，避免寫入衝突。
白名單與權限
- 白名單用於限制可加入的玩家。
- 管理員權限對應遊戲內管理員指令。
- 面板帳號權限與遊戲內權限相互獨立，需分別設定。
資料來源與排查
如果「全部玩家」長 期為空：
- 確認外掛已載入，實例日誌出現外掛啟動訊息。
- 確認實例處於執行狀態。
- 確認伺服器存檔目錄中存在
PlayerEntities。 - 檢視面板日誌中
offline dir resolved一行，確認解析到的實際目錄。
仍無法解決時，可在 Gitee 儲存庫提交 Issue，並附上日誌與實例目錄結構。