管理員權限與維護指南 (Admin Management)
本指南完整列出 Craft-Core 伺服器管理員專用指令 (權限節點 Permissions.COMMANDS_OWNER / OP Level 4)、Ledger 防破壞查詢回滾、審計中心、資料庫備份與各子系統維護手冊。
1. 🛡️ /ledger (/lg) 方塊紀錄查詢與回滾還原系統
伺服器配備強大的 Ledger 方塊防破壞紀錄引擎，管理員可隨時查詢方塊變動歷史或進行範圍回滾：
1. 檢查模式 (Inspect Mode)
/lg inspect：切換檢查模式。開啟後對著目標方塊按【左鍵】或【右鍵】，即刻於聊天欄顯示該方塊被誰放置/破壞與詳細時間。
2. 範圍回滾還原 (Rollback)
/lg rollback source:<玩家> time:<時間> range:<距離>：將指定範圍內被指定玩家變動的方塊一鍵復原（例：/lg rollback source:Griefer time:1h range:30）。
2. 📋 遊戲內管理員專用指令完整列表
| 維護類別 | 管理員指令 | 說明與範例 |
|---|---|---|
| 審計中心 | /audit list | 查詢 Discord 審核中心所有待審 Warp 地標申請 |
/audit approve <ID> | 核准 Warp 申請並自動建立全服公共地標 | |
/audit reject <ID> | 駁回 Warp 申請 | |
| 世界備份 | /backup | 非同步壓縮打包備份地圖存檔與 SQLite 資料庫 |
| 抽獎與留存 | /retain lottery | 手動觸發一次全服整點在線抽獎與幸運雨活動 |
/givekey <玩家> <數量> | 向指定玩家發放幸運抽獎鑰匙（/addkey 同義） | |
/removekey <玩家> <數量> | 扣除指定玩家的抽獎鑰匙 | |
| 經濟與金幣 | /addmoney <玩家> <金額> | 增加指定玩家的帳戶金幣（例：/addmoney Alex 5000） |
/removemoney <玩家> <金額> | 扣除指定玩家的帳戶金幣（例：/removemoney Alex 1000） | |
| 世界與大廳 | /lobby setspawn | 將當前站立座標與視角設為大廳維度重生點 |
/setwarp <名稱> | 在當前位置設立公共地標（/delwarp <名稱> 刪除） | |
/mining reset | 強制重置採礦世界地形與礦脈資源 | |
| 動態地圖 | /map render full | 非同步重繪當前維度所有地圖圖磚 |
/map render radius <區塊> | 非同步渲染以玩家為中心半徑區塊 | |
/map render cancel | 取消當前背景地圖渲染作業 | |
| 全服活動 | /worldboss spawn | 強制在討伐競技場召喚 50,000 HP 世界 BOSS |
/fish start [分鐘] | 強制啟動全服釣魚大賽（/fish stop 強制終止） | |
/bounty reset | 強制輪替並重置全服每週共同目標 | |
/treasure spawn | 強制清除舊寶箱並於野外地表刷新全新藏寶箱 | |
| 安全與監管 | /invsee <玩家> | 即時查看並編輯在線玩家或假人的背包物品與裝備 |
/machine admin list | 查看機器認證申請清單（/machine admin approve <ID> <Tier>） |
3. 🏪 管理員無限官方系統商店
管理員可建立免庫存、免資金的官方系統商店：
- 對著目標箱子商店告示牌按【右鍵】開啟管理介面。
- 點擊「切換無限」按鈕切換為無限模式，此時商店將具備無限貨源與無限收購資金。
- 點擊「清空箱子」可快速清除箱子內殘留雜物。
4. 🤖 Discord 維護頻道管理員工具
透過與伺服器雙向 WebSocket 連動的 Discord 管理員專屬頻道，管理員可隨時執行以下遠端維護作業：
- 發布全服彩色廣播：支援預覽並向遊戲伺服器即時推播格式化公告。
- 審核公共設施 Warp 申請：直接在 Discord 介面點擊按鈕完成 Warp 審核，遊戲端自動生效。
- 即時監控伺服器 TPS 與效能：掌握在線人數與各維度運作狀態。