Hytale 伺服器檔案與專用託管設定（搶先體驗 2026 年）

Hytale 現在附帶官方專用伺服器文件，因此任何人都可以託管持久世界、私人領域或完整的公共網路。伺服器作為獨立的 Java 應用程式運行，並使用與客戶端相同的內容資產，配置和 mods 完全在伺服器端控制。

Hytale 伺服器檔案包含什麼

專用伺服器位於其自己的資料夾中，通常與遊戲資產的副本一起。首次啟動後的典型佈局如下所示：

HytaleServer/
├── HytaleServer.jar
├── Assets.zip
├── config.json
├── permissions.json
├── whitelist.json
├── bans.json
├── mods/
├── universe/
│   └── worlds/
├── logs/
└── .cache/

HytaleServer.jar是實際的伺服器可執行檔。Assets.zip包含伺服器產生地形、載入實體以及與客戶端保持邏輯同步所需的遊戲資料。根目錄中的 JSON 檔案控制全域設定和玩家訪問，而universe/目錄保存世界並保存資料。模組是從mods/啟動時的資料夾。

運行 Hytale 伺服器的系統需求

專用伺服器運行在爪哇25並且支援x64和arm64 CPU架構。在使用伺服器檔案之前，請安裝 Java 25 執行時間並使用下列命令進行確認：

java --version

記憶體和磁碟效能比高核心數量更重要。實際的起點是至少 4 GB RAM 和 SSD 存儲，然後隨著玩家數量和觀看距離的增長而擴展。 NVMe 磁碟對區塊載入和世界保存有很大幫助。

並發玩家	CPU（約）	記憶體（大約）	儲存指導
1–10	2–3 快速核心	4–6 GB	固態硬碟，20–40 GB
10–30	4 個快速核心	8–12 GB	首選 NVMe，40–80 GB
30–75	6+ 快速核心	16–24 GB	NVMe，80-150 GB
75+	高階專用CPU	32GB+	NVMe + 頻繁備份

提示：如果出現效能問題，通常的罪魁禍首是視距過遠、RAM 較低或儲存速度較慢，而不是缺少總核心數。

取得官方 Hytale 伺服器文件

專用伺服器檔案可以透過兩種主要方式取得：從現有啟動器安裝中複製它們或使用官方下載器 CLI。

方法一：從遊戲安裝複製

步驟一：使用普通啟動器在您的電腦上安裝並更新 Hytale，然後完全關閉遊戲，這樣就不會鎖定任何檔案。

步驟2：導航到您的作業系統的遊戲安裝目錄，並找到包含伺服器和資產的最新套件資料夾：

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

步驟3：為您的專用伺服器建立一個新資料夾（例如，C:\HytaleServer或者/opt/hytale-server）並複製HytaleServer.jar加Assets.zip進入其中。

第4步：將此目錄與啟動器安裝分開。所有未來的伺服器配置和資料都將儲存在這裡。

方法二：使用官方下載器CLI

下載器 CLI 自動取得和更新伺服器版本。

步驟一：取得官方下載器二進位文件，如 Hytale 支援文件中所述：https://support.hytale.com/，然後將其放入空的伺服器目錄中。

步驟2：執行一次下載程式以取得最新的伺服器檔案和資源，例如在 Linux 或 macOS 上：

./hytale-downloader

步驟3：使用輔助標誌來檢查版本並在需要時更新狀態：

./hytale-downloader -print-version
./hytale-downloader -check-update

第4步：下載完成後，驗證一下HytaleServer.jar和Assets.zip存在於您的伺服器資料夾中。

第一個伺服器啟動和身份驗證

伺服器檔案就位後，第一次啟動會產生配置並觸發身份驗證。

步驟一：在伺服器目錄中開啟終端機或命令提示字元並啟動伺服器，將其指向您的資產存檔：

java -jar HytaleServer.jar --assets ./Assets.zip

步驟2：等待初始啟動完成。伺服器將建立資料夾，例如universe/,logs/和根 JSON 配置。

步驟3：在伺服器控制台中，執行設備驗證流程：

/auth login device

第4步：依照控制台顯示的URL和程式碼完成瀏覽器登入。當控制台確認成功時，伺服器被授權接受真實玩家連線。

注意：大型託管部署可以使用基於令牌的身份驗證和自動化，但設備流是單一伺服器的直接選項。

Hytale 伺服器的網路配置和連接埠

Hytale 用途基於 UDP 的 QUIC用於聯網。預設情況下伺服器監聽0.0.0.0:5520只需要打開並轉送一個 UDP 連接埠。

綁定到地址和端口

# Default port (5520)
java -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:5520

# Custom port example
java -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:25565

打開防火牆

步驟一：在 Windows Server 或 Windows 10/11 上，為所選連接埠上的 UDP 建立入站規則：

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

步驟2：在具有 UFW 的 Linux 上，允許 UDP 連接埠：

sudo ufw allow 5520/udp

步驟3：在具有 iptables 的 Linux 上，新增 UDP 接受規則：

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

