Halo Customed

Full Changelog: Here

• Fixed SYNC sync_offset being applied around the wrong axes when the initial head pose changes. Rotation offsets now use head-local axes while retaining first-frame capture, subsequent head following and identity-offset behavior.
• Fixed LOCKED halos such as the bundled mesh_demo suddenly reversing around their normal during slow, tiny pitch changes near straight ahead and remaining reversed at rest. Polar offsets now use head-forward as their reference; the existing nonpolar orientation rules and damping are preserved.
• Changing the effective offset, orientation mode or sync_offset on resource reload now reinitializes motion on the next valid frame. Equipped halos and animation progress are retained; unrelated resource changes keep existing motion.
• Applied the shared orientation correction to world rendering and previews. Halo definitions, saves, network payloads and public API v2 remain compatible.
• Pinned HaloCore to 2.5.1 / 59e3bb2e and restarted this core version's adapter revision at 1. Players still install a single Halo JAR for Minecraft 1.20.1 Forge.
• All 347 core tests passed. This platform passed 130 automated adapter tests, with 2 explicitly skipped external-fixture checks, plus all 15 targeted native singleplayer scenarios and its cloud build. Dedicated-server and third-party mod combinations were not revalidated in this round.

Requires Java 17 or newer for Minecraft 1.20.1 Forge. Built and tested with Forge 47.4.0.

• 修复 SYNC 在不同初始头部姿态下将 sync_offset 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。
• 修复内置 mesh_demo 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。
• 资源重载改变有效定位偏移、朝向模式或 sync_offset 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。
• 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。
• 固定 HaloCore 2.5.1 / 59e3bb2e，并将该 core 版本的 adapter revision 从 1 重新开始。Minecraft 1.20.1 Forge 玩家仍只需安装一个 Halo JAR。
• core 的 347 项测试通过；本平台 130 项适配器自动测试、15 个原生单人专项场景及云端构建通过，另有 2 项外部测试包检查明确跳过。本轮未重新验收专用服及第三方模组组合。

Minecraft 1.20.1 Forge 需要 Java 17 或更高版本。本轮构建与游戏验证使用 Forge 47.4.0。