Hytale 有官方专用服务器吗？

有：HytaleServer.jar，Hytale 支持已提供文档。游戏处于抢先体验，选项与格式（config.json 等）可能变化。

为什么没有 config.json 生成器？

仅有少数字段（ServerName、MOTD、Password、MaxPlayers、MaxViewRadius、备份）由第三方记录，无官方模式：我们不会编造。请在服务器停止时编辑生成的文件。

需要备份什么？

universe/ 文件夹（世界与玩家数据），以及 config.json 和 permissions.json。

可以不用账号（离线模式）运行吗？

有指南提到开发时可用 --auth-mode offline，但这并非公开服务器的常规做法。请用 --help 核实。

安装 Hytale 服务器：本地、VPS、独立服务器、端口

Hytale 提供官方专用服务器 HytaleServer.jar（Java 25，至少 4 GB 内存，基于 QUIC 的 UDP 5520），必须使用 Hytale 账号认证。游戏处于抢先体验，请以 Hytale 支持的官方手册为准；以下内容综合了官方支持与托管商指南。

分步安装

确认机器配置：Java 25 (x64/arm64), 4 GB RAM min.。
获取服务器文件：从游戏安装目录取得 Server 文件夹（含 HytaleServer.jar）和 Assets.zip，或使用官方 Hytale Downloader（代码登录）。
安装 Java 25 并用 java -version 检查。
运行 java -jar HytaleServer.jar --assets Assets.zip；首次启动会创建 config.json、logs/ 和 universe/。
在控制台执行 /auth login device，在 accounts.hytale.com/device 确认验证码，再执行 /auth persistence Encrypted。
在服务器停止时编辑 config.json（ServerName、MOTD、Password、MaxPlayers、MaxViewRadius）。
在防火墙和路由器中开放端口 5520/UDP。
使用控制台顶部显示的地址（IP:5520）加入；暂不支持 DNS SRV 记录，请使用 A 记录。
配置自动启动（计划任务或 systemd 服务）。
安排 universe/ 的备份与更新。

前置条件

Java 25（x64 或 arm64）；至少 4 GB 内存，视距（MaxViewRadius，建议不超过 12 区块）是主要内存开销
拥有游戏的 Hytale 账号；每份许可最多 500 台服务器
客户端与服务器须使用相同协议版本

本地安装（Windows）

新建文件夹（如 C:\HytaleServer），从 %appdata%\Hytale\install\release\package\game\latest 复制 Server 文件夹和 Assets.zip，然后运行命令。与游戏同一台电脑运行服务器时，总内存至少需 16 GB。

cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zip

在 Linux VPS / 独立服务器上安装

Ubuntu/Debian：创建非 root 用户，安装 Java 25（如 Eclipse Temurin 25），再用 Hytale Downloader 获取服务器（代码登录，令牌保存在 .hytale-downloader-credentials.json；认证出错时删除该文件）。Downloader 的具体选项此处不展开，请查看其帮助。

sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version   # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip

需要开放的端口

5520/UDP：默认游戏端口（QUIC），可用 --bind 修改；无需开放 TCP

Linux 防火墙（ufw）

在 Ubuntu/Debian 上先放行 SSH 以免被锁在外面，再放行游戏端口。

sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw status

Windows 防火墙（netsh）

在管理员权限的 PowerShell（或管理员 cmd）中执行：

netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520

服务商防火墙与端口转发（NAT）

如果服务器托管在服务商（OVH、Hetzner、Scaleway 等），请在其网络防火墙（“安全组”）中开放相同端口。家庭自建时，将路由器端口转发（NAT）到该机器的固定内网 IP。请从外部（手机网络或朋友）测试；在自己网络内测试说明不了问题。

自动启动与监控

创建 /etc/systemd/system/<名称>.service，然后执行：sudo systemctl daemon-reload && sudo systemctl enable --now <名称>。日志：journalctl -u <名称> -f。

[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target

[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15

[Install]
WantedBy=multi-user.target

Windows 自动启动（计划任务）

创建触发器为“启动时”的计划任务运行启动脚本，使用最高权限，并选择“不管用户是否登录都要运行”。

更新、备份与重启

停止服务器，重新执行 Hytale Downloader 后再启动。重大更新前备份 universe/。服务器每次启动都会检查新版本，通常重启即可更新。切换 patchline（release/pre-release）前请先备份：预发布版的世界可能无法在较旧版本中打开。

# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/

登记并让玩家找到服务器

服务器公开后，请在 https://game-rank.com/jeux/hytale（本工具所有者的网站）登记，方便玩家找到、关注并投票。

故障排查

外网无法连接但 localhost 正常：缺少系统防火墙规则、服务商防火墙或 NAT 转发，或协议（UDP/TCP）不对。请逐层检查。
游戏更新后连接被拒绝：客户端与服务器版本必须一致。请重新更新服务器并重启。
服务器立即退出：请在控制台中启动以查看错误，并检查可用内存、磁盘和软件依赖。
提示需要认证或重启后登录丢失：重新执行 /auth login device 并检查 /auth persistence（Memory 重启即丢失，请选 Encrypted）。
内存不足或卡顿：先降低 MaxViewRadius（/maxviewradius <半径>），再考虑加内存。

常见问题

Hytale 有官方专用服务器吗？: 有：HytaleServer.jar，Hytale 支持已提供文档。游戏处于抢先体验，选项与格式（config.json 等）可能变化。
为什么没有 config.json 生成器？: 仅有少数字段（ServerName、MOTD、Password、MaxPlayers、MaxViewRadius、备份）由第三方记录，无官方模式：我们不会编造。请在服务器停止时编辑生成的文件。
需要备份什么？: universe/ 文件夹（世界与玩家数据），以及 config.json 和 permissions.json。
可以不用账号（离线模式）运行吗？: 有指南提到开发时可用 --auth-mode offline，但这并非公开服务器的常规做法。请用 --help 核实。