概览
HZLib 是驱动 Heria Zone 模组生态的共享库。它为所有 Heria Zone 模组提供了与加载器无关的基础架构——这样,通用逻辑只需编写一次、维护一次,即可在 Forge、NeoForge 和 Fabric 上运行,无需重复实现。
如果你正在游玩某个 Heria Zone 模组,那么 HZLib 就是其背后的引擎。
功能特性
- 多加载器架构 —— 一套代码,支持三种加载器。Forge、NeoForge 和 Fabric 均为一等目标平台。
- 实体框架 —— 提供具备特性组合、属性配置和变体管理功能的基类实体类型。
- 动画配置文件系统(Animation Profile System) —— 基于数据的动画定义,可在所有实体类型间共享。
- 变体系统 —— 支持纹理、模型、尺寸和动画变体的清晰注册。
- 等级与保护机制 —— 包括属性缩放、战斗等级进度以及附魔集成等功能。
- 平台服务抽象 —— 按加载器分别抽象注册、配置、事件和网络通信。
适用对象
本模组是一个库(Library)——它自身不执行任何功能。仅当其他模组依赖它时,你才需要安装它。
被以下模组依赖:
- Lovely Robot (Legacy, Tribute, Reboot)
- Monsters & Girls
- LovelyLib
兼容性
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | ✅ | ✅ | ✅ |
链接
- 源码:GitHub — heria-zone
- 问题反馈:GitHub Issues
致谢
由 MSymbios / Heria Zone 开发。
Overview
HZLib is the shared library powering Heria Zone's mod ecosystem. It provides the loader-agnostic foundation that all Heria Zone mods are built on — so that common logic is written once, maintained once, and works across Forge, NeoForge, and Fabric without duplication.
If you're playing a Heria Zone mod, this is the engine underneath it.
What It Provides
- Multi-loader architecture — one codebase, three loaders. Forge, NeoForge, and Fabric are all first-class targets.
- Entity framework — base entity types with feature composition, stat configuration, and variant management
- Animation Profile System — data-driven animation definitions shared across all entity types
- Variant system — texture, model, size, and animation variants with clean registration
- Level and protection features — attribute scaling, combat level progression, enchantment integration
- Platform services — registration, config, events, and networking abstracted per loader
Who Needs This
This mod is a library — it does nothing on its own. You only need it if another mod requires it.
Required by:
- Lovely Robot (Legacy, Tribute, Reboot)
- Monsters & Girls
- LovelyLib
Compatibility
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | ✅ | ✅ | ✅ |
Links
- Source: GitHub — heria-zone
- Issues: GitHub Issues
Credits
Developed by MSymbios / Heria Zone.
下载 HZLib
下载 HZLib
下载 HZLib
下载 HZLib
下载 HZLib
下载 HZLib
1.0.0 — 2026-07-04
Minecraft 1.21.1
⚠️ 破坏性变更。 此版本重命名了整个框架中的核心 API 类。任何基于 0.1.0-alpha 构建的模组都必须更新其导入语句。请参阅下方的重命名表。
首个稳定版本。在 HZLib 中确立了 Family / Variant / Appearance(家族/变体/外观)三级术语体系,并引入了完整的 NBT 数据管道、声明式骨骼可见性以及待机槽动画系统。
破坏性变更:API 重命名 (ADR_018)
所有公共 API 类的 Internal* 前缀已被移除。每个名称现在都直接反映其层级和角色。
| 旧名称 | 新名称 |
|---|---|
InternalEntity |
NativeEntity |
InternalEntityType<T> |
NativeEntityFamily<T> |
InternalLogic |
EntityLogic |
InternalParticle |
EntityParticles |
InternalLayerRenderer<T> (Common) |
LayerRenderPipeline<T> |
InternalAnimation (Fabric / Forge / NeoForge) |
NativeAnimation |
InternalModel<T> (Fabric / Forge / NeoForge) |
NativeModel<T> |
InternalLayerRenderer<T> (Fabric / Forge / NeoForge) |
NativeRenderer<T> |
原因:Internal 一词积累了三个不相关的含义——实体基类、家族描述符、GeckoLib 集成层以及工具辅助类。新名称编码了层级(Native* = HZLib 根层)和角色(*Family = 家族描述符,*Pipeline = 渲染协调器),使得仅从类名即可读取其职责。
尚未重命名(推迟到未来版本):
IInternalRenderLayer—— 渲染层接口NativeEntity上的nativeEntity字段 —— 字段重命名是一个影响范围更大的操作
新增:NBT 数据管道 (ADR_019)
一个与版本无关、类型安全的实体数据管道。HZLib 的所有管道代码现在都在 DataCompound(一个纯 Java 包装器)上运行,而不是直接在 MC 原生标签类型上运行。这使得 HZLib 能够向后移植到 1.12.2 和 1.7.10,而无需重写保存/加载层。
DataCompound—— 与版本无关的纯 Java NBT 包装器接口。与 MC NBT API 的唯一接触点是适配器实现,它位于特定版本的源集中。NbtAdapterFactory—— 用于注册 MC 特定版本的DataCompound实现的注册点。在模组初始化时注册一次。CompoundTagDataCompound——DataCompound的 1.21.1CompoundTag实现。DataType<T>——INT,FLOAT,BOOLEAN,STRING,UUID。UUID 处理是版本安全的——适配器会根据 MC 版本自动选择正确的存储策略。DataField<T>—— 类型化的字段句柄。NBT 字符串键封装在句柄内部——调用站点没有字符串字面量。字段引用中的拼写错误是编译错误,而不是静默的默认值。EntityDataSchema—— 声明定义实体家族保存数据的有序DataField<?>句柄集。写入和读取都通过模式进行——保存/加载方法中不会出现字段名。MigrationStep/MigrationChain—— 唯一的迁移权限机构。每个步骤接收并返回一个DataCompound,从而实现跨字段迁移。刻意排除了按字段迁移器——迁移逻辑应仅在此处存在。FieldValueProvider/FieldValueConsumer—— 用于实体与模式通信的类型化接口。调用站点没有字符串键。
新增:骨骼可见性功能 (ADR_022)
BoneVisibilityFeature—— 附加到NativeEntityFamily的声明式单骨骼显示/隐藏规则。在NativeModel.setCustomAnimations()的每一帧中求值。BoneCondition——@FunctionalInterface,在客户端每渲染帧求值。必须快速——不进行世界查询,不分配内存。BoneRule—— 将骨骼名称与BoneCondition以及隐藏/显示极性配对。
替换了所有基于反射的骨骼访问(通过反射调用 getBone / setHidden)。GeckoLib 类型保留在其所属的加载器模块中——BoneVisibilityFeature 及其条件在 HZLib Common 中是纯 Java。
新增:待机槽动画系统 (ADR_022)
用声明式待机状态配置单元替换基于刻度的待机逻辑(handleStandbyAnimation())。从结构上消除了待机动画闪烁。
IdleCondition——@FunctionalInterface,针对每个移动控制器刻度求值。IdleSlot—— 将AnimationPool与IdleCondition、优先级以及以刻度为单位的激活阈值配对。高优先级槽位优先求值;只有当条件持续满足阈值持续时间后,槽位才会激活。NativeEntity上的idleStationaryTicks—— 当实体未移动且不在载具中时,每刻递增;移动时重置。IdleSlot阈值比较基于此计数器——一旦跨越即保持稳定,无需每帧重新求值。AnimationProfile获得idleSlots—— 现有的.idle()简写隐式创建了一个优先级为 0、始终为真、阈值为零的槽位,保证每个配置单元都有后备方案。NativeEntity上的onIdleSlotChanged()钩子 —— 当获胜的待机槽位发生变化时调用;在子类中重写以作出反应(例如,在坐/站转换时更新碰撞箱)。
新增:NativeEntityFamily 上的 headBoneName
用于 NativeModel.setCustomAnimations() 中追踪视线的头部骨骼名称,现在是家族描述符上的可配置字段(.headBone("head_bone_name"))。消除了嵌入在模型代码中的硬编码 "head" 字符串。所有现有家族默认值为 "head" —— 无需迁移。
新增:条件性和组合外观功能
ConditionalAppearanceFeature—— 根据针对实体状态求值的运行时条件切换当前外观。CompositeAppearanceFeature—— 将多个外观层组合成单一解析后的外观。
已知问题 / 延期
hzlib.api.entity.dynamic.*和hzlib.api.entity.monsters.*包包含已确认无用的死代码,且没有任何消费者使用。这些代码在当前版本中保留,但将在未来的清理版本中标记为删除。IInternalRenderLayer的重命名工作已推迟。nativeEntity字段的重命名工作已推迟。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