HZLib
Shared multi-loader library for Heria Zone mods — Fabric, Forge, and NeoForge
Issues · What It Provides · Dependency Map · Version Support · For Mod Developers
⚠️ In Development HZLib is in active development. The API is not yet frozen — breaking changes may occur between versions. Not recommended for third-party mods until a stable API release is announced.The codebase currently lives inside the reboot-lovely-robot monorepo under
sources/common/hzlib-1.21.1/. It will be extracted to its own repository once stable.
HZLib is the shared foundation that all Heria Zone mods are built on. It provides a loader-agnostic entity framework, variant system, animation profiles, NBT data pipeline, and platform abstractions — written once, working across Forge, NeoForge, and Fabric without duplication.
If you're playing a Heria Zone mod, this is the engine underneath it. It does nothing on its own.
NativeEntity— root entity base classNativeEntityFamily<T>— family descriptor with feature composition, stat configuration, and variant managementEntityFeature— composable feature system viawithFeature(Class, Feature)
TextureVariantFeature,ModelVariantFeature,AnimatorVariantFeature— data-driven variant registrationSizeVariantFeaturewithSizeConfig— dynamic hitbox management, per-poseEntityDimensions, stat multipliers, O(1) lookupConditionalAppearanceFeature— switches active appearance based on runtime conditionsCompositeAppearanceFeature— composes multiple appearance layers into a single resolved appearance
AnimationProfile— named slots (idle, walk, rest, sit, ride, attack, hurt) with full builder API and null-safe fallbackIdleSlot/IdleCondition— declarative idle state system; replaces tick-driven standby logicAnimationPool,WeightedAnimation,SelectionStrategy(RANDOM, WEIGHTED_RANDOM, SEQUENTIAL),LoopBehaviorBoneVisibilityFeature— declarative per-bone show/hide rules evaluated each render frame- Zero GeckoLib or Minecraft imports in core profile classes — pure Java
DataCompound— version-agnostic NBT wrapper; zero MC imports in pipeline codeDataField<T>— typed field handles; string key encapsulated, zero literals at call sitesEntityDataSchema— ordered field registry; write/read viaDataCompoundMigrationChain/MigrationStep— sole migration authority; cross-field capable- Version-safe UUID storage across all supported MC versions
LevelFeature,CombatLevelFeature— entity levelling with attribute scalingLinearAttributeStrategy,ExponentialAttributeStrategy— pluggable scaling curvesProtectionFeature,LevelBasedProtectionStrategy,EnchantmentProtectionCalculator
IPlatformServices— cross-loader abstraction for entity/item/recipe/command registration, config, events, and networking- Service locator pattern (
Services.java) for clean loader-agnostic access
HZLib (this library)
│
├── HZLib: Animate (optional — GeckoLib adapter, planned)
│ ├── LovelyLib
│ │ ├── Lovely Robot: Legacy
│ │ ├── Lovely Robot: Tribute
│ │ └── Lovely Robot: Reboot
│ └── Monsters & Girls
│
├── Cubelings (vanilla renderer — no HZLib: Animate needed)
├── Reignited HUD (UI only — no HZLib: Animate needed)
└── [future Heria Zone mods]
HZLib core has zero GeckoLib imports. Mods with Blockbench-animated entities will use the optional HZLib: Animate adapter layer (planned). Mods using vanilla rendering only depend on HZLib core.
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | ✅ v1.0.0 | ✅ v1.0.0 | ✅ v1.0.0 |
| 1.20.1 | Planned | Planned | — |
| 1.19.4 | Planned | Planned | — |
| 1.19.2 | Planned | Planned | — |
| 1.18.2 | Planned | Planned | — |
| 1.17.1 | Planned | Planned | — |
| 1.16.5 | Planned | Planned | — |
| 1.12.2 | — | Planned | — |
| 1.7.10 | — | Planned | — |
Backport priority follows the dependent mods. 1.21.1 is the reference implementation. Backports down to 1.16.5 come first, then 1.12.2 and 1.7.10 as long-term targets.
HZLib is published on CurseForge and Modrinth but the API is not yet frozen. Third-party mods should wait for a stable API release before building against it.
Once the API is stable, HZLib will be:
- Extracted to its own GitHub repository
- Published to a public Maven repository
- Documented with developer guides and API references
Follow the Heria Zone Discord or Patreon for updates.
See CONTRIBUTING.md and CONTRIBUTORS.md.
Report bugs via GitHub Issues — hosted in the reboot-lovely-robot repo until HZLib has its own.
Licensed under the GNU Lesser General Public License v3.0 (LGPL v3).
You are free to use HZLib in your mod, modify it, and distribute it — as long as modifications to HZLib itself are shared under the same license and credit is given to the original authors.
See LICENSE for the full terms.
Developed by MSymbios / Heria Zone.