遊戲外掛
遊戲外掛執行於伺服器行程內,是面板讀取玩家、聊天與遊戲狀態的唯一通道。沒有外掛時,面板仍可管理行程、檔案與備份,但無法取得遊戲內資料。
安裝
透過面板安裝
- 開啟實例詳情頁。
- 在「外掛」卡片點擊「安裝外掛」。
- 面板會從內建資源寫入
JIILScWebMangerPlugin.dll,並同步監聽連接埠與存取權杖。 - 重新啟動實例使外掛生效。
安裝後無需手動編輯伺服器設定。
手動安裝
將發行包中的 JIILScWebMangerPlugin.dll 複製到伺服器外掛目錄,通常為:
<伺服器目錄>/Plugins/JIILScWebMangerPlugin.dll
啟動伺服器後,從日誌確認外掛已載入:
[ScWebManger] plugin loaded
[ScWebManger] HTTP server started on 127.0.0.1:18235
運作方式
- 外掛僅監聽本機回環位址,不接受外部直接存取。
- 面板透過守護行程取得實例連接埠,再使用共享權杖呼叫外掛介面。
- 外掛或實例重新啟動後,面板會自動重新連線,最長等待約 30 秒。
能力
| 能力 | 說明 |
|---|---|
| 玩家清單 | 線上玩家、離線存檔、基礎屬性 |
| 玩家操作 | 踢出、擊殺、治療、血量、模式、背包、傳送等 |
| 聊天記錄 | 即時聊天與系統訊息 |
| 世界狀態 | TPS、線上時長、天氣與時間 |
| 控制台 | 執行伺服器指令並回傳輸出 |
連接埠衝突
外掛預設使用 18235。連接埠被佔用時,會在 18235–18245 範圍內自動選擇空閒連接埠,並更新實例設定。面板會自動讀取新連接埠,無需手動處理。
移除
- 停止實例。
- 刪除伺服器外掛目錄中的
JIILScWebMangerPlugin.dll。 - 啟動實例。
移除外掛後,面板將無法顯示該實例的遊戲內資料,但行程與檔案管理不受影響。
版本說明
外掛版本與面板版本獨立。升級面板後,若「外掛」卡片提示版本不一致,請重新點擊「安裝外掛」並重新啟動實例。