第4步：如果伺服器位於家庭路由器後面，請將相同的 UDP 連接埠從路由器轉送至伺服器的內部 IP。只轉送 TCP 是行不通的，因為遊戲需要 QUIC 而不是 UDP。

提示：如果本機連線有效但遠端玩家無法加入，請在偵錯其他內容之前檢查綁定位址、防火牆和路由器轉送。

核心設定檔和目錄佈局

第一次運行後，伺服器根目錄中會出現幾個設定檔。這些文件定義權限、禁令和全域行為，而世界和每個世界的設定位於universe/.

文件或資料夾	地點	主要用途
配置.json	伺服器根目錄	全域伺服器設定
權限.json	伺服器根目錄	角色和權限規則
白名單.json	伺服器根目錄	允許的玩家（如果啟用白名單）
禁令.json	伺服器根目錄	被封鎖的玩家及原因
模組/	伺服器根目錄	模組和插件文件
宇宙/世界/<世界名稱>/	宇宙之下/	世界數據和每個世界的配置
紀錄/	伺服器根目錄	啟動、運行時和錯誤日誌
.快取/	伺服器根目錄	快取或優化的數據

在編輯 JSON 檔案之前，請務必完全停止伺服器。也可以透過遊戲內工具或命令更改一些設置，如果伺服器在檔案修改時運行，這些設定可能會覆蓋手動編輯。

世界配置和遊戲行為

每個世界都有自己的config.json在universe/worlds/<WorldName>/。該文件控制核心遊戲規則，例如 PvP、墜落傷害、NPC 生成以及世界的生成方式。

{
  "Seed": 1767292261384,
  "WorldGen": {
    "Type": "Hytale",
    "Name": "Default"
  },
  "IsTicking": true,
  "IsBlockTicking": true,
  "IsPvpEnabled": false,
  "IsFallDamageEnabled": true,
  "IsSpawningNPC": true,
  "IsAllNPCFrozen": false,
  "IsSavingPlayers": true,
  "IsSavingChunks": true,
  "IsUnloadingChunks": true
}

關鍵字段	對世界的影響
種子	控制世界生成，以便相同的種子重新創建相同的佈局。
是否啟用 Pvp	啟用或停用玩家對玩家的戰鬥。
是否啟用墜落損壞	切換玩家是否受到墜落傷害。
正在生成NPC	打開或關閉生物和 NPC 生成。
所有 NPC 都被凍結了	設定後凍結 NPC 行為，對於特殊事件或調試很有用。
IsTicking / IsBlockTicking	控制模擬是否運作以及區塊是否更新（例如作物或液體）。
IsSavingPlayers / IsSavingChunks	確定玩家資料和區塊更改是否寫入磁碟。
正在卸載區塊	決定是否從記憶體中卸載不活動的區塊。

這些每個世界的切換允許創意、冒險或特殊事件世界以不同的規則共存於同一台伺服器上。在更改之前保留備份，以便您可以在需要時恢復。

在 Hytale 伺服器上安裝和刪除 mod

Mod 完全從伺服器加載，玩家加入時會自動收到所需內容。安裝歸結為將相容文件放入mods/資料夾並重新啟動。

使用控制面板在託管伺服器上安裝模組

步驟一：透過託管控制面板停止伺服器，以便在變更期間不會讀取或寫入任何檔案。

步驟2：打開面板的檔案管理器或透過SFTP/FTP連接，然後瀏覽到mods/伺服器根目錄中的目錄。

步驟3：上傳mod檔（通常.jar或者.zip）直接進入mods/而不提取它們。

第4步：再次啟動伺服器並觀察控制台輸出以確認每個 mod 載入成功或捕獲任何錯誤訊息。

在自架伺服器上安裝 mod

步驟一：透過鍵入停止伺服器stop在控制台中或關閉終端機窗口Ctrl+C.

步驟2：將下載的 mod 檔案放入mods/旁邊的資料夾HytaleServer.jar。除非特定模組另有指示，否則請勿解壓縮它們。

步驟3：正常啟動伺服器並檢查日誌檔案或即時控制台以確保偵測到並初始化 mod。

第4步：如果新的 mod 阻止伺服器啟動，請再次停止它，並從其中刪除該 mod 文件mods/，然後重新啟動以確認穩定性，然後再嘗試其他變更。

刪除或更新模組

要刪除mod，請停止伺服器，刪除相應的文件mods/，然後再次啟動伺服器。更新遵循相同的模式：停止，刪除舊版本，複製新版本，然後重新啟動。在刪除大型遊戲模組之前，請務必保留您的世界的備份，因為已儲存的資料可能依賴它們。

伺服器端與客戶端模組

模組類型	它住在哪裡	典型用途
僅伺服器端	伺服器`mods/`資料夾	管理工具、實用程式、效能調整
僅限客戶端	玩家本地遊戲	介面變化，純視覺效果
兩者都需要	伺服器和客戶端	改變遊戲玩法的新物品、方塊或機制

檢查每個 mod 的文檔，以了解它屬於哪個類別以及它是否需要其他 mod 作為依賴項。

