Halo

v1.0.0 — First Stable Release

Architecture

• Package renamed to network.azusake.halo
• Decoupled halo position calculation from rendering via AnchorFrame / AnchorFrameCalculator
• Multi-layer halo system with independent per-layer position, rotation, scale, and glowing toggle
• Billboard primitive that always faces the camera

Orientation Modes

• locked — halo follows entity yaw rotation
• free — halo floats independently
• sync — halo normal-axis spin tracks entity yaw, pitch/roll remain independent

Animation System

• AnimationTerm sealed interface with sin, cos, and linear term types
• Per-layer and definition-level animation blocks with offset (x/y/z) and rotation (yaw/pitch/roll) axes
• linear terms support an optional start parameter for custom initial rotation angles
• Multiple terms on the same axis are summed via linear superposition
• Animation time uses elapsed time since halo creation, avoiding floating-point precision drift

Built-in Definitions

• ring_default — 7-layer clock-ring design with concentric rings rotating at staggered speeds

Fixes

• Halo no longer flips position at extreme pitch angles (±90°)
• Halo position resets reliably after teleporting cross-dimension or long distances
• Server reload no longer overwrites client-loaded definitions (each source independently tracks its own entries)
• Missing halo definitions trigger immediate deactivation rather than per-frame error spam
• Removed duplicate definition file that could cause data-pack vs resource-pack conflicts

JSON Format

All halo definitions moved to data/halo/halo_definitions/. Animations use function-based term arrays under animation.offset and animation.rotation nodes. Single-layer definitions remain backward-compatible.