跳至主要内容

遊戲外掛

遊戲外掛執行於伺服器行程內,是面板讀取玩家、聊天與遊戲狀態的唯一通道。沒有外掛時,面板仍可管理行程、檔案與備份,但無法取得遊戲內資料。

安裝​

透過面板安裝​

  1. 開啟實例詳情頁。
  2. 在「外掛」卡片點擊「安裝外掛」。
  3. 面板會從內建資源寫入 JIILScWebMangerPlugin.dll,並同步監聽連接埠與存取權杖。
  4. 重新啟動實例使外掛生效。

安裝後無需手動編輯伺服器設定。

手動安裝​

將發行包中的 JIILScWebMangerPlugin.dll 複製到伺服器外掛目錄,通常為:

<伺服器目錄>/Plugins/JIILScWebMangerPlugin.dll

啟動伺服器後,從日誌確認外掛已載入:

[ScWebManger] plugin loaded
[ScWebManger] HTTP server started on 127.0.0.1:18235

運作方式​

  • 外掛僅監聽本機回環位址,不接受外部直接存取。
  • 面板透過守護行程取得實例連接埠,再使用共享權杖呼叫外掛介面。
  • 外掛或實例重新啟動後,面板會自動重新連線,最長等待約 30 秒。

能力​

能力說明
玩家清單線上玩家、離線存檔、基礎屬性
玩家操作踢出、擊殺、治療、血量、模式、背包、傳送等
聊天記錄即時聊天與系統訊息
世界狀態TPS、線上時長、天氣與時間
控制台執行伺服器指令並回傳輸出

連接埠衝突​

外掛預設使用 18235。連接埠被佔用時,會在 18235–18245 範圍內自動選擇空閒連接埠,並更新實例設定。面板會自動讀取新連接埠,無需手動處理。

移除​

  1. 停止實例。
  2. 刪除伺服器外掛目錄中的 JIILScWebMangerPlugin.dll。
  3. 啟動實例。

移除外掛後,面板將無法顯示該實例的遊戲內資料,但行程與檔案管理不受影響。

版本說明​

外掛版本與面板版本獨立。升級面板後,若「外掛」卡片提示版本不一致,請重新點擊「安裝外掛」並重新啟動實例。