重要的啟動選項和 JVM 設定

伺服器接受 JVM 調整選項和 Hytale 特定的命令列標誌。正確組合它們可以提高穩定性並縮短啟動時間。

JVM選項	影響	例子
-Xms / -Xmx	設定初始和最大堆大小	`-Xms4G -Xmx4G`
-XX:+使用G1GC	啟用 G1 垃圾收集器（對於較大的堆很有幫助）	`-XX:+UseG1GC`
-XX:AOT緩存	使用 AOT 快取檔案來加速啟動	`-XX:AOTCache=HytaleServer.aot`

伺服器選項	描述	預設
--資產<路徑>	指向`Assets.zip`或資產目錄（必需）	沒有任何
--bind <ip:連接埠>	監聽的IP和端口	0.0.0.0:5520
--auth-mode <模式>	選擇`authenticated`或者`offline`模式	經過驗證的
--備份	開啟自動備份	殘障人士
--backup-dir <路徑>	儲存備份的目錄	`./backups`
--備份頻率<分鐘>	備份間隔（分鐘）	60
--禁用哨兵	停用崩潰報告，對外掛程式開發有用	已啟用崩潰報告
--允許操作	啟用操作員命令	殘障人士
--接受早期插件	載入實驗性插件（不支援）	殘障人士

Windows 上的範例生產啟動腳本（在start.bat文件）：

@echo off
java -Xms6G -Xmx6G -XX:+UseG1GC -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip --backup --backup-frequency 60
pause

Linux 上的範例（在start.sh):

#!/bin/bash
java -Xms6G -Xmx6G -XX:+UseG1GC -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip --backup --backup-frequency 60

對於本機測試或外掛程式開發，停用崩潰報告的離線伺服器通常很方便：

java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zip --auth-mode offline --disable-sentry

備份、更新和效能調整

正確處理伺服器檔案意味著定期備份、受控更新以及一些謹慎的效能選擇。

從啟動選項自動備份

步驟一：創建一個backups/伺服器目錄中的資料夾或選擇其他應儲存備份的路徑。

步驟2：啟動伺服器並啟用備份選項，例如：

java -jar HytaleServer.jar --assets ./Assets.zip --backup --backup-frequency 30 --backup-dir ./backups

步驟3：定期測試從伺服器的單獨副本上的備份進行恢復，以確保您的流程在需要之前正常運作。

安全更新伺服器文件

當新的伺服器版本發佈時，最安全的工作流程是停止伺服器，備份整個目錄（尤其是universe/），更新伺服器可執行檔案和資產，然後重新啟動並監視日誌。下載器 CLI 可以檢查版本並一致地套用更新：

./hytale-downloader
./hytale-downloader -print-version
./hytale-downloader -check-update

關鍵績效槓桿

視距通常是 RAM 使用率和 CPU 負載的主要驅動因素；一開始要保守，只有在確認穩定後才提高。
記憶體限制應留有淨空；在高峰時段監控記憶體並增加-Xmx如果您發現頻繁的垃圾收集或交換，請減少設定。
貯存理想情況下應該是 SSD 或 NVMe，特別是對於許多玩家探索新領域的公共伺服器。
模組可能很重；一次添加或更新它們，以便輕鬆跟踪性能回歸。

使用 AOT 快取選項（-XX:AOTCache=HytaleServer.aot）可以顯著減少啟動時間，這在需要頻繁重新啟動以進行更新或測試時非常有用。

Hytale 伺服器檔案的常見錯誤

僅打開 TCP 連接埠而不是 UDP，這會阻止玩家連接，因為 Hytale 使用 QUIC over UDP。
忘記完成設備身份驗證，使伺服器保持運行但無法處理真實玩家登入。
在確認硬體容量之前將視距或其他繁重的設定推得太高，會導致延遲和卡頓。
在沒有任何備份策略的情況下運行，並在磁碟故障或 mod 損壞資料時丟失世界。
編輯config.json或伺服器運行時的權限文件，這存在更改被覆蓋的風險。
直接在即時生產伺服器上一次安裝或更新多個模組，而不是在臨時實例上進行測試。

避免這些陷阱可以保持伺服器環境的可預測性，並保護您的世界資料和玩家的時間。

多伺服器網路和伺服器網格功能

Hytale 包含用於在伺服器之間切換玩家的內建機制，允許多世界網路而不依賴外部代理。

玩家推薦使用諸如PlayerRef.referToServer(host, port, payload)將已連線的玩家以及少量有效負載移動到另一台伺服器。
連線重定向可以使用PlayerSetupConnectEvent.referToServer(host, port)在握手期間將玩家送到其他地方。

伴隨引用的有效負載會通過客戶端，因此必須將其視為不可信。使用共用金鑰（例如透過 HMAC）對資料進行簽署可以讓目標伺服器在對其進行操作之前驗證有效負載是否由受信任的對等方產生。

更高級的設定可以使用支援 QUIC 的庫來實現自訂代理層，並使用內部提供的資料包定義HytaleServer.jar.