如何架設 Hytale 伺服器：2026 完整安裝與設定指南

準備好託管您自己的 Hytale 伺服器了嗎？無論您是為朋友架設私人世界還是啟動公開社群伺服器，這份完整指南將引導您完成每一步——從安裝 Java 到為數百名玩家最佳化效能。 在本指南結束時，您將擁有一個完全可用的 Hytale 專用伺服器，供玩家加入。讓我們開始吧。 系統需求 在開始安裝之前，請確保您的伺服器機器滿足以下最低需求： 元件最低建議 記憶體4 GB8-16 GB CPU2 核心4+ 核心 儲存空間10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25（建議 Adoptium） 架構支援 x64 和 arm64 作業系統Windows、Linux 或 macOS 了解資源使用情況 Hytale 伺服器的資源消耗在很大程度上取決於玩家行為： CPU 使用率：由玩家數量和實體數量（NPC、怪物、活躍生物）決定 記憶體使用率：由已載入的世界區域決定——更高的視距和玩家獨立探索會增加記憶體需求 專業提示：在遊戲過程中監控 RAM 和 CPU 使用情況，了解伺服器的典型消耗。如果您注意到 CPU 使用率過高，可能表示記憶體壓力導致過度垃圾回收——請嘗試調整 Java 的 -Xmx 參數。 步驟 1：安裝 Java 25 Hytale 伺服器需要 Java 25。我們推薦使用 Adoptium（前身為 AdoptOpenJDK）取得可靠的生產級建置。 下載 Java 25 造訪 adoptium.net 下載適用於您作業系統的 JDK 25 安裝程式 執行安裝程式並按照提示操作 驗證安裝 開啟終端機或命令提示字元並執行： java --version 您應該看到類似以下的輸出： openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) 如果您看到不同的版本或錯誤訊息，請確保 Java 25 已正確安裝並新增至系統 PATH。 步驟 2：取得伺服器檔案 您有兩種方式取得 Hytale 伺服器檔案： 選項 A：從遊戲安裝目錄複製（快速測試） 快速架設最簡單的方法——直接從 Hytale 啟動器安裝目錄複製檔案： 檔案位置： 作業系統路徑 Windows%appdata%\Hytale\install\release\package\game\latest Linux$XDG_DATA_HOME/Hytale/install/release/package/game/latest macOS~/Application Support/Hytale/install/release/package/game/latest 將 Server 資料夾和 Assets.zip 複製到您的專用伺服器位置。 選項 B：Hytale Downloader CLI（正式伺服器） 對於正式環境，請使用官方 Hytale Downloader CLI 工具。這使更新更容易並支援自動化： 從 Hytale 官方支援網站下載 hytale-downloader.zip 解壓縮並閱讀附帶的 QUICKSTART.md 執行下載器取得最新的伺服器檔案 常用指令： 指令說明 ./hytale-downloader下載最新版本 ./hytale-downloader -print-version顯示遊戲版本而不下載 ./hytale-downloader -patchline pre-release從預先發布頻道下載 步驟 3：啟動伺服器 導覽至伺服器目錄並使用以下指令啟動： java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip -XX:AOTCache 旗標使用伺服器附帶的預先訓練 Ahead-Of-Time 快取，可顯著縮短啟動時間。 首次身份驗證 首次啟動後，您必須對伺服器進行身份驗證。在伺服器主控台中執行： /auth login device 您將看到裝置授權提示： =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... 在瀏覽器中造訪顯示的 URL 使用您的 Hytale 帳戶登入 輸入主控台中顯示的代碼 返回主控台——您應該看到 "Authentication successful!" 重要：每個 Hytale 遊戲授權最多支援 100 個伺服器。對於更大規模的部署，請購買額外授權或申請伺服器提供商帳戶。 步驟 4：設定連接埠和防火牆 Hytale 使用 基於 UDP 的 QUIC 協定（非 TCP）。這對於防火牆和連接埠轉發設定非常重要。 預設連接埠 預設連接埠為 5520。要使用不同的連接埠： java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 連接埠轉發 如果在路由器後面託管，請將 UDP 連接埠 5520（或您的自訂連接埠）轉發到您的伺服器機器。不需要 TCP 轉發。 防火牆設定 Windows（以系統管理員身分執行 PowerShell）： New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables)： sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw)： sudo ufw allow 5520/udp NAT 注意事項 QUIC 在大多數情境下能很好地處理 NAT 穿越。如果玩家連線困難： 確保連接埠轉發專門針對 UDP，而非 TCP 對稱 NAT 設定可能導致問題——考慮使用 VPS 或專用伺服器 電信業者級 NAT 後面的玩家（行動裝置常見）作為用戶端連線應該沒有問題 伺服器檔案結構 了解伺服器的檔案結構有助於管理和疑難排解： 路徑說明 .cache/最佳化檔案快取 logs/伺服器記錄檔 mods/已安裝的模組 universe/世界和玩家存檔資料 bans.json封鎖玩家清單 config.json伺服器設定 permissions.json權限設定 whitelist.json白名單玩家 世界結構 世界儲存在 universe/worlds/ 中。每個世界都有自己的 config.json，包含以下設定： 世界種子和生成類型 PvP 啟用/停用 墜落傷害設定 NPC 生成行為 所需外掛 每個世界在自己的主執行緒上執行，平行工作分佈在共用執行緒池中。 安裝模組 向 Hytale 伺服器新增模組非常簡單： 從 CurseForge 或其他可信來源下載模組（.zip 或 .jar 檔案） 將模組檔案放入伺服器的 mods/ 資料夾 重新啟動伺服器 注意：許多模組僅在伺服器端執行——加入您伺服器的玩家將自動接收模組內容，無需手動安裝。 效能最佳化 視距 視距是 RAM 使用量的主要驅動因素。預設視距為 384 個方塊（12 個區塊），大約相當於 24 個 Minecraft 區塊。 建議： 對於小型伺服器（1-10 名玩家）：預設設定即可 對於中型伺服器（10-50 名玩家）：考慮限制為 8-10 個區塊 對於大型伺服器（50+ 名玩家）：限制為 6-8 個區塊並監控資源 推薦外掛 主要託管服務商維護著有用的伺服器管理外掛： 外掛說明 Nitrado:WebServerWeb 應用程式和 API 的基礎外掛 Nitrado:Query透過 HTTP 公開伺服器狀態（玩家數量等） Nitrado:PerformanceSaver根據資源動態限制視距 ApexHosting:PrometheusExporter公開詳細的伺服器和 JVM 指標 開發期間停用 Sentry 如果您正在開發外掛，請停用當機報告以避免提交開發錯誤： java -jar HytaleServer.jar --assets Assets.zip --disable-sentry 伺服器指令參考 檢視所有可用的伺服器參數： java -jar HytaleServer.jar --help 常用參數： 參數說明 --assets <path>Assets.zip 的路徑（預設：../HytaleAssets） --bind <address:port>監聽位址（預設：0.0.0.0:5520） --auth-mode <mode>身份驗證模式：authenticated 或 offline --backup啟用自動備份 --backup-dir <path>備份目錄位置 --backup-frequency <minutes>備份間隔（預設：30） --disable-sentry停用當機報告 多伺服器架構 Hytale 原生支援在伺服器之間路由玩家——無需像 BungeeCord 這樣的反向代理。 玩家轉移 將已連線的玩家轉移到其他伺服器，可附帶選用的資料負載： PlayerRef.referToServer(host, port, optionalData) 安全提示：負載資料通過用戶端傳遞，可能被竄改。使用加密簽章（例如帶共用金鑰的 HMAC）在接收伺服器上驗證真實性。 連線重新導向 在連線交握期間，將玩家重新導向到不同的伺服器以實現負載平衡或區域路由。 斷線備援 當玩家意外斷線（伺服器當機、網路問題）時，用戶端會自動重新連線到預先設定的備援伺服器，而不是返回主選單。 將您的伺服器加入清單 當您的伺服器開始運作後，讓玩家發現它： 提交到 HytaleCharts：新增您的伺服器到我們的伺服器清單，獲得免費曝光 官方伺服器探索：加入 Hytale 內建的伺服器瀏覽器（即將推出） 建立您的社群：建立 Discord 伺服器和社群媒體形象 提高排名的技巧： 保持高上線率（99%+） 將伺服器更新到最新版本 撰寫有吸引力的伺服器描述，包含相關關鍵字 鼓勵玩家為您的伺服器投票 常見問題排解 玩家無法連線 驗證防火牆是否允許 5520 連接埠的 UDP 流量 確認連接埠轉發設定為 UDP（非 TCP） 檢查伺服器是否已通過身份驗證 確保玩家與伺服器使用相同的遊戲版本 記憶體使用過高 降低視距 限制最大玩家數量 檢查佔用大量記憶體的模組 適當調整 -Xmx 參數 伺服器延遲 監控實體數量（過多的怪物/NPC） 在尖峰時段檢查 CPU 使用率 使用效能監控外掛 如果持續滿載運行，考慮升級硬體 身份驗證問題 重新執行 /auth login device 確保您的 Hytale 帳戶狀態良好 檢查是否超出了每個授權 100 個伺服器的限制 關鍵要點 需要 Java 25：使用 Adoptium 取得可靠建置 UDP 連接埠 5520：QUIC 協定需要 UDP，而非 TCP 需要身份驗證：首次啟動後執行 /auth login device 視距 = 記憶體：降低視距以減少記憶體使用 AOT 快取：使用 -XX:AOTCache=HytaleServer.aot 加快啟動速度 模組資料夾：將模組放入 mods/ 並重新啟動 原生多伺服器：伺服器間轉移無需代理 您的 Hytale 伺服器現已準備好迎接玩家。提交到 HytaleCharts 開始建立您的社群吧！