本指南将介绍如何在 Windows、Linux 和 macOS 上搭建、配置和上架 Hytale 服务器。
Hytale 服务器与我们写过的其他游戏服务器指南有一点不同：每个 Hytale 世界本身就是一个服务器。当你创建单人世界时，客户端会启动一个本地服务器并加入其中。多人游玩本质上是同一回事，只是有其他人连接进来。并不存在一个需要切换进入的独立
这也意味着模组是服务器端的事情，而不是客户端的事情，这一点在我们的 Hytale 模组指南 中有详细介绍。
关于本文的时效性说明： Hytale 自 2026 年 1 月起进入抢先体验阶段，Hypixel Studios 尚未发布独立的专用服务器搭建文档。以下内容基于他们的官方文档、更新日志和服务器运营政策整理而成，并会明确指出官方指导止步于何处。
系统要求
Hytale 公布的客户端最低配置要求如下：
| 最低配置 | |
|---|---|
| 操作系统 | Windows 11 或 Windows 10 x64（1809）、Linux x64（内核 6.15）、或搭载 macOS Tahoe 26.0 的 Apple Silicon |
| CPU | Intel Core i5-7500、AMD Ryzen 3 1200，或 Apple M1 |
| 内存 | 8 GB |
| GPU | Intel UHD 620、AMD Radeon Vega 6、Apple M1，或 GTX 900 / Radeon 400 系列显卡 |
对于服务器来说，可以忽略 GPU 这一行，其他各项都要往上调：
- 内存是主要限制因素。 服务器是用 Java 写的，它要把已加载的区块和实体保存在内存中，而资源包（asset packs）会进一步增加内存占用。8 GB 是小群体的下限，装了模组的繁忙服务器需要明显更多。
- 单线程性能很重要。 和大多数方块类游戏一样，很多 tick 处理工作是不并行的。
- 磁盘占用完全取决于世界被探索的程度。世界存档会持续增长。
- 一份从 hytale.com 购买的 Hytale 许可证。这款游戏不在 Steam 上架。
注意 - Hytale 在 macOS 上仅支持 Apple Silicon。没有 Intel Mac 版本。
理解 Hytale 的服务器模式
Hytale 的技术总监 Kevin Carstens 在工作室公布其模组策略时说得很明白：Hytale 的不同之处在于，即使你加入单人游戏，你实际上加入的也是一个仅供你自己使用的本地服务器。文档中提到“服务器”时，指的既是单人也是多人。
实际上，这带来了几个值得记住的后果：
- 模组只需由主机安装一次。 加入你服务器的玩家什么都不需要安装。他们的原版客户端会渲染服务器所发送的任何内容。
- 你在单人模式中的经验可以直接迁移。 在单人模式中配置世界，和配置服务器几乎是同一种技能。
- 不存在需要分发的模组化客户端。 工作室表示他们不打算支持客户端模组，正是为了避免出现每个服务器都有各自专属客户端的碎片化生态。
宇宙、世界与实例
Hytale 组织内容的方式是一种层级结构，这在配置文件和更新日志中都会反复出现。
一个**宇宙（universe）包含多个世界。一个世界（world）**就是玩家心目中的地图。**实例（instances）**是某个世界的独立副本，用于传送装置（Portal Devices）之类的场景，它们可以从宇宙的默认世界继承诸如跌落伤害和 PvP 之类的设置。
你会在插件配置中看到这套词汇，所以在开始阅读配置文件之前最好先了解它们。
通过客户端搭建服务器
对于小群体来说，这就是全部答案，不需要任何额外软件。
在客户端中创建一个世界，在**新建世界（New World）**选项中选择你想要的模组和资源包，然后把邀请码分享给你的朋友。他们连接后使用的是完全原版的客户端。
这种方式适合一群朋友一起玩，也是大多数人第一次体验 Hytale 多人游玩的方式。它的局限性也很明显：世界只有在你客户端运行时才在线，它会和你自己的游戏抢占资源，而且完全绑定在你的机器上。
运行独立服务器
如果你想要一个持久运行、不需要你本人登录也能维持的服务器，就需要让服务器独立运行。
这正是官方文档目前止步的地方。 Hypixel Studios 提供了一份 Java 服务器 API 参考文档和资源文档，并运营着服务器发现（Server Discovery）功能，背后还有一整套政策文档，所以自建服务器显然是被预期并受到支持的。他们尚未发布的，是像 Valheim 或 ARK 那样一步步“下载这个、运行这个命令”的详细指南。
在那份指南出现之前，实用的途径包括：
- Hytale 启动器和账户管理器。 服务器分发是通过 Hytale 自己的平台处理的，而不是通过第三方商店，所以 accounts.hytale.com 是首先要查看的地方。
- 官方 Discord。 Hytale Discord 里有工作室的开发者，也是当前服务器运营者聚集的地方。对于这种发展如此迅速的事情，这里比任何书面指南（包括本文）都更可靠。
- 托管服务商。 多家游戏服务器托管商在 2026 年内加入了对 Hytale 的支持，帮你搞定搭建工作。
注意 - 服务器程序没有做混淆处理，工作室也承诺会在 Hytale Shared Source 计划下发布服务器源代码，该计划已于 2026 年 6 月上线。持有许可证的玩家可以在 GitHub 上访问完整的服务器源码、网络协议和资源，访问方式参考了 Epic 的 Unreal Engine 源码计划。如果你懂技术，这是目前存在的最完整的文档。
服务器文件存放位置
在客户端安装中,服务器相关的内容位于 UserData 下:
C:\Users\<user>\AppData\Roaming\Hytale\UserData
其中 Mods 用于存放全局可用的模组,Saves\<World Name> 用于存放每个世界的数据,每个世界都有自己的 mods 文件夹。
Linux 和 macOS 使用该平台对应的应用数据目录,底层结构相同。
独立服务器保持相同的结构:一个用于插件和资源包的 mods 目录,以及旁边的世界数据。
Linux 前置条件
Hytale 的服务器是基于 Java 的,所以你需要一个 JVM 以及一些常用的服务器维护工具。
Debian 和 Ubuntu:
sudo apt update
sudo apt install -y openjdk-21-jre-headless screen curl unzip
Fedora、RHEL 和 Rocky:
sudo dnf install -y java-21-openjdk-headless screen curl unzip
用以下命令检查你已有的版本:
java -version
提示 - 在确定使用哪个 JVM 之前,先确认当前 Hytale 版本所需的 Java 版本。这个要求在抢先体验期间已经变动过,版本不匹配会产生一个不太有用的错误提示。
Hytale 对 Linux 的要求是 内核 6.15 x64 系统,这比一些长期支持(LTS)发行版默认提供的内核要新。开始前先用 uname -r 检查一下。
安装模组与插件
模组放在服务器的 mods 目录中,服务器会在启动时加载它们。
- 下载插件或资源包,通常来自 CurseForge。
- 把它放进服务器的
mods目录。插件是 Java.jar文件;资源包则是一个压缩包,或是一个内含manifest.json的文件夹。 - 重启服务器。
构建良好的插件会在 mods 下创建自己的文件夹用于配置和数据存储。例如 BetterMap 会创建 mods/bettermap/ 并在其中放置 config.json,同时注册了 /bm 指令,包括可以在不重启的情况下应用配置更改的 /bm reload。
玩家无需安装任何东西。这正是服务器端模组体系的核心意义所在。
我们的 Hytale 模组指南 详细介绍了四种模组类型以及资源包的组成方式。
配置
Hytale 的配置采用 JSON 格式,分散在几个不同的位置,而不是集中在一个类似 server.properties 的文件中。
- 世界设置 在创建世界时选定,涵盖诸如摔落伤害和 PvP 之类的内容,实例可以从宇宙的默认世界继承这些设置。
- 玩法配置 以 JSON 形式存放在服务器的配置目录下。更新日志中提到过诸如
GameplayConfigs/Portal.json这样的路径,可以从中大致了解目录结构。 - 插件配置 存放在
mods中每个插件各自的文件夹下。
由于格式和路径在各次更新之间仍在变动,每次更新时都值得阅读一下 hytale.com 上的更新日志。例如,Update 7 的更新日志就直接重命名了好几个配置键。
警告 - 在更新正在运行的服务器之前,请先阅读更新日志。Hytale 每周发布抢先测试补丁,每隔几周将其打包成正式版本发布,配置键在这期间被重命名或移除过。一个你没注意到的重命名,会导致某个设置悄悄恢复为默认值。
加入服务器发现列表
Server Discovery 是游戏内的服务器浏览器,随 Update 5 于 2026 年 5 月上线。上架是免费的,整个流程都有完整的文档说明。
- 登录 Account Manager,打开 Server Profiles 页面。
- 点击 Create server。
- 填写你的详细信息:
- 名称和描述。 这是玩家评判你服务器的依据,所以要如实说明你的服务器到底是什么样的。
- 服务器类型,可选 Survival、Adventure/RPG、Creative、PvP、Minigames、Roleplay、Social、Sandbox 或 Other。
- 受众标签:Everyone、Teen 或 Mature。
- 服务区域,可从涵盖北美、南美、欧洲、中东、亚洲和大洋洲的十个选项中选择。
- 域名验证,通过 TXT DNS 记录完成,以便玩家确认该列表确实属于你。
- 提交并等待审核。审核人员会检查信息是否属实,你的列表卡片状态会随审核进度更新。
- 通过审核后,使用列表卡片上的 discovery token 配置你的服务器发送心跳。
列表按提交顺序进行审核。官方也会精选一些 推荐服务器,向社区重点展示。
心跳
你的服务器通过使用列表卡片上的 discovery token 发送心跳来证明自己在线。生成该 token 只需以 OP 身份在控制台或聊天中运行一条简单命令即可完成关联。
如果你的服务器超过两分钟未发送心跳,它会从列表中隐藏,直到恢复为止。 这是一个很合理的设计,意味着一个不稳定的服务器会悄悄从 Discovery 中消失,而不是让试图加入的玩家感到沮丧。
注意 - Discovery 的第一个版本刻意做得很简洁。列表内容只有名称、描述和标签,没有自定义图标、横幅或富媒体内容。也没有实时玩家数或评分,官方特意保留这些功能,是为了防止服务器伪造或操纵这些数据。
服务器运营者政策
Hypixel Studios 发布了 Server Operator Policies,适用于 任何 托管 Hytale 服务器的人,而不仅仅是上架列表的服务器。如果你打算运营任何面向公众的服务器,值得认真阅读一遍。要点如下:
- 基本规则适用于所有运营者。 Discovery 中上架的服务器需承担额外义务。
- 上架服务器 需要提供经过验证的运营者信息,在合理可行的情况下对紧急安全举报设定 24 小时响应目标,满足技术和质量最低要求,并进行准确的内容自评分级和家长控制。
- 所有服务器禁止:色情内容、NFT、剥削性的区块链或加密货币计划,以及真钱赌博。接受加密货币作为支付方式是被允许的。
- 上架服务器必须支持官方装饰品,允许有限的主题覆盖,但需进行披露。
变现与收入分成
如果你在服务器上收取任何费用,本节内容就适用于你。
- 变现行为必须真实合法。All Ages 服务器只能投放适合全年龄的广告。Teen、mature 和 adult 服务器必须披露会影响游戏性的付费项目。
- 付费随机物品需要公布数值概率、"预期花费"披露信息,并保留十二个月的记录。双重随机购买被彻底禁止。
- 所有进行变现的服务器都适用收入分成,但在前两年(至 2028 年 1 月 13 日之前)分成比例为 0%。
最后这一点是一个真正的截止日期,如果你在做商业化的项目,值得记在日历上。
注意 - 如果这些政策与 Hytale EULA 或服务条款(Terms of Service)冲突,以 EULA 和 ToS 为准,除非这些政策被明确指定为已列出服务器的附加条款(Additional Terms)。
端口转发
Hytale 尚未在其公开文档中发布默认服务器端口,所以请检查你服务器自身的配置,而不要相信你在别处看到的某个数字。
大体流程与任何游戏服务器相同:
- 从配置或启动输出中找到你的服务器绑定的端口。
- 在路由器上将其转发到服务器主机的内网 IP。
- 允许其通过操作系统防火墙。
# Debian/Ubuntu with ufw, substituting your actual port
sudo ufw allow <port>/tcp
# Fedora/RHEL with firewalld
sudo firewall-cmd --permanent --add-port=<port>/tcp
sudo firewall-cmd --reload
Discovery 的域名验证使用的是 TXT DNS 记录,而不是任何面向网络的方式,所以这部分不需要开放任何端口。
在 Linux 上保持服务器运行
一旦你有了一个可用的启动命令,就把它包装起来,让它能在断线和重启后依然存活。
使用 screen 的快速版本:
screen -S hytale ./start.sh
用 CTRL + A 然后 D 分离会话,用 screen -r hytale 重新连接。
正式的方式是作为 systemd 单元,位于 /etc/systemd/system/hytale.service:
[Unit]
Description=Hytale Dedicated Server
After=network.target
[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=15
KillSignal=SIGINT
TimeoutStopSec=120
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now hytale
KillSignal=SIGINT 和一个较宽裕的 TimeoutStopSec 能让服务器有时间在关闭时保存世界,而不是在写入过程中被强制杀死。这一点比听起来更重要。
用 journalctl -u hytale -f 跟踪日志。
备份
Hytale 并未像 Valheim 那样宣传自带自动备份系统,所以要把备份当作自己的责任。
定期备份整个服务器数据目录,包括世界数据和 mods。用 rsync 或 tar 配合 cron 任务备份到另一块磁盘就足够了:
0 */6 * * * tar czf /backups/hytale-$(date +\%Y\%m\%d-\%H\%M).tar.gz /home/hytale/server/UserData
这一点比通常情况更重要,有两个 Hytale 特有的原因:
- 抢先体验(Early access)。 预发布期间每周都会发布更新,而且确实会出问题。
- 模组会写入世界数据。 移除一个添加了方块或实体的模组,可能会让世界处于不良状态,就和任何方块类游戏一样。
每次更新前都要备份,而不只是按计划定期备份。
编写你自己的插件
如果你打算认真运营一台服务器,最终你会需要为它写点东西。
Hytale 插件使用 Java 编写,Server API 文档是从服务器本身生成的,涵盖了 com.hypixel.hytale 下的各个包。资源参考文档记录了服务器加载的每种资源的 JSON 格式,同样是从服务器自身的 codec 生成的。
关于发展方向,有两点值得了解:
- 不会有基于文本的脚本系统,以后也不会有。工作室的论点是,Lua 式脚本是一种虚假的折中方案,它让程序员要在两种语言之间切换,而设计师又还在学习编程。
- 取而代之的计划是可视化脚本,精神上类似 Unreal Blueprints,程序员可以通过在 Java 中暴露新节点来扩展它。Update 5 中推出的 Trigger Volume 工具就是这一方向的早期成果,它在设计时就明确考虑了模组支持,让模组作者可以添加自己的效果。
故障排查
我找不到专用服务器下载。 如前所述,目前还没有发布独立服务器搭建指南。请查看 accounts.hytale.com,并在官方 Discord中询问。
我的列表没有出现在 Discovery 中。 检查列表卡片上的状态。它可能仍在审核队列中,在发布高峰期这可能会比较慢。如果它曾被通过后又消失了,那你的服务器很可能停止发送心跳了。
玩家说他们需要装模组才能加入。 并不需要。Hytale 的模组是服务端的,任何告诉你相反说法的人说的是另一个游戏。
更新后某项配置被重置了。 阅读补丁说明。配置键在不同更新之间被重命名或移除过,而一个被重命名的键会导致你设置的值被忽略。
更新后服务器无法启动。 检查当前版本所需的 Java 版本,并阅读补丁说明中关于破坏性变更的内容。如果是在添加某个插件后立即出现的问题,先把该插件移除再测试一次。
Linux 内核版本太旧。 Hytale 要求 kernel 6.15 x64。多个 LTS 发行版默认版本更旧。用 uname -r 检查。
我能在 macOS 上运行服务器吗? 客户端在 macOS 上仅支持 Apple Silicon,而服务端是这款本就年轻的游戏中文档最少的部分。使用 Linux 虚拟机或租用的服务器是阻力最小的路径。
结语
一旦理解了核心思路,Hytale 的服务器模型可以说是这些指南中所有游戏里最简洁的:每个世界都是一台服务器,模组只需由主机安装一次,玩家用纯净客户端加入,不需要其他任何东西。
对于一群朋友来说,通过邀请码从客户端直接托管就已经完全够用了。而对于需要持续在线且面向公众的服务器,目前有完整文档的部分是 Server Discovery 和 Server Operator Policies,两者都值得在你上线任何东西之前仔细阅读。独立服务器的搭建本身仍是尚待官方文档说明的部分,在此之前,Discord 是最诚实的答案。
等 Hypixel Studios 发布相关文档后,我们会认真重写这一部分。
另请参阅
- Hytale Documentation - 官方文档中心,涵盖服务器运行和模组开发。
- Hytale Server API reference - 面向插件开发者的 Java API。
- Asset reference - 服务器加载的每种资源的 JSON 格式说明。
- Server Operator Policies - 任何公开托管服务器的人都必须阅读的内容。
- Hytale Account Manager - Server Profiles 和 Discovery 列表所在之处。
- Official Server Lists announcement - 完整的 Discovery 流程说明,也是该章节的信息来源。
- Hytale Modding Strategy and Status
- Official Hytale Discord
- Hytale Wiki
- TMC App - 我们自己开发的应用,带有服务器浏览器、实时延迟图表和 RCON 功能。基于 GPL-3.0 开源协议,目前仍处于非常早期的开发阶段,欢迎试用或提供反馈。
Hytale 目前处于抢先体验阶段,更新速度很快,因此本指南需要比大多数指南更频繁地更新。如果你发现某条说明与你实际看到的情况不符,或者你已经搭建好了独立服务器并能补全上文的空缺内容,请反馈问题,或在本指南的 GitHub 仓库上发起一个 pull request。对于这篇指南来说,这类贡献尤其有价值。
如果你有任何问题,或者需要服务器与模组相关方面的帮助,欢迎加入我们的 Discord server!