如何在Hytale伺服器列表中顯示線上玩家數量

當玩家瀏覽Hytale伺服器列表時，一個數字決定了他們是點擊「加入」還是繼續滾動：玩家數量。一個顯示47/100玩家的伺服器感覺充滿活力。一個什麼都不顯示——或只顯示「離線」——的伺服器即使運行正常也像座鬼城。 HytaleCharts 提供三種方式來顯示您的Hytale伺服器的即時玩家數量和線上狀態。每種方法在準確性、設定難度和功能方面有不同的權衡。本指南解釋了所有三種方法，以便您為自己的設定選擇合適的方案。 三種方法概覽 方法玩家數量更新速度設定難度最適合 Heartbeat外掛精確數量 + 玩家列表每60秒安裝外掛自行託管的伺服器 外部查詢精確數量每5分鐘設定URLNitrado / 託管主機 UDP Ping僅線上/離線定期無（自動）基本狀態回退 方法1：HytaleCharts Heartbeat外掛（推薦） Heartbeat外掛是在最佳方式中顯示玩家數量的Hytale伺服器列表。它在您的Hytale伺服器上運行，每60秒向HytaleCharts發送心跳信號，包括線上玩家的精確數量及其使用者名稱。 它報告什麼 玩家數量 — 目前連線的玩家數量 最大玩家數 — 您伺服器的玩家上限 玩家列表 — 已連線玩家的使用者名稱和UUID 外掛版本 — 以便HytaleCharts可以提醒您更新 內部運作原理 外掛每60秒發送一次POST請求到/api/heartbeat 請求包含您伺服器的密鑰（64字元的十六進位字串） HytaleCharts驗證密鑰，更新您伺服器的玩家數量和狀態 如果5分鐘內未收到心跳，伺服器將被標記為離線 歷史資料被儲存用於分析和玩家數量圖表 設定步驟 產生心跳密鑰 — 在HytaleCharts中，前往編輯伺服器並點擊Heartbeat外掛部分中的「產生心跳密鑰」 複製密鑰 — 您只能看到一次（遺失後可以重新產生） 安裝HytaleCharts外掛將其放入您伺服器的mods/目錄中 設定外掛 — 在外掛資料目錄中建立或編輯config.json： { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } 重新啟動您的伺服器 — 外掛將立即開始發送心跳 在HytaleCharts上驗證 — 您的伺服器應在60秒內顯示為線上並帶有玩家數量 多實例支援 如果您執行多個伺服器實例（例如大廳伺服器和生存伺服器），心跳系統會自動彙總玩家數量。共享相同密鑰的所有實例將合併其唯一玩家並加總總數。這表示您在Hytale伺服器列表中的項目顯示整個網路的正確總數。 系統透過IP位址和世界名稱識別唯一實例，取得每個來源的最新心跳，並按UUID合併玩家以避免對連線到多個實例的玩家進行重複計算。 外掛更新 HytaleCharts追蹤您的外掛版本。如果有更新版本可用，您的編輯伺服器頁面將顯示「有可用更新」警告。保持外掛最新可確保與任何API變更的相容性，並獲得最新的錯誤修正。 方法2：外部查詢端點（Nitrado和託管主機） 並非所有Hytale伺服器營運商都有安裝自訂外掛的權限。如果您使用Nitrado、基於容器的主機或任何提供查詢端點的供應商，外部查詢系統是您的解決方案。 運作方式 您向HytaleCharts提供一個傳回您伺服器玩家數量JSON的URL HytaleCharts輪詢該URL 每5分鐘 回應被解析，您的玩家數量在伺服器列表中更新 如果端點變得無法存取，您的伺服器狀態將在10分鐘內反映變化 支援的回應格式 HytaleCharts自動偵測多種JSON格式，因此可以直接與大多數查詢端點搭配使用： Nitrado格式 { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } 標準格式 { "player_count": 15, "max_players": 100 } 還支援camelCase變體（playerCount, maxPlayers）和簡寫（online, max）。 設定步驟 在您的託管供應商處找到或設定查詢端點（Nitrado預設提供一個） 在HytaleCharts中，前往編輯伺服器 → 外部查詢 輸入查詢端點的完整URL 點擊「測試端點」以驗證回應可解析 儲存 — HytaleCharts立即開始輪詢 外部查詢方法的更新頻率低於心跳外掛（每5分鐘 vs. 每60秒），但不需要任何伺服器端修改。 方法3：UDP Ping（自動回退） 如果您既未設定心跳外掛也未設定外部查詢端點，HytaleCharts將嘗試透過UDP ping檢查您伺服器的狀態。這是一個被動系統，不需要您進行任何設定。 運作方式 HytaleCharts向您伺服器的公開埠發送最小的QUIC協定探測（預設：5520) 如果收到任何回應，伺服器被標記為線上 如果多次重試後沒有回應，伺服器被標記為離線 限制 無玩家數量 — UDP ping只能判斷線上或離線，無法確定有多少玩家連線 無玩家列表 — 沒有可用的個別玩家資料 時間精確度較低 — 狀態更新取決於輪詢排程而非即時心跳 UDP ping作為基準很有用，但希望在Hytale伺服器列表排名中攀升的伺服器應安裝心跳外掛或設定外部查詢以獲得準確的玩家數量。 HytaleCharts如何判斷您伺服器的狀態 當有多種方法可用時，HytaleCharts使用優先順序系統來決定信任哪個資料來源： 外部查詢 （最高優先順序，如果已啟用）— 如果最近一次成功輪詢在10分鐘內則為線上 Heartbeat外掛 （如果已設定）— 如果最近一次心跳在5分鐘內則為線上 UDP Ping （回退）— 使用上次檢查儲存的線上/離線結果 這表示如果您同時設定了心跳外掛和外部查詢，外部查詢優先。大多數營運商會使用其中一個，而不是兩個都用。 玩家看到什麼 在Hytale伺服器列表上，您伺服器的狀態顯示為彩色徽章： 帶玩家數量的綠色徽章 （例如，「線上 — 47名玩家」）— 當線上並偵測到玩家時 綠色徽章 （「線上」）— 當線上但沒有玩家或數量不可用時 紅色徽章 （「離線」）— 當沒有最近的心跳、查詢或ping回應時 顯示玩家數量的伺服器始終吸引更多點擊。顯示「線上 — 23名玩家」的伺服器比只顯示「線上」沒有數量的伺服器更有吸引力。這就是為什麼心跳外掛或外部查詢對於頂級Hytale伺服器. 疑難排解 問題可能原因解決方案 伺服器顯示「離線」但實際在運行防火牆阻擋心跳或ping確保您的伺服器可以向hytalecharts.com發出HTTPS出站請求 玩家數量卡在0外掛未追蹤玩家事件驗證外掛已載入（檢查伺服器日誌）並重新啟動 心跳一段時間後停止外掛當機或被卸載檢查伺服器日誌中的錯誤，必要時重新安裝外掛 外部查詢顯示錯誤數量端點傳回過時資料在瀏覽器中直接驗證JSON回應 多實例數量過低實例使用不同的密鑰所有實例必須共享相同的心跳密鑰 「有可用更新」警告外掛已過時從HytaleCharts下載最新版本的外掛 最佳實務 營運頂級Hytale伺服器的營運商遵循以下模式： 盡可能使用心跳外掛 — 它是最準確和回應最快的選項 設定合理的最大玩家數 — 虛高的上限（例如999）看起來不誠實並降低信任 監控您的心跳狀態 — 定期檢查編輯伺服器頁面以查找錯誤 保持外掛更新 — 過時的外掛可能在API變更後停止運作 使用外部查詢作為備份 — 如果您的外掛出現故障，正常運作的外部端點可以保持您的狀態準確 確保您的網域正確 — UDP ping回退使用您設定的網域，因此即使主要使用心跳也要保持其準確 開始使用 使用心跳外掛顯示玩家數量不到五分鐘。產生密鑰，安裝外掛，將密鑰新增到設定中，然後重新啟動。您的Hytale伺服器將在一分鐘內顯示在Hytale伺服器列表上，並帶有即時玩家數量。 對於Nitrado等託管主機供應商，外部查詢更加簡單——只需貼上一個URL，HytaleCharts會處理其餘事項。 無論哪種方式，顯示真實的玩家數量是增加伺服器能見度和吸引新玩家最簡單的方法之一。在Hytale伺服器列表上顯示活躍玩家數量的伺服器始終優於不顯示的伺服器。