- 服务器设置
Hytale 服务器可以在任何 至少 4GB 内存和使用 Java 25 的设备上运行，同时支持 x64 和 arm64 两种架构。
我们建议在服务器运行时监控内存和 CPU 的使用情况，以了解在你的玩家数量和游玩风格下的典型资源消耗——资源使用情况在很大程度上取决于玩家的行为。
资源类型 | 影响因素 |
|---|---|
CPU（处理器） | 大量的实体（玩家、生物、NPC） |
RAM（内存） | 过大的世界加载范围（视距设置太高、玩家分散探索的行为） |
确认安装情况：
对于windows用户，首先请使用 win键 + R键 打开运行窗口，输入 cmd 以打开命令提示符。
在命令提示符窗口内，请输入 java -version 以查看Java 25是否成功安装。
通常来说你的版本号可能与上图一样或更新，具体内容取决于你安装Java的时间。
服务器文件：
有两种获取服务器文件的方法：
方法1.从你的Hytale启动器目录直接复制文件；
方法2.使用 Hytale Downloader 命令行工具（CLI）。
直接复制（最适合快速测试，但不便于日后持续更新）：
首先找到你的Hytale游戏安装目录（不是启动器的位置！）：
最直接且快捷的方法是通过你的Hytale启动器：
之后你应该进入 你的游戏安装目录\Hytale\install\release\package\game\latest
请确保你看见了以下这三个文件夹！
最后，将 Server文件夹 与 Assets.zip 拖入你的服务器文件夹（如果你没有的话，现场新建一个）
使用Hytale Downloader（适用于生产环境服务器，便于保持更新）：
Hytale Downloader是一个用于下载 Hytale 服务器和资源文件的命令行工具，支持 OAuth2 认证。具体操作请查看压缩包内的 QUICKSTART.md 文件。
指令 | 描述 |
|---|---|
| ./hytale-downloader | 下载最新发布版本 |
| ./hytale-downloader -print-version | 显示游戏版本，但不进行下载 |
| ./hytale-downloader -version | 显示hytale-downloader版本 |
| ./hytale-downloader -check-update | 检查hytale-downloader的更新 |
| ./hytale-downloader -download-path game.zip | 下载到特定文件 |
| ./hytale-downloader -patchline pre-release | 从预发布频道下载 |
| ./hytale-downloader -skip-update-check | 跳过自动更新检查 |
- 启动服务器
服务器启动设定：
java -jar HytaleServer.jar --assets PathToAssets.zip
认证：
首次启动时，将进行服务器认证。
一旦认证完毕，你的服务器就可以接受玩家连接加入。
附加认证信息
Hytale 服务器需要进行身份认证，以启用与我们服务 API 的通信，并防止滥用行为。
帮助：
查看所有可用参数：
java -jar HytaleServer.jar --help
你应该会看到：
端口：
默认端口为 5520 ，你可以使用
--bind进行修改。Hytale 使用基于 UDP 的 QUIC 协议（而非 TCP）。请相应地配置你的防火墙和端口转发。
端口转发：
如果你在路由器后面托管服务器，请将 UDP 端口 5520（或你自定义的端口）转发到你的服务器设备，无需进行 TCP 转发。
防火墙规则：
Windows Defender 防火墙：
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow
Linux (iptables)：
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPTLinux (ufw)：
sudo ufw allow 5520/udp
NAT 注意事项：
QUIC 协议在大多数情况下能很好地处理 NAT 穿透。但如果玩家遇到连接问题，请检查以下几点：
1、确保端口转发是针对 UDP，而不是 TCP。
2、对称型 NAT 配置可能会导致连接问题 —— 建议使用 VPS 或专用服务器。
3、使用运营商级NAT（常见于移动网络）的玩家通常可以正常作为客户端连接。
文件结构：
路径 | 说明 |
|---|---|
| .cache/ | 优化文件缓存目录 |
| logs/ | 服务器日志 |
| mods/ | 已安装mod目录 |
| universe/ | 存档数据（世界 + 玩家） |
| bans.json | 封禁玩家列表 |
| config.json | 服务器配置文件 |
| permissions.json | 权限配置文件 |
| whitelist.json | 白名单玩家列表 |
Universe 结构：
该目录包含所有可游玩的世界。每个世界都有自己的配置文件，路径为：
universe/worlds/config.json每个世界在自己的主线程上运行，并将并行任务分配到共享的线程池中处理。
- 提示与小技巧
- 多服务器架构
- 其他杂七杂八的细节
- 未来项目
