如何在《Hytale》中安装模组(2026)

一份关于如何在Hytale中下载和安装模组的完整指南,包括使用像Curseforge这样的模组管理器。

September 20, 2026阅读约 10 分钟更新于 September 20, 2026

关于如何在 Windows、Linux 和 macOS 上为 Hytale 下载和安装模组的指南。

Hytale 的模组制作方式与我们为其他大多数游戏撰写的指南都不太一样,而在你下载任何东西之前,这个区别值得先理解清楚。Hypixel Studios 将 Hytale 打造为服务器端优先。模组是由世界的宿主方安装的,而不是由每个玩家各自安装,而且工作室已经明确表示,他们不打算支持任何客户端模组。

这听起来很受限,直到你意识到它带来的好处:你可以加入任何有模组的 Hytale 服务器,而无需安装任何东西。没有客户端整合包,没有版本折腾,也没有启动器配置文件。

我们这次的示例是 BetterMap,这是一个服务器插件,能为游戏内地图提供持久化探索记录、路标点和洞穴渲染功能。

前置要求

一台运行 Windows、Linux 或 macOS 的 PC。Hytale 对这三者都有原生构建版本。
一份通过 hytale.com 购买的 Hytale。该游戏目前处于抢先体验阶段,且不在 Steam 上架。
足够的可用空间来安装你想要的内容。含有大量模型和材质的资源包会占用较大空间;插件通常很小。
一个 .zip 解压工具,不过很多情况下你根本不需要解压任何东西。

注意 - Hytale 自 2026 年 1 月起进入抢先体验阶段,目前仍在快速迭代中。Hypixel Studios 对模组工具的现状一直持自我批评的态度,坦承文档存在缺口,部分系统仍显粗糙。请预期事情会有变动,也请预期模组偶尔会在更新后损坏。

服务器端模组机制解析

Hypixel Studios 在公布其模组策略时列出了几项原则,其中两项决定了本指南的整体思路:

服务器端优先。 所有 Hytale 模组都基于服务器宿主方或游戏宿主方运作。你应该能够加入任何有模组的 Hytale 服务器,而无需下载外部模组或折腾客户端整合包。
一个社区,一个客户端。 他们希望避免出现每个服务器都需要专属模组客户端的生态,因此客户端保持稳定统一,而由服务器来提供差异化体验。

实际上,这意味着模组只需由宿主方安装一次,每个连接进来的玩家都能获得带模组的体验,而客户端本身仍是完全原版的。

单人模式其实也是服务器

这一点是理解后面所有内容的关键。

Hytale 并没有传统意义上独立的单人模式。当你创建一个单人世界时,你实际上是加入了一个只属于你自己的本地服务器。所以“宿主方”就是你自己,为单人游戏安装模组的操作,与在服务器上安装模组本质相同,只是文件夹不同而已。

之后,你可以按存档逐一选择想要使用的模组,这确实是一个不错的模式:一个世界用大型整合包,另一个保持原版,不需要切换配置文件。

加入别人的模组服务器

你什么都不需要安装。直接连接服务器开始游玩即可。

由宿主方的插件和资源包驱动整体体验,你的客户端只是渲染服务器传来的内容。这也是为什么游戏内的服务器浏览器能够进行兼容性检查,只显示你实际能加入的服务器。

Hytale 模组的四种类型

Hytale 的模组制作分为四个技术类别,弄清楚你面对的是哪一种,就能知道该有什么预期。

类型	格式	作用
服务器插件	Java `.jar`	以编程方式扩展服务器功能。小游戏、经济系统、命令、自定义逻辑。最强大的一类。
数据资源	JSON	定义核心内容:方块、物品、NPC、世界生成、战利品和掉落表。
美术资源	模型、材质、音效	决定一切的外观和声音。Hytale 支持使用 Blockbench 制作模型和动画。
存档文件	世界与预制件	完整的世界,或是用于创造模式工具和世界生成的预制结构。

资源包是中间两种类型的打包格式。一个资源包就是一个 zip 文件或文件夹,里面含有一个 manifest.json,包含一套自定义资源,用于覆盖或添加到基础游戏内容之上。它们可以在游戏内的资源编辑器中制作,也可以在文件浏览器中手动制作,不过工作室推荐使用编辑器,因为文件夹结构要求较为严格。

BetterMap 是一个服务器插件,所以它属于第一类。

