HZLib

0.1.0-alpha — 2026-06-24

Minecraft 1.21.1

Initial alpha release. This is the first public build of HZLib — the shared library foundation for all Heria Zone mods.

Entity Framework

• NativeEntityType<T> — base entity type with feature composition, stat configuration, and variant management
• NativeEntity — base entity class with finalizeSpawn() lifecycle hook and initializeSpawnVariants()
• EntityFeature base class with feature composition via withFeature(Class, Feature)

Variant System

• TextureVariantFeature, ModelVariantFeature, AnimatorVariantFeature — data-driven variant registration
• SizeVariantFeature with SizeConfig — dynamic hitbox management, per-pose EntityDimensions, stat multipliers, O(1) lookup
• AnimatorVariantFeature supports optional AnimationProfile per variant (backward compatible)

Animation Profile System

• AnimationPool, WeightedAnimation, SelectionStrategy (RANDOM, WEIGHTED_RANDOM, SEQUENTIAL), LoopBehavior
• AnimationProfile with full builder API — named slots (idle, walk, rest, sit, ride, attack, hurt), null-safe fallback via getAnimationForState()
• AnimationSequence, SequenceStep, SequenceState — pull-model exit conditions via Predicate<LivingEntity>
• ISpecialAnimation marker interface
• Zero GeckoLib/Minecraft imports in core profile classes — pure Java

Progression and Combat Features

• LevelFeature, CombatLevelFeature — entity levelling with attribute scaling
• LinearAttributeStrategy, ExponentialAttributeStrategy — pluggable scaling curves
• ProtectionFeature, LevelBasedProtectionStrategy, EnchantmentProtectionCalculator — damage type resistance with enchantment integration

Platform Services

• IPlatformServices — cross-loader abstraction for creative tabs, entity/item/recipe/command registration, config, and networking
• Service locator pattern (Services.java) for clean loader-agnostic access

Utilities

• Math, NBT, validation, and config bounds utilities in the Common module