齐格弗里德的通用库

Ziggfreed 的 CommonLib

这是 Ziggfreed 的 Hytale 模组背后的共享库。是其中一些模组的必要依赖，也是希望自行构建模组的模组制作者的工具包。

CommonLib 是经过实战检验的底层代码，支撑着 Ziggfreed 的模组：3D 音效、相机效果、通知和 HUD 辅助工具、分支 NPC 对话引擎，以及完整的合作实例框架（队伍、队列、排行榜、奖励）。一次性发布此库意味着所有使用它的模组行为一致，且只需在一个地方修复问题。


我需要这个吗？

如果某个模组的页面将 Ziggfreed 的 CommonLib 列为必要依赖，那么是的：将该库与该模组一起安装即可。如果你运行的任何内容都不需要它，那么你就无需安装。

无需任何设置。CommonLib 本身不会添加任何命令、配置文件、物品或游戏玩法。它会静默加载，依赖它的模组会完成其余工作，否则它会保持不干涉状态。

安装

1. 从“版本”选项卡下载 ZiggfreedCommon-<版本>.jar。
2. 将其放入你服务器的 Mods/ 文件夹中，与需要它的模组放在一起。
3. 确保你的 Hytale 服务器处于 Update 5 范围（0.5.x）。

在依赖 CommonLib 的模组 之前 加载 CommonLib（当模组声明依赖关系时，Hytale 会自动处理这一点）。

---

针对模组制作者

CommonLib 是一个与模组无关的原始库。它唯一依赖的是 Hytale 服务器 jar 文件（与任何其他模组零耦合），每个实用程序都是静态调用，并且可以原样复用。将其作为 compileOnly 依赖项添加，在你的 manifest.json 依赖项中列出它以便服务器首先加载它，然后调用你需要的功能。

它是 Kweebec Nightmare 的基础，旨在支持未来任何 Ziggfreed 的小游戏、地下城或副本。

内部包含什么

• 3D 音效 - 在某个位置或实体上播放任何 SoundEvent，支持分类和按听者过滤。
• 相机 - 单次屏幕震动效果和自上而下的服务器相机应用/重置。
• 通知和标题 - 带样式的通知消息（默认/危险/警告/成功）和居中事件横幅。
• HUD 和页面内提示 - 安装自定义 HUD，支持剥离/恢复原生 HUD，以及一个与传输方式无关的页面内提示引擎。
• 分支 NPC 对话引擎 - 一个通用对话系统（节点、选项、条件、动作），带有自己的 UI、模板 DSL 和结构验证器。附带其 UI 资源包。
• 合作实例框架 - 一个可搜索邀请的队伍系统，一个公共/队伍/单人游玩和排队界面（带有实时启动计时器），一个游戏结束结果界面，一个分桶排行榜，以及一个由资源驱动的奖励模型（带有无损失的背包已满保护）。
• 遭遇战框架 - 按实体定时和分段的特效（命中减速、减益效果、升级阶段），带有波次导演的加权生成名单，一个合作区域占据目标计时器（撤离点、占领点、山丘之王），以及贴合地形的运行时生成点放置。
• 世界辅助工具 - 一个地表探测工具，可将放置贴合到程序化地形上，世界地图和指南针 POI 标记（全局和按玩家），以及一个隐藏直至发现的 POI 追踪器。
• 实用工具 - 资源索引缓存、数字格式化器、命令执行、敌对性检查、实体标识符，以及记忆化的伤害原因索引，外加自定义资源物品的背包辅助工具。

创作你自己的内容，无需 Java 知识

在合适的地方，CommonLib 由 Server/ZiggfreedCommon/ 下的资源包 JSON 驱动（对话和对话模板、实例预设、多阶段首领、分段效果、遭遇战规则、预制件放置、排行榜布局和队伍设置），解析遵循 默认 < 资源包 < 所有者 的优先级。内容包可以调整框架而无需接触代码。

---

版本

版本	说明
1.0.0	首个稳定版。为 1.0 消费者界面提供了功能完整的原语、对话引擎以及合作实例+遭遇战框架。添加了运行时首领生命值缩放、首领世界地图标记旋钮以及相同身份奖励合并。
0.3.2	添加了一个可复用的合作“占据此区域”目标计时器（撤离点、占领点、山丘之王），以及多阶段首领原语上的每个阶段辅助可投掷物簇旋钮。
0.3.1	为消费者页面添加了一个共享的分段标签/过滤按钮样式（队伍大小标签、分类标签）。
0.3.0 及更早版本	核心原语（3D 音效、相机、资源索引缓存、命令执行、背包、通知、HUD 辅助工具、地表探测工具）加上分支 NPC 对话引擎及其 UI 资源包。

由 Ziggfreed / Wintergreen Solutions 制作。