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 Fabric.
• All 347 core tests passed. This platform passed 126 automated adapter tests, with 1 explicitly skipped external-fixture check, plus all 15 targeted native singleplayer scenarios and its cloud build. Dedicated-server and third-party mod combinations were not revalidated in this round. The maintainer also manually confirmed that both bugs were resolved on 2026-10-22.

Requires Java 17 or newer and Fabric API for Minecraft 1.20.1 Fabric. Built and tested with Fabric Loader 0.15.11 and Fabric API 0.92.0+1.20.1.

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

需要 Java 17 或更高版本，以及适用于 Minecraft 1.20.1 Fabric 的 Fabric API。本轮构建与游戏验证使用 Fabric Loader 0.15.11 和 Fabric API 0.92.0+1.20.1。