注意 - Hytale 中没有 Lua 或其他基于文本的脚本语言,工作室已表示也不会加入。他们的计划是采用视觉化脚本系统,风格类似 Unreal Blueprints,同时为程序员提供 Java 支持。

模组存放位置

有两个位置很重要。

全局模组文件夹,供所有内容使用:

C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods

每个世界的模组文件夹,每个存档也都有一个:

C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods

在 Linux 和 macOS 上,UserData 文件夹位于你系统对应的应用数据目录中,其内部结构相同。

全局 Mods 文件夹中的任何内容对所有世界都可用。而某个世界自己的 mods 文件夹中的内容,则只属于该世界。

提示 - 在 Windows 上,将 %appdata%\Hytale\UserData 粘贴到文件资源管理器的地址栏中,即可直接跳转到该位置。

为单人游戏安装模组

前往 CurseForge 的 Hytale 板块找一个 mod。本指南以 BetterMap 为例。
下载它。
打开你的 UserData\Mods 文件夹。
把下载的文件放进去。资源包可以保持压缩状态或解压成文件夹；插件则以 .jar 形式放入。
启动 Hytale。
打开 New World（新建世界）菜单，查看 Options（选项）。你已安装的 mod 和资源包会显示在那里。
启用你想在此世界使用的项目，然后创建世界。

最后一步是最容易被忽略的。把 mod 放进文件夹只是让它变为可用；创建世界时你仍需按世界逐一选择它。

CurseForge 是主要的托管平台，这并不意外,因为 Hypixel Studios 曾与其合作举办了奖金高达 10 万美元的 New Worlds Modding Contest。截至 2026 年初，该平台上已有超过 5,000 个 Hytale mod，下载总量超过 2000 万次。

在专用服务器上安装 Mod

对于你为他人运行的服务器来说，原理完全相同，只不过文件夹是服务器自己的。

下载该 mod。
将其放入服务器的 mods 目录中。
重启服务器。

BetterMap 会把它所需的一切都保存在那里，首次运行时会创建 mods/bettermap/ 用于存放配置和数据。

连接到你的服务器的玩家什么都不需要安装。这正是这一模式的意义所在。

如果你还没有搭建服务器，我们另有一篇 Hytale 服务器搭建指南涵盖了这方面内容。

使用 TMC App 安装

由于目前还没有 Hytale mod 管理器，这一点值得一提。The TMC App 是我们自己开发的 mod 管理器和服务器浏览器，支持一键安装以及 sandboxes（沙盒）：按游戏命名的 mod 配置方案，各自拥有独立的加载顺序和部署方式，切换时无需重新下载任何内容。

Hytale 尚未列入其支持的游戏列表，但它其实非常契合。该应用的运作方式是了解某款游戏的 mod 存放位置以及启动方式，这两者都只是四个 JSON 文件而非代码，而 Hytale 的 UserData\Mods 文件夹不涉及任何加载器，几乎是这个系统能遇到的最简单的目标之一。Sandboxes 也能很自然地对应到 Hytale 按世界选择 mod 的机制。

老实说：这个应用还处于非常早期的开发阶段。 它的 README 中写明目前只经过部分测试，我们不会对此进行美化。Hytale 本身也处于抢先体验阶段并且每周都在变动，所以这是两个尚不成熟的东西碰到了一起。如果你愿意尝试，试用并反馈意见会非常有帮助。

它是基于 GPL-3.0 协议的开源项目，地址在 github.com/modcommunity/tmc-app。错误报告和功能请求可以提交到 issue 追踪器，欢迎提交 pull request，如果你想在我们完成之前抢先贡献 Hytale 支持，仓库中也记录了每款游戏的格式规范。

安装方式：

Linux：一行命令，无需 root 权限，也不需要包管理器。

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

Windows：从 releases 页面下载 setup.exe 或 setup.msi。也有便携版本，不过它不会注册启动器入口或 tmc:// 链接处理程序。
macOS：从同一个 releases 页面下载 .dmg。

配置 Mod

目前没有统一的标准，但常见的做法是在 mod 自己位于 mods 下的文件夹中放一个 JSON 配置文件。

BetterMap 就是一个很好的例子。它的设置存放在 mods/bettermap/config.json 中，暴露出诸如探索半径、地图质量、更新频率，以及是否在玩家之间共享探索进度等选项：

{
  "explorationRadius": 16,
  "updateRateMs": 500,
  "mapQuality": "MEDIUM",
  "shareAllExploration": false,
  "radarEnabled": true
}

做得好的插件通常还会加入管理员命令和权限系统。BetterMap 注册了 /bm 系列命令，包括 /bm reload，可以在不重启的情况下应用配置变更，不过它也说明了部分设置仍需要完全重启才能生效。

请阅读 mod 在 CurseForge 上的说明页面。由于 Hytale 的模组生态还很年轻，那个页面往往是唯一的文档来源。

按世界划分的 Mod

在游戏内使用 Asset Editor 创建的资源包，会存放到该世界自己的 mods 文件夹中，而不是全局文件夹。在你正在制作东西的时候这很方便,但当你第一次开启第二个世界，却找不到自己的资源包时，就会感到困惑。

要在另一个世界中使用你在某个世界里制作的资源包，请从以下位置复制它：

UserData\Saves\<World Name>\mods

到：

UserData\Mods

一旦放入全局文件夹，它就会出现在每个新世界的选项中。

平台

Hytale 的抢先体验版支持 Windows、macOS 和 Linux，就这三个平台。没有主机版或移动版，游戏也不在 Steam 上架。

这三个桌面平台之间支持跨平台游玩，而自游戏重新收购以来，更广泛的跨平台支持一直是计划的一部分，但目前除了桌面平台外，没有其他平台可以安装 mod。

更新与移除 Mod

目前还没有针对 Hytale 的 mod 管理器，所以这两项操作都需要手动完成。

更新：从 CurseForge 下载新版本，替换掉 Mods 中的旧文件。查看 mod 页面确认你的配置是否会保留。
移除：从 Mods 中删除该文件，或者只是在某个世界中取消勾选该 mod。
仅在单个世界中禁用：保留该文件不动，在该世界的选项中取消勾选它。

警告 - 从曾经使用过某个添加了方块、物品或生物的 mod 的世界中移除该 mod，可能会让该世界陷入不良状态，这与任何方块类游戏的情况相同。在从现有世界中清除 mod 之前，请先备份存档文件夹。

故障排除

我的 mod 没有出现在 New World 选项中。 文件夹放错了。它需要放在 UserData\Mods 中，或者放在该世界自己的 mods 文件夹中，并且资源包需要一个有效的 manifest.json。

我安装了 mod，但我已经在玩的世界没有变化。 Mod 是在创建世界时选定的。已有的世界不会自动获取新安装的 mod。

我在游戏内制作的资源包在另一个世界里不见了。 Asset Editor 制作的资源包会保存到你制作它时所在的那个世界。把它复制到全局 Mods 文件夹中即可。

插件加载了，但命令没有反应。 检查权限。Hytale 插件使用权限节点（permission nodes），命令通常需要 OP 权限或明确授权。

Hytale 更新后一切都坏了。 在这个阶段属于正常现象。Hytale 每周发布预发布补丁，并每隔几周打包进稳定版本，模组需要时间跟上更新。

玩家说他们需要安装模组才能加入。 并不需要。如果有人这么跟你说，他们说的其实是另一款游戏的运作方式。

我能使用客户端模组吗？ 不能。目前没有客户端模组支持，工作室也表示没有相关计划。

结语

Hytale 模组归结为一个简单的理念：主机端安装，其他人只管玩。把文件放进 UserData\Mods，创建世界时勾选它，就完成了。对于专用服务器来说，也是同样的文件，放进服务器自己的 mods 文件夹即可。

这与我们其他指南中 BepInEx 和模组加载器的设置方式截然不同，一旦理解了这套逻辑，工作量会小得多。工具链还很年轻，文档也不够完善——Hypixel Studios 自己也承认这一点——所以在一切逐渐稳定之前，多参考模组说明和 docs.hytale.com。

如果你想帮上忙，TMC App 是开源项目，目前还处于非常早期的开发阶段，任何反馈都会受到真诚的欢迎。

另请参阅

Hytale on CurseForge
Hytale Documentation - 关于运行服务器和构建模组的官方文档。
Creating Content in Hytale - 资源包、世界生成以及各类编辑器。
Hytale Modding Strategy and Status - 工作室自己对模组现状和未来方向的说明，值得完整阅读。
Official Hytale Discord
Hytale Wiki
TMC App

Hytale 处于抢先体验阶段，变化很快，因此这篇指南的过时速度会比大多数指南更快。如果你发现某个说明已经和实际情况不符，请反馈给我们，或者在这篇指南的 GitHub 仓库中提交一个 pull request。

如果你有任何问题，或者需要任何与模组相关的帮助，欢迎加入我们的 Discord 服务器！

登录后即可评论。