ВЕРСИИ (86)

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.1-fabric-1.21.1-adapter.1...v2.6.0-fabric-1.21.1-adapter.1) --- - Added optional Flashback and ReplayMod compatibility for **Minecraft 1.21.1 Fabric**, using one shared API v2 replay contract and recording track. Record effective equipment, startup/shutdown progress and the scepter's actual open/close lifecycle. - Playback and offline export advance animation/physics by recording source time, including speed changes, independently of real rendering time. Paused sources and repeated views stay stationary; seeks restore relative progress and rebuild physics at the target anchor. - Added ReplayMod Full/Quick indexing and marker-baseline rewriting, plus Flashback snapshot and output-frame hooks. Playback isolates local ownership/C2S writes; export suppresses Halo's interactive UI. - Fixed periodic Halo snapping/resetting in ReplayMod playback and export when passing full checkpoints. Continuous playback now retains physical inertia; seeks and missing-event recovery still restore snapshots. Existing recordings containing the Halo track can be reused. Older recordings lack a complete initial state/UI track and retain best-effort behavior. - Pinned HaloCore to **2.6.0 / 03f84db5**, adapter revision **1**. Existing halo definitions, saves, online packets and API v2 signatures remain compatible. Players install only the Halo mod JAR; recorder mods are optional and not bundled. - All **364 core tests passed**. Local adapter checks covered **136 tests: 135 passed, 1 external YSM-fixture check skipped**, including actual ABI checks against ReplayMod **1.21-2.6.28** and Flashback **0.39.10** separately. The maintainer confirmed the snap fix and no further observed anomalies. Unreported trimming, multiview, shader and other mod combinations are not claimed as fully validated; 1.20.1 shared integration is committed separately without a release. Requires **Java 21** or newer and Fabric API for **Minecraft 1.21.1 Fabric**. Built with Fabric Loader 0.16.14 / Fabric API 0.116.15+1.21.1; isolated production startup checks used Fabric Loader 0.19.3. Test the two recorder mods separately. --- - 为 **Minecraft 1.21.1 Fabric** 添加可选 Flashback 与 ReplayMod 兼容，两个后端共用 API v2 回放契约及录像轨道，记录最终佩戴、启动/关闭进度和权杖实际开关。 - 普通回放与离线导出都按录像源时间推进动画和物理，随录像倍速变化且独立于实际渲染耗时；暂停及同帧重复视角不额外推进，跳转恢复相对进度并在目标锚点重建物理。 - 接入 ReplayMod Full/Quick 索引和 marker 起点快照重写，以及 Flashback 快照/输出帧边界。回放隔离本地恢复和 C2S 写回，导出抑制 Halo 交互界面。 - 修复 ReplayMod 回放/导出经过周期完整快照时光环 snap 或复位：连续播放保留物理惯性，跳转和缺失事件补齐仍恢复快照。已有 Halo 轨道的录像无需重录；旧录像缺少完整初始状态/UI 轨道，仍只能尽力回放。 - 固定 HaloCore **2.6.0 / 03f84db5**，适配修订为 **1**。既有定义、存档、在线数据包及 API v2 签名保持兼容。玩家只安装 Halo 模组成品；回放模组可选且不内嵌。 - **364 项 core 测试通过**；本地适配器共 **136 项，135 通过、1 项外部 YSM 测试包检查跳过**，包含分别针对 ReplayMod **1.21-2.6.28** 和 Flashback **0.39.10** 官方 JAR 实际运行的 ABI 检查。维护者确认 snap 消失且未观察到其它异常；未逐项报告的裁剪、多视角、光影及其它模组组合不扩大声明。1.20.1 只另行保存共享接入提交，不发布成品。 需要 **Java 21** 或更高版本，以及适用于 **Minecraft 1.21.1 Fabric** 的 Fabric API。构建使用 Fabric Loader 0.16.14 / Fabric API 0.116.15+1.21.1；隔离成品启动检查使用 Fabric Loader 0.19.3。两个回放模组分别测试。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-neoforge-26.2-adapter.2...v2.5.1-neoforge-26.3-adapter.1) --- - First Minecraft 26.3 NeoForge release, adapting the existing renderer to RenderPearl while retaining halo definitions, ownership and API v2 behavior. The comparison starts at the previous 26.2 NeoForge release. - 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 26.3 NeoForge**. - All 347 core tests passed. This platform passed 146 automated adapter tests, 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 25** or newer for **Minecraft 26.3 NeoForge**. Built and tested with NeoForge 26.3.0.64-beta. Cloud CI also checks NeoForge 26.3.0.76. Existing Sodium 0.9.2 / 0.9.3-alpha.1 shader combinations require 26.3.0.64-beta; they are incompatible with 26.3.0.65 and later. --- - 首次发布 Minecraft 26.3 NeoForge 版本，将现有绘制接入 RenderPearl，保留光环定义、佩戴关系与 API v2 行为；完整变更链接从此前 26.2 NeoForge 发布版本开始比较。 - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.3 NeoForge** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 146 项适配器自动测试、15 个原生单人专项场景及云端构建通过。本轮未重新验收专用服及第三方模组组合。 **Minecraft 26.3 NeoForge** 需要 **Java 25** 或更高版本。本轮构建与游戏验证使用 NeoForge 26.3.0.64-beta。 云端 CI 另检查 NeoForge 26.3.0.76。现有 Sodium 0.9.2／0.9.3-alpha.1 光影组合须使用 26.3.0.64-beta，与 26.3.0.65 及以后版本不兼容。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-fabric-26.3-adapter.2...v2.5.1-fabric-26.3-adapter.1) --- - 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 26.3 Fabric**. - All 347 core tests passed. This platform passed 140 automated adapter tests, 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 25** or newer and Fabric API for **Minecraft 26.3 Fabric**. Built and tested with Fabric Loader 0.19.5 and Fabric API 0.160.6+26.3. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.3 Fabric** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 140 项适配器自动测试、15 个原生单人专项场景及云端构建通过。本轮未重新验收专用服及第三方模组组合。 需要 **Java 25** 或更高版本，以及适用于 **Minecraft 26.3 Fabric** 的 Fabric API。本轮构建与游戏验证使用 Fabric Loader 0.19.5 和 Fabric API 0.160.6+26.3。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-neoforge-26.2-adapter.2...v2.5.1-neoforge-26.2-adapter.1) --- - 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 26.2 NeoForge**. - All 347 core tests passed. This platform passed 142 automated adapter tests, 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 25** or newer for **Minecraft 26.2 NeoForge**. Built and tested with NeoForge 26.2.0.59. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.2 NeoForge** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 142 项适配器自动测试、15 个原生单人专项场景及云端构建通过。本轮未重新验收专用服及第三方模组组合。 **Minecraft 26.2 NeoForge** 需要 **Java 25** 或更高版本。本轮构建与游戏验证使用 NeoForge 26.2.0.59。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-fabric-26.2-adapter.2...v2.5.1-fabric-26.2-adapter.1) --- - 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 26.2 Fabric**. - All 347 core tests passed. This platform passed 136 automated adapter tests, 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 25** or newer and Fabric API for **Minecraft 26.2 Fabric**. Built and tested with Fabric Loader 0.19.3 and Fabric API 0.157.0+26.2. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.2 Fabric** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 136 项适配器自动测试、15 个原生单人专项场景及云端构建通过。本轮未重新验收专用服及第三方模组组合。 需要 **Java 25** 或更高版本，以及适用于 **Minecraft 26.2 Fabric** 的 Fabric API。本轮构建与游戏验证使用 Fabric Loader 0.19.3 和 Fabric API 0.157.0+26.2。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-neoforge-26.1.2-adapter.2...v2.5.1-neoforge-26.1.2-adapter.1) --- - 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 26.1.2 NeoForge**. - All 347 core tests passed. This platform passed 140 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. Requires **Java 25** or newer for **Minecraft 26.1.2 NeoForge**. Built and tested with NeoForge 26.1.2.95. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.1.2 NeoForge** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 140 项适配器自动测试、15 个原生单人专项场景及云端构建通过，另有 1 项外部测试包检查明确跳过。本轮未重新验收专用服及第三方模组组合。 **Minecraft 26.1.2 NeoForge** 需要 **Java 25** 或更高版本。本轮构建与游戏验证使用 NeoForge 26.1.2.95。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-fabric-26.1-adapter.2...v2.5.1-fabric-26.1-adapter.1) --- - 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 26.1.2 Fabric**. - All 347 core tests passed. This platform passed 131 automated adapter tests, 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 25** or newer and Fabric API for **Minecraft 26.1.2 Fabric**. Built and tested with Fabric Loader 0.19.3 and Fabric API 0.155.3+26.1.2. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 26.1.2 Fabric** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 131 项适配器自动测试、15 个原生单人专项场景及云端构建通过。本轮未重新验收专用服及第三方模组组合。 需要 **Java 25** 或更高版本，以及适用于 **Minecraft 26.1.2 Fabric** 的 Fabric API。本轮构建与游戏验证使用 Fabric Loader 0.19.3 和 Fabric API 0.155.3+26.1.2。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-neoforge-1.21.1-adapter.2...v2.5.1-neoforge-1.21.1-adapter.1) --- - 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.21.1 NeoForge**. - All 347 core tests passed. This platform passed 129 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. Requires **Java 21** or newer for **Minecraft 1.21.1 NeoForge**. Built and tested with NeoForge 21.1.248. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 1.21.1 NeoForge** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 129 项适配器自动测试、15 个原生单人专项场景及云端构建通过，另有 1 项外部测试包检查明确跳过。本轮未重新验收专用服及第三方模组组合。 **Minecraft 1.21.1 NeoForge** 需要 **Java 21** 或更高版本。本轮构建与游戏验证使用 NeoForge 21.1.248。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-fabric-1.21.1-adapter.2...v2.5.1-fabric-1.21.1-adapter.1) --- - 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.21.1 Fabric**. - All 347 core tests passed. This platform passed 128 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. Requires **Java 21** or newer and Fabric API for **Minecraft 1.21.1 Fabric**. Built and tested with Fabric Loader 0.16.14 and Fabric API 0.116.15+1.21.1. --- - 修复 SYNC 在不同初始头部姿态下将 `sync_offset` 应用到错误旋转轴的问题。偏移现按头部局部轴组合，保留首帧捕获、后续随头部旋转及单位偏移的既有语义。 - 修复内置 `mesh_demo` 等 LOCKED 光环在正视前方附近缓慢、小幅俯仰时突然沿法线反向，且静止后持续反向的问题。极点偏移改用头部前向作为参考，保留非极点朝向规则和原有阻尼。 - 资源重载改变有效定位偏移、朝向模式或 `sync_offset` 后，在下一有效帧重新初始化运动状态；保留佩戴关系与动画进度，无关资源变化继续保留原有运动状态。 - 世界渲染和预览共用修正后的朝向计算。既有光环定义、存档、网络载荷及公开 API v2 保持兼容。 - 固定 HaloCore **2.5.1 / 59e3bb2e**，并将该 core 版本的 adapter revision 从 **1** 重新开始。**Minecraft 1.21.1 Fabric** 玩家仍只需安装一个 Halo JAR。 - core 的 347 项测试通过；本平台 128 项适配器自动测试、15 个原生单人专项场景及云端构建通过，另有 1 项外部测试包检查明确跳过。本轮未重新验收专用服及第三方模组组合。 需要 **Java 21** 或更高版本，以及适用于 **Minecraft 1.21.1 Fabric** 的 Fabric API。本轮构建与游戏验证使用 Fabric Loader 0.16.14 和 Fabric API 0.116.15+1.21.1。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-forge-1.20.1-adapter.4...v2.5.1-forge-1.20.1-adapter.1) --- - 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。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.5.0-fabric-1.20.1-adapter.3...v2.5.1-fabric-1.20.1-adapter.1) --- - 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。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-26.3-adapter.1...v2.5.0-fabric-26.3-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 26.3 Fabric**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 25** or newer, Fabric Loader 0.19.5 or newer, and Fabric API. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 26.3 Fabric** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 25** 或更高版本、Fabric Loader 0.19.5 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-neoforge-26.2-adapter.1...v2.5.0-neoforge-26.2-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 26.2 NeoForge**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 25** or newer and NeoForge 26.2.0.59 or newer for Minecraft 26.2. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 26.2 NeoForge** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 25** 或更高版本，以及适用于 Minecraft 26.2 的 NeoForge 26.2.0.59 或更高版本。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-26.2-adapter.1...v2.5.0-fabric-26.2-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 26.2 Fabric**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 25** or newer, Fabric Loader 0.19.3 or newer, and Fabric API. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 26.2 Fabric** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 25** 或更高版本、Fabric Loader 0.19.3 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-neoforge-26.1.2-adapter.1...v2.5.0-neoforge-26.1.2-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 26.1.2 NeoForge**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 25** or newer and NeoForge 26.1.2.95 or newer for Minecraft 26.1.2. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 26.1.2 NeoForge** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 25** 或更高版本，以及适用于 Minecraft 26.1.2 的 NeoForge 26.1.2.95 或更高版本。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-26.1-adapter.1...v2.5.0-fabric-26.1-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 26.1.2 Fabric**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 25** or newer, Fabric Loader 0.19.3 or newer, and Fabric API. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 26.1.2 Fabric** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 25** 或更高版本、Fabric Loader 0.19.3 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-neoforge-1.21.1-adapter.1...v2.5.0-neoforge-1.21.1-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 1.21.1 NeoForge**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 21** or newer and NeoForge 21.1.248 or newer for Minecraft 1.21.1. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 1.21.1 NeoForge** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 21** 或更高版本，以及适用于 Minecraft 1.21.1 的 NeoForge 21.1.248 或更高版本。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-1.21.1-adapter.1...v2.5.0-fabric-1.21.1-adapter.2) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 1.21.1 Fabric**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 21** or newer, Fabric Loader 0.16.14 or newer, and Fabric API. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 1.21.1 Fabric** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 21** 或更高版本、Fabric Loader 0.16.14 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-forge-1.20.1-adapter.3...v2.5.0-forge-1.20.1-adapter.4) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 1.20.1 Forge**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 17** or newer and Forge 47.4.0 or newer for Minecraft 1.20.1. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 1.20.1 Forge** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 17** 或更高版本，以及适用于 Minecraft 1.20.1 的 Forge 47.4.0 或更高版本。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-1.20.1-adapter.2...v2.5.0-fabric-1.20.1-adapter.3) --- - Fixed halos disappearing from healthy non-player entities after leaving their client tracking range and returning. Minecraft marks the client entity as removed before the unload callback, which also makes isAlive() return false; Halo previously treated that as death and deleted its equipped-halo record. - Ordinary unloading now clears the visual instance, physics and captured anchors while preserving the UUID-to-halo assignment. Tracking the entity again restores its halo through normal rendering frames, without re-equipping, resource reloading, a new attach packet or reconnecting. - Kept confirmed non-player death, player death/respawn, explicit removal and disconnect handling intact. Added five lifecycle regression cases, including three consecutive tracking-range round trips with a new entity runtime ID and no second attach message. - Updated the pinned HaloCore to **2.5.0 / a22160a8**. Its optional ScenePort output provides stable draw identities, shared local geometry, double-precision world origins and explicit transforms/materials for rendering integrations. Existing raster output and public API remain compatible; HaloCore now packages its MIT notice, which is also retained in the merged Halo runtime JAR. - Preserved existing halo definitions, saves, network payloads and anchor API v2. Players still install a single Halo JAR for **Minecraft 1.20.1 Fabric**. - This platform's automated build/packaging/compatibility checks and all five lifecycle cases passed. The user confirmed the concentrated in-game test round passed on 2026-10-09. External mod signature checks remain skipped where their fixture JARs are unavailable; unrelated rendering combinations and performance are not claimed as newly tested. - Flashback's missing halo state at the start of a recording remains a separate issue; this release does not add recording snapshots or claim complete Flashback compatibility. Requires **Java 17** or newer, Fabric Loader 0.15.11 or newer, and Fabric API. --- - 修复健康非玩家实体离开客户端追踪范围、返回后光环消失的问题。Minecraft 在卸载回调之前已将客户端实体标记为移除，isAlive() 因此也会返回 false；Halo 原先将其误判为死亡并删除佩戴记录。 - 普通卸载现在只清理绘制实例、物理状态和捕获的锚点，保留 UUID 与光环定义的佩戴关系。实体重新进入追踪范围后由正常渲染帧自动恢复，无需重新佩戴、资源重载、新的挂载包或重连。 - 保留非玩家明确死亡、玩家死亡重生、主动摘除和断开连接的既有语义。新增五项生命周期回归，包含连续三轮追踪范围往返、更换实体运行 ID 且不再次接收挂载通知的场景。 - 将 HaloCore 精确升级到 **2.5.0 / a22160a8**。新增可选 ScenePort 场景输出，为渲染接入提供稳定绘制标识、共享局部几何、double 世界原点及明确的变换/材质；既有光栅输出与公开接口保持兼容，HaloCore 的 MIT 许可证随合并后的 Halo 运行包一同分发。 - 保留既有光环定义、存档、网络包和锚点 API v2。**Minecraft 1.20.1 Fabric** 玩家仍只需安装一个 Halo JAR。 - 本平台自动构建、合包、兼容检查及五项生命周期回归通过；用户于 2026-10-09 确认本轮集中游戏测试通过。缺少外部模组测试 JAR 的签名检查仍保持跳过，不扩大为无关渲染组合或性能已重新验收。 - Flashback 录制起点缺少光环状态仍是独立问题；本版本尚未接入录制快照，不宣称已完整兼容 Flashback。 需要 **Java 17** 或更高版本、Fabric Loader 0.15.11 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-fabric-1.20.1-adapter.1...v2.4.2-fabric-1.20.1-adapter.2) --- - Fixed a JVM crash while preparing Halo's cached mesh generations. On 1.20.1 Halo owns the upload staging buffer's native memory because the platform has no `BufferAllocator`/`ByteBufferBuilder`; `MeshUploadBuffer.close()` freed that block but left its address in `BufferBuilder`, so any later cleanup path reading the same buffer - ModernFix injects a `BufferBuilder.finalize` that calls `UnsafeBufferHelper.free` - freed the same memory a second time and killed the process inside `jemalloc` with an `EXCEPTION_ACCESS_VIOLATION` (`Finalizer` thread, `jemalloc.dll`). - `MeshUploadBuffer.close()` now takes the buffer out of the builder (new `BufferBuilderStorageAccessor.halo$setStorage`) before releasing it, so the release is idempotent and no dangling address survives. The explicit release itself is kept: removing it would leak this native staging memory on every generation, because LWJGL's `memByteBuffer` registers no Java-side cleaner for these buffers on 1.20.1. - The lit stream now sizes its staging buffer by the corners it actually writes. `QUADS` mode writes four corners per quad while the index buffer expands to six, so sizing by index count always forced a `BufferBuilder` growth, and growth reallocates through `MemoryTracker.realloc`, freeing the initial block behind the wrapper's back. A new capacity regression test pins the formula. - Scope: `render/MeshUploadBuffer`, `render/HaloMeshBufferCache` and the `BufferBuilderStorageAccessor` mixin only. HaloCore pin `1d3cf90` (2.4.2), definition schema, saves, networking, anchor API v2 and every other render path are unchanged. Minecraft 1.20.1 Fabric players still install a single Halo JAR. - Automated tests passed on this platform (core and Halo suites; the external YSM 2.6.5 signature check stays skipped without `HALO_YSM_TEST_JAR`). The user reproduced the crash on the previous build and retested this one in the affected modpack; the large-mesh startup scenario no longer crashes. Requires **Java 17** or newer, and Fabric Loader 0.15.11 or newer with Fabric API. --- - 修复缓存 mesh 代次准备阶段的 JVM 崩溃。1.20.1 没有 `BufferAllocator`/`ByteBufferBuilder`，上传暂存的原生内存由 Halo 自己持有；`MeshUploadBuffer.close()` 释放了这块内存，却把地址留在 `BufferBuilder` 里，任何随后读取同一 buffer 的清理路径——ModernFix 注入的 `BufferBuilder.finalize` 会调用 `UnsafeBufferHelper.free`——就会对同一块内存二次释放，进程在 `jemalloc` 内以 `EXCEPTION_ACCESS_VIOLATION` 结束（`Finalizer` 线程，`jemalloc.dll`）。 - `MeshUploadBuffer.close()` 改为先把 buffer 从 builder 取出（新增 `BufferBuilderStorageAccessor.halo$setStorage`）再释放，释放因此幂等，也不再留下悬垂地址。显式释放这一优化被保留：1.20.1 上 LWJGL 的 `memByteBuffer` 不会为这些缓冲注册 Java 侧清理器，删掉释放会让每代次的原生暂存内存泄漏。 - lit 流改为按实际写入的角数预分配暂存容量。`QUADS` 模式每个四边形写四个角而索引缓冲扩展为六个，按索引数预分配必然触发 `BufferBuilder` 增长，而增长经 `MemoryTracker.realloc` 会在包装器背后释放初始块。新增容量回归测试锁定该公式。 - 改动范围仅限 `render/MeshUploadBuffer`、`render/HaloMeshBufferCache` 与 `BufferBuilderStorageAccessor` mixin。HaloCore 指针 `1d3cf90`（2.4.2）、定义 schema、存档、网络、锚点 API v2 及其余渲染路径均不变。Minecraft 1.20.1 Fabric 玩家仍只需安装一个 Halo JAR。 - 本平台自动测试通过（core 与 Halo 测试套件；未提供 `HALO_YSM_TEST_JAR` 时外部 YSM 签名检查保持跳过）。用户已在受影响整合包中复现旧版本崩溃，并用本版本复测，大网格启动场景不再崩溃。 需要 **Java 17** 或更高版本，Fabric Loader 0.15.11 或更高版本，以及 Fabric API。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-forge-1.20.1-adapter.2...v2.4.2-forge-1.20.1-adapter.3) --- - Fixed a JVM crash while preparing Halo's cached mesh generations. On 1.20.1 Halo owns the upload staging buffer's native memory because the platform has no `BufferAllocator`/`ByteBufferBuilder`; `MeshUploadBuffer.close()` freed that block but left its address in `BufferBuilder`, so any later cleanup path reading the same buffer - ModernFix injects a `BufferBuilder.finalize` that calls `UnsafeBufferHelper.free` - freed the same memory a second time and killed the process inside `jemalloc` with an `EXCEPTION_ACCESS_VIOLATION` (`Finalizer` thread, `jemalloc.dll`). The bundled 1.20.1 modpack reproduced this on three consecutive launches with `hs_err_pid*.log` reports at `jemalloc.dll+0x15f8f`. - `MeshUploadBuffer.close()` now takes the buffer out of the builder (new `BufferBuilderStorageAccessor.halo$setStorage`) before releasing it, so the release is idempotent and no dangling address survives. The explicit release itself is kept: removing it would leak this native staging memory on every generation, because LWJGL's `memByteBuffer` registers no Java-side cleaner for these buffers on 1.20.1. - The lit stream now sizes its staging buffer by the corners it actually writes. `QUADS` mode writes four corners per quad while the index buffer expands to six, so sizing by index count always forced a `BufferBuilder` growth, and growth reallocates through `MemoryTracker.realloc`, freeing the initial block behind the wrapper's back. A new capacity regression test pins the formula. - Scope: `render/MeshUploadBuffer`, `render/HaloMeshBufferCache` and the `BufferBuilderStorageAccessor` mixin only. Forge 1.20.1 specifics stay what they were (Mojang official mappings, `getVertexSize()`, `VertexFormat.Mode`). HaloCore pin `1d3cf90` (2.4.2), definition schema, saves, networking, anchor API v2, the adapter 2 YSM fix and every other render path are unchanged. Minecraft 1.20.1 Forge players still install a single Halo JAR. - Automated tests passed on this platform (core and Halo suites, flat core packaging and provenance, Forge API v2 consumer, legacy anchor API; external EMF/YSM signature checks stay skipped without their external JARs). The user reproduced the crash on the previous build and retested this one in the affected modpack; the large-mesh startup scenario no longer crashes. Requires **Java 17** or newer, Forge 47.4.0 or newer (Minecraft 1.20.1). --- - 修复缓存 mesh 代次准备阶段的 JVM 崩溃。1.20.1 没有 `BufferAllocator`/`ByteBufferBuilder`，上传暂存的原生内存由 Halo 自己持有；`MeshUploadBuffer.close()` 释放了这块内存，却把地址留在 `BufferBuilder` 里，任何随后读取同一 buffer 的清理路径——ModernFix 注入的 `BufferBuilder.finalize` 会调用 `UnsafeBufferHelper.free`——就会对同一块内存二次释放，进程在 `jemalloc` 内以 `EXCEPTION_ACCESS_VIOLATION` 结束（`Finalizer` 线程，`jemalloc.dll`）。整合包在连续三次启动中均复现，并留下 `hs_err_pid*.log`（崩溃点固定在 `jemalloc.dll+0x15f8f`）。 - `MeshUploadBuffer.close()` 改为先把 buffer 从 builder 取出（新增 `BufferBuilderStorageAccessor.halo$setStorage`）再释放，释放因此幂等，也不再留下悬垂地址。显式释放这一优化被保留：1.20.1 上 LWJGL 的 `memByteBuffer` 不会为这些缓冲注册 Java 侧清理器，删掉释放会让每代次的原生暂存内存泄漏。 - lit 流改为按实际写入的角数预分配暂存容量。`QUADS` 模式每个四边形写四个角而索引缓冲扩展为六个，按索引数预分配必然触发 `BufferBuilder` 增长，而增长经 `MemoryTracker.realloc` 会在包装器背后释放初始块。新增容量回归测试锁定该公式。 - 改动范围仅限 `render/MeshUploadBuffer`、`render/HaloMeshBufferCache` 与 `BufferBuilderStorageAccessor` mixin。Forge 1.20.1 的映射差异（Mojang official mapping、`getVertexSize()`、`VertexFormat.Mode`）保持原样。HaloCore 指针 `1d3cf90`（2.4.2）、定义 schema、存档、网络、锚点 API v2、adapter.2 的 YSM 修复及其余渲染路径均不变。Minecraft 1.20.1 Forge 玩家仍只需安装一个 Halo JAR。 - 本平台自动测试通过（core 与 Halo 测试套件、扁平化 core 打包与来源校验、Forge API v2 调用方、旧锚点 API；缺少外部 EMF/YSM 包时其签名检查保持跳过）。用户已在受影响整合包中复现旧版本崩溃，并用本版本复测，大网格启动场景不再崩溃。 需要 **Java 17** 或更高版本，Forge 47.4.0 或更高版本（Minecraft 1.20.1）。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.2-forge-1.20.1-adapter.1...v2.4.2-forge-1.20.1-adapter.2) --- - Fixed world create/load crashes when Yes Steve Model is installed. Halo's YSM capture used `@ModifyArgs`, which generates Mixin synthetic `org.spongepowered.asm.synthetic.args.Args$1`; Forge 1.20.1 `ModuleClassLoader` often cannot resolve that class while YSM's resource reload constructs renderer subclasses, aborting datapack load with `NoClassDefFoundError`. - Replaced `@ModifyArgs` with `@Redirect` on the same base-model call site. The hook still receives the animated model and prepared `PoseStack` (including body/head yaw), then invokes the original interface default render method through a MethodHandle so rendering is unchanged and no Args synthetics are generated. - Kept the change inside `compat/ysm` only. EMF/Iris compatibility, HaloCore pin `1d3cf90` (2.4.2), definition schema, saves, networking, and public API v2 are unchanged. Minecraft 1.20.1 Forge players still install a single Halo JAR. - Note that modpacks shipping an older `halo_mod_config.json` with `experimentalYsmAnchorEnabled=false` disable precise YSM head anchors by design; set the flag to `true` for experimental YSM tracking. - Automated tests passed on this platform. The user retested with YSM in a full pack: creating a new world, entering an existing world, and YSM player/entity head yaw/pitch halo anchors all behaved correctly. --- - 修复安装 Yes Steve Model 时创建/读取世界崩溃。Halo 的 YSM 捕获原先使用 `@ModifyArgs`，会生成 Mixin 合成类 `org.spongepowered.asm.synthetic.args.Args$1`；Forge 1.20.1 的 `ModuleClassLoader` 在 YSM 资源重载构造渲染器子类时经常无法解析该类，导致数据包加载以 `NoClassDefFoundError` 中止。 - 在同一基模型调用点改为 `@Redirect`。钩子仍取得动画模型与已就绪的 `PoseStack`（含身体/头部 yaw），再经 MethodHandle 调用原接口默认渲染方法，渲染行为不变，且不再生成 Args 合成类。 - 改动仅限 `compat/ysm`。EMF/Iris 兼容、HaloCore 指针 `1d3cf90`（2.4.2）、定义 schema、存档、网络及公开 API v2 均不变。Minecraft 1.20.1 Forge 玩家仍只需安装一个 Halo JAR。 - 若整合包夹带旧版 `halo_mod_config.json` 且 `experimentalYsmAnchorEnabled=false`，按设计会关闭 YSM 精确头部锚点；需要实验性 YSM 追踪时请将该配置设为 `true`。 - 本平台自动测试全部通过。用户在含 YSM 的整合包中复测：创建新世界、进入旧世界、YSM 玩家与实体头部 yaw/pitch 光环锚点均正常。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.3-adapter.2...v2.4.2-fabric-26.3-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 26.3 Fabric. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 26.3 Fabric 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-neoforge-26.2-adapter.1...v2.4.2-neoforge-26.2-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 26.2 NeoForge. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 26.2 NeoForge 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.2-adapter.3...v2.4.2-fabric-26.2-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 26.2 Fabric. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 26.2 Fabric 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-neoforge-26.1.2-adapter.1...v2.4.2-neoforge-26.1.2-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 26.1.2 NeoForge. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 26.1.2 NeoForge 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.1-adapter.3...v2.4.2-fabric-26.1-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 26.1 Fabric. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 26.1 Fabric 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-neoforge-1.21.1-adapter.1...v2.4.2-neoforge-1.21.1-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 1.21.1 NeoForge. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 1.21.1 NeoForge 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-1.21.1-adapter.2...v2.4.2-fabric-1.21.1-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 1.21.1 Fabric. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 1.21.1 Fabric 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.0-forge-1.20.1-adapter.2...v2.4.2-forge-1.20.1-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 1.20.1 Forge. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 1.20.1 Forge 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.0-fabric-1.20.1-adapter.1...v2.4.2-fabric-1.20.1-adapter.1) --- - Fixed abrupt triangle-shaped color discontinuities on translucent meshes such as `mesh_mask_demo` at oblique viewing angles. HaloCore 2.4.2 corrects triangle-center sorting using actual projected overlap depths. - Applied the same full model-view ordering to resident GPU indices and CPU fallback, including perspective world rendering, orthographic previews, mirrored winding, and expanded vertex layouts. Lateral view changes now invalidate the sorting cache correctly. - Preserved mesh geometry, UVs, normals, alpha masks, lighting/material inputs, existing definition and save formats, network bytes, and public API v2. Players still install a single Halo JAR for Minecraft 1.20.1 Fabric. - Kept this fix scoped to ordering within a mesh. Intersecting/cyclic geometry, eye-plane crossings, and cross-mesh/world transparency remain known limitations; bounded fallback avoids unbounded overlap work. Sorting adds CPU cost, and large-scene in-game performance has not been benchmarked. - Automated visibility checks across 128 views reduced sampled ordering inversions from 2,528 to zero. This platform's build, packaging and compatibility checks passed. The user confirmed the original reported scene is fixed; separate visual acceptance for every platform, graphics backend and Iris/LabPBR combination is not claimed. --- - 修复 `mesh_mask_demo` 等半透明 mesh 在斜视角度出现突兀三角面色差的问题。HaloCore 2.4.2 根据实际投影重叠区域的深度，纠正仅按三角形中心排序导致的前后倒置。 - 常驻 GPU 索引与 CPU 回退采用一致的完整模型视图排序，覆盖透视世界、正交预览、镜像绕序和展开顶点布局；横向视图变化也会正确使排序缓存失效。 - 保留模型几何、UV、法线、alpha mask、光照/材质输入、既有定义与存档格式、网络字节及公开 API v2。Minecraft 1.20.1 Fabric 玩家仍只需安装一个 Halo JAR。 - 本次仅修复单 mesh 内的排序。相交/循环遮挡、穿过眼平面及跨 mesh/世界透明排序仍为已知边界；通过有界回退限制重叠计算。新排序增加 CPU 开销，大规模场景尚未进行游戏性能压测。 - 128 个视图的自动可见性检查中，错误排序采样从 2,528 次降至 0；本平台构建、合包与兼容检查通过。用户已确认原报告场景修复，但不据此宣称所有平台、图形后端及 Iris/LabPBR 组合均已完成独立视觉验收。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/5b20c2384093f5aea2cb12f14c9916eaf6a441da...v2.4.1-neoforge-26.2-adapter.1) --- - Ported the complete applicable 26.1 NeoForge feature set to Minecraft 26.2, requiring NeoForge 26.2.0.59 or newer and Java 25. The single JAR includes unchanged HaloCore 2.4.1; the adapter is also build-tested against NeoForge 26.2.0.88. - Adapted world extraction, deferred drawing, reverse-Z and GPU buffer/binding APIs for native OpenGL and Vulkan. Preserved quaternion-based first-person anchors and isolation between main-camera frames, shadow passes and inventory previews, so repeated passes do not advance animation or physics twice. - Retained independent native/Iris resident mesh vertex streams, lazy uploads, index reuse, mirrored winding and completed-frame CPU fallback. Adjacent legacy primitive batches are merged without changing their order; reloads, shader pipeline changes and disconnects invalidate the appropriate caches. - Updated Iris 26.2 material programs and retained LabPBR and IterationRP smooth-normal matching. Added EMF base-model identity checks to prevent cape/armor passes from replacing the head anchor, and fixed the inventory preview's initial mouse pose. No YSM integration is included because YSM is unavailable for 26.2. - Preserved definitions, configuration, source priorities, commands, scepter behavior, API v2, network payload layouts and Halo save formats. UUID strings and integer arrays remain readable; canonical integer-array writes and legacy import rules retain compatibility without restoring deleted ownership. - Verified automated builds on NeoForge .59/.88, flat-JAR packaging and legacy API calls. Native OpenGL/Vulkan and Iris/EMF visuals with IterationRP 0.8.22/0.8.28 were accepted; the user confirmed testing passed with no network synchronization or persistence issues. Quantitative stress testing was stopped at the user's request, so no FPS gain is claimed. POM remains separately unverified; Bliss and Vulkan shaders are outside this release's verified scope. --- - 将 26.1 NeoForge 中适用于目标版本的完整功能迁移至 Minecraft 26.2，最低要求 NeoForge 26.2.0.59 和 Java 25。单 JAR 内含未修改的 HaloCore 2.4.1，同时通过 NeoForge 26.2.0.88 构建验证。 - 适配世界提取、延迟绘制、reverse-Z 及 GPU 缓冲与绑定接口，支持原生 OpenGL 和 Vulkan。保留第一人称相机四元数，以及主视角、阴影 pass、物品栏预览之间的隔离，避免重复 pass 再次推进动画或物理。 - 保留原生／Iris 独立常驻 mesh 顶点流、懒上传、索引复用、镜像绕序及已完成帧的 CPU 回退；合并相邻同状态旧图元批次而不改变顺序。资源重载、光影 pipeline 变化和退出世界时正确失效对应缓存。 - 更新 Iris 26.2 材质程序，保留 LabPBR 与 IterationRP 平滑法线模式匹配。加入 EMF 主体模型身份检查，防止披风／盔甲覆盖头部锚点，并修复物品栏预览首帧鼠标姿态。由于 26.2 没有 YSM，本版本不提供 YSM 集成。 - 保留定义、配置、来源优先级、指令、权杖、API v2、网络 payload 字节布局及 Halo 存档格式。继续读取字符串和整数数组 UUID，统一写出整数数组，并保留旧路径导入及防止已删除佩戴复活的规则。 - 通过 NeoForge .59／.88 自动构建、平铺合包和旧 API 调用验证；原生 OpenGL/Vulkan、Iris/EMF 与 IterationRP 0.8.22／0.8.28 视觉验收通过。用户确认测试通过，网络同步与持久化正常。定量压测按用户要求停止，不声明 FPS 提升；POM 未单独验证，Bliss 与 Vulkan 光影不在本次已验证范围内。

**Full Changelog / 完整变更记录**: [Compare with 1.21.1 NeoForge](https://github.com/AzusaKe/Halo/compare/v2.4.1-neoforge-1.21.1-adapter.1...v2.4.1-neoforge-26.1.2-adapter.1) --- - Added support for **Minecraft 26.1.2 / NeoForge 26.1.2.95+**, using Java 25. HaloCore 2.4.1 remains bundled in a single JAR. - Preserved halo ownership, source priorities, persistence, commands and completion, local mode, scepter interactions, synchronization, animation and independent inventory previews. - Migrated rendering to the 26.1 native pipeline and GPU buffer APIs. Retained quaternion camera anchors, main/shadow/preview isolation and transparent mesh depth sorting; fixed a frame-stage ordering issue that could hide world halos. - Added resident Iris mesh geometry with separate native/Iris vertex layouts to reduce repeated vertex uploads for high-poly models. Retained IterationRP smooth-normal matching, LabPBR materials and depth compatibility. - Adapted YSM **2.6.5 NeoForge 26.1 hotfix** and EMF world/preview tracking. Optional capture is disabled with diagnostics when the installed version or ABI is incompatible. - Restored flash-compatible world saves: read both UUID integer arrays and strings, and write canonical integer arrays through the structured SavedData codec. Preserved storage identifiers and fields, the data-fix type, legacy-file import and protection against restoring deleted ownership. --- - 支持 **Minecraft 26.1.2 / NeoForge 26.1.2.95+**，使用 Java 25。单个 JAR 内含 HaloCore 2.4.1。 - 保留光环佩戴、来源优先级、持久化、指令与补全、本地模式、权杖交互、网络同步、动画及独立物品栏预览。 - 适配 26.1 原生渲染管线与 GPU 缓冲接口，保留相机四元数、主帧/阴影/预览隔离及透明 mesh 视深排序；修复帧阶段顺序导致世界光环不可见的问题。 - 同步 Iris 常驻 mesh 几何缓存，原生与 Iris 顶点布局独立管理，减少高面数模型重复上传顶点；保留 IterationRP 平滑法线匹配、LabPBR 材质及深度兼容。 - 适配 YSM **2.6.5 NeoForge 26.1 hotfix** 和 EMF 的世界/预览头部追踪。版本或 ABI 不兼容时禁用可选捕获，并给出明确诊断。 - 恢复 flash 存档兼容：同时读取整数数组和字符串 UUID，通过结构化 SavedData Codec 统一写出标准整数数组；保留存储标识、字段、数据修复类型、旧文件导入，以及防止已删除归属复活的处理。

**Full Changelog / 完整变更记录**: [Compare adapter.1 to adapter.2](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.3-adapter.1...v2.4.1-fabric-26.3-adapter.2) --- - Restored the structured 26.x SavedData codec and flash-compatible UUID integer-array output. - The decoder accepts both UUID integer arrays from flash saves and string UUIDs written by affected Fabric builds; the next save emits the canonical integer-array format readable by flash. - Preserved `halo:world_data`, `data/halo/world_data.dat`, `Halos`, `UUID`, `Definition`, and `SAVED_DATA_MAP_DATA`. Entity NBT, HaloCore, and the legacy 1.20.1 `data/halo_world_data.dat` path are unchanged. - Added multi-entry, empty-data, load-modify-save, and flash-codec round-trip regression coverage. Automated compatibility tests and the Java 25 release build passed on this branch; persistence was manually confirmed on 26.1.2. See the [migration record](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.3-adapter.2/docs/26.3-fabric-migration.md). --- - 恢复 26.x 结构化 SavedData Codec 及 flash 兼容的 UUID 整数数组写出格式。 - 同时读取 flash 存档中的整数数组 UUID 与受影响 Fabric 构建写出的字符串 UUID；下一次保存会输出 flash 可读取的标准整数数组格式。 - 保持 `halo:world_data`、`data/halo/world_data.dat`、`Halos`、`UUID`、`Definition` 和 `SAVED_DATA_MAP_DATA` 不变；实体 NBT、HaloCore 及旧版 1.20.1 的 `data/halo_world_data.dat` 路径不变。 - 增加多记录、空数据、读取后修改并保存及 flash Codec 回退读取回归测试。本分支自动兼容性测试和 Java 25 正式构建通过；26.1.2 已完成实际持久化确认。详见[迁移记录](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.3-adapter.2/docs/26.3-fabric-migration.md)。 --- **Build verification / 构建核验** - Halo: `b9d3cfa0caf3736a54cbfd45209b9e1c2870dc73` - HaloCore: `295bc579ab8d63e6dba5642ebb9e889516e90105` (2.4.1, unchanged / 未修改) - CI: [branch / 分支](https://github.com/AzusaKe/Halo/actions/runs/35509447092) · [tag / 标签](https://github.com/AzusaKe/Halo/actions/runs/35509468240) — both passed / 均通过 - Published JAR / 已发布 JAR: [`halo-26.3-fabric-2.4.1+adapter.2.jar`](https://github.com/AzusaKe/Halo/releases/download/v2.4.1-fabric-26.3-adapter.2/halo-26.3-fabric-2.4.1%2Badapter.2.jar) - Published JAR SHA-256 / 已发布 JAR SHA-256: `d3a1f76c4283e408954a830c3868f031dae0580af033e6d03a47c39190a3925c`

**Full Changelog / 完整变更记录**: [Compare adapter.2 to adapter.3](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.2-adapter.2...v2.4.1-fabric-26.2-adapter.3) --- - Restored the structured 26.x SavedData codec and flash-compatible UUID integer-array output. - The decoder accepts both UUID integer arrays from flash saves and string UUIDs written by affected Fabric builds; the next save emits the canonical integer-array format readable by flash. - Preserved `halo:world_data`, `data/halo/world_data.dat`, `Halos`, `UUID`, `Definition`, and `SAVED_DATA_MAP_DATA`. Entity NBT, HaloCore, and the legacy 1.20.1 `data/halo_world_data.dat` path are unchanged. - Added multi-entry, empty-data, load-modify-save, and flash-codec round-trip regression coverage. Automated compatibility tests and the Java 25 release build passed on this branch; persistence was manually confirmed on 26.1.2. See the [migration record](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.2-adapter.3/docs/26.2-fabric-migration.md). --- - 恢复 26.x 结构化 SavedData Codec 及 flash 兼容的 UUID 整数数组写出格式。 - 同时读取 flash 存档中的整数数组 UUID 与受影响 Fabric 构建写出的字符串 UUID；下一次保存会输出 flash 可读取的标准整数数组格式。 - 保持 `halo:world_data`、`data/halo/world_data.dat`、`Halos`、`UUID`、`Definition` 和 `SAVED_DATA_MAP_DATA` 不变；实体 NBT、HaloCore 及旧版 1.20.1 的 `data/halo_world_data.dat` 路径不变。 - 增加多记录、空数据、读取后修改并保存及 flash Codec 回退读取回归测试。本分支自动兼容性测试和 Java 25 正式构建通过；26.1.2 已完成实际持久化确认。详见[迁移记录](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.2-adapter.3/docs/26.2-fabric-migration.md)。 --- **Build verification / 构建核验** - Halo: `62c761b5fc163367da1cd10bd926e6da97ca5001` - HaloCore: `295bc579ab8d63e6dba5642ebb9e889516e90105` (2.4.1, unchanged / 未修改) - CI: [branch / 分支](https://github.com/AzusaKe/Halo/actions/runs/35509447126) · [tag / 标签](https://github.com/AzusaKe/Halo/actions/runs/35509468287) — both passed / 均通过 - Published JAR / 已发布 JAR: [`halo-26.2-fabric-2.4.1+adapter.3.jar`](https://github.com/AzusaKe/Halo/releases/download/v2.4.1-fabric-26.2-adapter.3/halo-26.2-fabric-2.4.1%2Badapter.3.jar) - Published JAR SHA-256 / 已发布 JAR SHA-256: `ab63818cf4394e64aa5ec22ed8a914e496941dd521a9f878812aac55011b1427`

**Full Changelog / 完整变更记录**: [Compare adapter.2 to adapter.3](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-26.1-adapter.2...v2.4.1-fabric-26.1-adapter.3) --- - Restored the structured 26.x SavedData codec and flash-compatible UUID integer-array output. - The decoder accepts both UUID integer arrays from flash saves and string UUIDs written by affected Fabric builds; the next save emits the canonical integer-array format readable by flash. - Preserved `halo:world_data`, `data/halo/world_data.dat`, `Halos`, `UUID`, `Definition`, and `SAVED_DATA_MAP_DATA`. Entity NBT, HaloCore, and the legacy 1.20.1 `data/halo_world_data.dat` path are unchanged. - Added multi-entry, empty-data, load-modify-save, and flash-codec round-trip regression coverage. Automated compatibility tests and the Java 25 release build passed on this branch; persistence was manually confirmed on 26.1.2. See the [migration record](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.1-adapter.3/docs/26.1-fabric-migration.md). --- - 恢复 26.x 结构化 SavedData Codec 及 flash 兼容的 UUID 整数数组写出格式。 - 同时读取 flash 存档中的整数数组 UUID 与受影响 Fabric 构建写出的字符串 UUID；下一次保存会输出 flash 可读取的标准整数数组格式。 - 保持 `halo:world_data`、`data/halo/world_data.dat`、`Halos`、`UUID`、`Definition` 和 `SAVED_DATA_MAP_DATA` 不变；实体 NBT、HaloCore 及旧版 1.20.1 的 `data/halo_world_data.dat` 路径不变。 - 增加多记录、空数据、读取后修改并保存及 flash Codec 回退读取回归测试。本分支自动兼容性测试和 Java 25 正式构建通过；26.1.2 已完成实际持久化确认。详见[迁移记录](https://github.com/AzusaKe/Halo/blob/v2.4.1-fabric-26.1-adapter.3/docs/26.1-fabric-migration.md)。 --- **Build verification / 构建核验** - Halo: `5cc5d866870e7c839cec30b8d680162fc669e9c1` - HaloCore: `295bc579ab8d63e6dba5642ebb9e889516e90105` (2.4.1, unchanged / 未修改) - CI: [branch / 分支](https://github.com/AzusaKe/Halo/actions/runs/35509447058) · [tag / 标签](https://github.com/AzusaKe/Halo/actions/runs/35509468075) — both passed / 均通过 - Published JAR / 已发布 JAR: [`halo-26.1.2-fabric-2.4.1+adapter.3.jar`](https://github.com/AzusaKe/Halo/releases/download/v2.4.1-fabric-26.1-adapter.3/halo-26.1.2-fabric-2.4.1%2Badapter.3.jar) - Published JAR SHA-256 / 已发布 JAR SHA-256: `4c6e7c2e196018b374a46206a62d97f53c8aa117dbc919f79a19ea2bcd9ff849`

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.1-fabric-1.21.1-adapter.2...v2.4.1-neoforge-1.21.1-adapter.1) --- - Added the first official **Minecraft 1.21.1 NeoForge** release, carrying forward the 1.21.1 Fabric feature set on HaloCore 2.4.1. Requires **Java 21 and NeoForge 21.1.219 or newer**; the release is built with **21.1.248**. Players install one Halo JAR with core included. Definition schema, saves, all nine payload formats and public API v2 remain compatible. - Migrated lifecycle events, resource loading, commands, the Halo Scepter and optional networking to NeoForge. Preserved local `@s` commands, ownership-source priorities, animation and physics, independent inventory previews, and YSM 2.6.5 / EMF world and preview capture. - Retained first-person camera quaternions, main-frame/shadow-pass isolation, transparent instance and triangle sorting using the actual GPU view transform, shared geometry, resident VBOs, separate EBOs and material caches. The Iris entity-material path and generic GLSL smooth-normal matching remain in place; IterationRP Alpha 0.8.22 and shader-enabled EMF/YSM previews were checked. No quantified cross-platform FPS improvement or additional POM support is claimed. - Fixed distant clouds drawing over nearby translucent meshes, sneaking right-click failing to select the scepter holder, and inventory clipping cutting off halos outside the player-preview rectangle. - Fixed intermittent entity disappearance caused by restoring a VAO without invalidating Minecraft's immediate-buffer binding cache, and avoided binding an EBO with VAO 0. In the original 219 reproduction environment, the pre-fix Halo session recorded 6,139 OpenGL errors; both the no-Halo and fixed sessions recorded zero, with the user confirming normal entities and previews. Added opt-in, rate-limited diagnostics via `-Dhalo.renderDiagnostics=true`, disabled by default. - Passed local **125 adapter tests and 326 core tests**, legacy binary-caller and flat-JAR checks. The same 248-built candidate passed dedicated-server startup, basic commands and saving on both 219 and 248. After comprehensive testing, the user reported no obvious problems and approved the official release. HaloCore stays at **2.4.1 / `295bc579`**, with no production changes; all **352 class files** in the local release match the accepted candidate. Exact evidence and unmeasured cases are recorded in the [migration record](https://github.com/AzusaKe/Halo/blob/v2.4.1-neoforge-1.21.1-adapter.1/docs/1.21.1-neoforge-migration.md). - Known inherited issue: `mesh_mask_demo` can show abrupt triangles at certain viewing angles, also observed across multiple Fabric versions. This release intentionally leaves that separate issue unchanged. --- - 首次正式发布 **Minecraft 1.21.1 NeoForge** 版本，以 HaloCore 2.4.1 迁移 1.21.1 Fabric 的功能。需要 **Java 21、NeoForge 21.1.219 或更高版本**，正式构建基线为 **21.1.248**。玩家只需安装一个内含 core 的 Halo JAR；定义 schema、存档、九种网络负载格式和公开 API v2 保持兼容。 - 将生命周期、资源加载、命令、光环权杖及可选网络通信接入 NeoForge，保留本地 `@s`、佩戴来源优先级、动画物理、独立物品栏预览，以及 YSM 2.6.5／EMF 的世界和预览捕获。 - 保留第一人称相机四元数、主帧／阴影 pass 隔离、按 GPU 实际视图变换进行的透明实例与三角形排序，以及共享几何、驻留 VBO、独立 EBO 和材质缓存。继续使用 Iris 实体材质通路和通用 GLSL 平滑法线匹配；已检查 IterationRP Alpha 0.8.22 及光影下 EMF/YSM 预览。不宣称具体跨平台帧率提升或额外的 POM 支持。 - 修复远处云覆盖近处半透明 mesh、权杖蹲下右键无法选择自己，以及光环超出物品栏人物预览框时被裁剪的问题。 - 修复恢复 VAO 后未清除 Minecraft 即时顶点缓冲绑定缓存导致的实体间歇消失，同时避免 VAO 0 上绑定 EBO。在原 219 复现场景中，修复前 Halo 会话记录 6,139 条 OpenGL 错误；无 Halo 和修复后会话均为零，用户确认实体及预览正常。新增默认关闭、限频的诊断开关 `-Dhalo.renderDiagnostics=true`。 - 本地 **125 项适配器测试、326 项 core 测试**、旧二进制调用方与单 JAR 合包检查通过。同一 248 构建候选在 219／248 专用服均完成启动、基础命令和保存检查。用户完成综合测试，未观察到明显问题并批准正式发布。HaloCore 保持 **2.4.1／`295bc579`**，无生产代码修改；本地正式包的 **352 个 class 文件**与验收候选一致。详细证据与未单独量化的范围见[迁移记录](https://github.com/AzusaKe/Halo/blob/v2.4.1-neoforge-1.21.1-adapter.1/docs/1.21.1-neoforge-migration.md)。 - 已知遗留问题：`mesh_mask_demo` 在特定角度可能出现突兀三角面，多个 Fabric 版本也可复现。本次按约定不处理此独立问题。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.0-fabric-1.20.1-adapter.1...v2.4.1-fabric-1.21.1-adapter.2) --- - Added the first official Minecraft 1.21.1 Fabric release, carrying forward the complete Halo 2.4.0 feature set on Java 21, Fabric Loader 0.16.14+, and HaloCore 2.4.1. Existing definition schema, saves, wire format, and public anchor/ownership API v2 remain compatible. - Updated the 1.21.1/Iris rendering integration: unmasked lit primitives retain the native entity material path and LabPBR texture lifecycle; generic derivative-normal shaders such as IterationRP recover uploaded smooth normals without depending on shader-pack names or private symbols. - Fixed translucent OBJ occlusion by sorting both mesh instances and triangles against the exact local-to-view transform submitted to the GPU. Cached VBO/EBO rendering and expanded fallback now share the same stable back-to-front order while retaining the existing fast paths. - Fixed first-person 3D rotation jitter by decoding the 1.21.1 camera quaternion in the platform adapter. Also restored unrestricted local `@s` handling and halo-definition completion for `/halo show`, `hide`, and `inspect` when connected to a server without Halo. - The release passed 124 Halo adapter tests and 326 HaloCore tests with no failures or skips, including frozen legacy render callers, YSM 2.6.5 signatures, old network bytes, old world NBT, transparent ordering, shader rewriting, and camera rotation regressions. Dedicated-server and reported gameplay/render checks passed; the exact runtime matrix and remaining external-combination boundaries are recorded in the migration document. --- - 首次正式发布 Minecraft 1.21.1 Fabric 版本：在 Java 21、Fabric Loader 0.16.14+ 和 HaloCore 2.4.1 上完整迁移 Halo 2.4.0 功能。既有定义 schema、存档、网络字节格式以及公开锚点／来源 API v2 保持兼容。 - 更新 1.21.1／Iris 渲染集成：未遮罩受光图元继续使用原生实体材质路径及 LabPBR 纹理生命周期；IterationRP 等采用通用导数法线模式的光影可恢复上传的平滑法线，不依赖光影包名称或私有符号。 - 修复半透明 OBJ 遮挡异常：mesh 实例和内部三角形均按实际提交给 GPU 的 local-to-view 变换稳定地由远到近排序；缓存 VBO/EBO 与展开回退使用相同顺序，同时保留已有快速路径。 - 修复第一人称三维旋转抽搐：由平台适配器按 1.21.1 相机四元数约定解码。连接无 Halo 模组服务器时，`/halo show`、`hide`、`inspect` 的本地 `@s` 及光环定义补全也已恢复。 - 本版通过 Halo 适配器 124 项及 HaloCore 326 项测试，无失败或跳过；覆盖冻结的旧渲染调用方、YSM 2.6.5 签名、旧网络字节、旧世界 NBT、透明排序、shader 改写和相机旋转回归。专用服及反馈中的游戏／渲染检查通过；精确运行组合和仍受外部环境约束的边界见迁移记录。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.4.0-forge-1.20.1-adapter.1...v2.4.0-forge-1.20.1-adapter.2) --- - Fixed OBJ meshes intermittently appearing black instead of their texture colors when shaders are disabled, including cases that returned after leaving and re-entering a world. The fix covers all five built-in mesh demos and the reported Seia resource pack. - Restored the current lightmap before each draw so a preceding lit object cannot leave subsequent full-bright meshes sampling an empty texture. The fix covers world rendering, GUI previews, cached GPU geometry, and CPU fallback. - Added real-client GPU pixel regression checks for mixed lit/full-bright draws, actual mesh resources, resource reloads, and world re-entry. Checks passed on Forge 47.4.0 and 47.4.21, including Oculus 1.8.0 + Embeddium 0.3.31 with shaders disabled; user acceptance testing also passed. - Released as `2.4.0+adapter.2` for Minecraft 1.20.1 / Forge 47.4.0–47.x. HaloCore remains at 2.4.0; existing resource packs, definition schema, saves, networking, and API v2 remain compatible. Shader-enabled LabPBR and the full multiplayer matrix were not revalidated in this patch. --- - 修复关闭光影时 OBJ mesh 偶发变黑、无法显示贴图固有色的问题，包括退回主界面再进入世界后再次变黑的情况；覆盖五个内置 mesh demo 和反馈中的 Seia 资源包。 - 在每次绘制前恢复当前光照贴图，避免前一个受光图元清空纹理槽后，让后续全亮 mesh 采样空纹理。修复覆盖世界渲染、GUI 预览、GPU 缓存几何和 CPU 回退路径。 - 增加真实客户端 GPU 像素回归，检查受光与全亮图元交替、实际 mesh 资源、资源重载及重新进入世界。在 Forge 47.4.0、47.4.21，以及 Oculus 1.8.0 + Embeddium 0.3.31 关闭光影的组合中通过验证，用户实际游戏复测也已通过。 - 正式版本为 `2.4.0+adapter.2`，适用于 Minecraft 1.20.1 / Forge 47.4.0–47.x。HaloCore 保持 2.4.0，兼容既有资源包、定义 schema、存档、网络和 API v2。本补丁未重新验收开启光影后的 LabPBR 及完整多人组合。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.3.2-fabric-1.20.1-adapter.1...v2.4.0-fabric-1.20.1-adapter.1) --- - Added a loader-neutral server ownership API under `network.azusake.halo.api.v2`. Accessory mods and other providers can register a source and submit one `entity UUID -> halo definition ID` candidate while Halo continues to synchronize and render exactly one winner. - Added signed source priorities and administrator overrides through `config/halo-azusake/halo_source_priorities.json` and `/halo priority list|set|reload`. Negative priorities are supported; first collisions auto-demote once, while unresolved second collisions are disabled with actionable diagnostics. - Migrated Halo's persistent WorldData ownership to the ordinary `halo:world_data` source. `/halo show`, `/halo hide`, and the scepter keep their existing storage semantics and never remove or suppress an external source. - Preserved old world/entity NBT, `halo:sync` and `halo:update` bytes, client rendering and preview behavior, existing anchor API v2, and published core runtime signatures. External providers must ship their definition JSON and assets to clients; no dynamic item registration is introduced. - Verified the API with an independently compiled external Curios provider. Dedicated Forge testing with two clients covered late join, reconnect, priority changes, source fallback, effects, and rendering; the same full clients also joined a vanilla server and kept isolated local `/halo` state. --- - 在 `network.azusake.halo.api.v2` 新增加载器无关的服务端光环来源 API。饰品模组等外部提供者可注册来源并提交一份“实体 UUID → 光环定义 ID”候选，Halo 仍只同步和渲染唯一胜者。 - 新增有符号来源优先级，以及 `config/halo-azusake/halo_source_priorities.json` 和 `/halo priority list|set|reload` 管理员覆写。支持负优先级；首次冲突自动降一级，仍冲突时禁用并给出可操作诊断。 - Halo 自有持久佩戴迁移为普通的 `halo:world_data` 来源。`/halo show`、`/halo hide` 和权杖保持原有存储语义，不会删除或屏蔽外部来源。 - 保留旧世界/实体 NBT、`halo:sync` 与 `halo:update` 字节、客户端渲染和预览行为、现有锚点 API v2，以及已发布的 core runtime 签名。外部来源需随客户端提供定义 JSON 和素材；本版不引入动态物品注册。 - 使用独立编译的 Curios 外部来源完成 API 验证。Forge 专用服双客户端实测覆盖后加入、重连、优先级切换、来源回退、药水效果和渲染；同一套完整客户端也可进入原版服，并保持相互隔离的本地 `/halo` 状态。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v2.0.0-fabric-1.20.1-adapter.1...v2.1.0-fabric-1.20.1-adapter.1) --- - Significantly optimized frame rate performance for OBJ models with extremely high polygon counts (100,000+); the frame rate at 4K resolution is now approximately 70–80 FPS—an increase of about 60% compared to the 45 FPS seen in the previous version. - Removed the mask restrictions for alpha blending; masks of any resolution can now be used with simple shaders. --- - 大幅优化了模组在极高面数OBJ模型（10万+）下的帧数表现，4K分辨率下帧率大约70~80，相比上一个版本的45，提升了约60% - 解除了对于alpha blend的遮罩限制，现在任意分辨率的遮罩可用于简易shader

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.3.0-fabric-1.20.1-flash...v2.0.0-fabric-1.20.1-adapter.1) --- - add 3D mesh (.obj) and alpha blend --- - 加入了3D mesh(.obj)和 透明度混合

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.2-emf-compatible-flash...v1.3.0-neoforge-26.2-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and fixed NeoForge scepter item initialization and anchor lifecycle handling. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，修复 NeoForge 权杖物品初始化和光环锚点生命周期问题。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.2-emf-compatible-flash...v1.3.0-fabric-26.2-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and improved anchor lifecycle handling and scepter payload validation. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，改进光环锚点生命周期处理和权杖数据包校验。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.1-emf-compatible-flash...v1.3.0-neoforge-26.1-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and fixed NeoForge scepter item initialization and anchor lifecycle handling. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，修复 NeoForge 权杖物品初始化和光环锚点生命周期问题。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.1-emf-compatible-flash...v1.3.0-fabric-26.1-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and improved scepter text rendering and anchor lifecycle handling. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，改进权杖文字渲染和光环锚点生命周期处理。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-1.21.1-emf-compatible-flash...v1.3.0-neoforge-1.21.1-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and improved NeoForge scepter integration and anchor lifecycle handling. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，改进 NeoForge 权杖适配和光环锚点生命周期处理。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.21.1-emf-compatible-flash...v1.3.0-fabric-1.21.1-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Stabilized first-person halo rotation and improved anchor lifecycle handling when entities are unloaded. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 优化第一人称光环旋转，并改进实体卸载时的光环锚点生命周期处理。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-forge-1.20.1-emf-compatible-flash...v1.3.0-forge-1.20.1-flash) --- - Added the Halo Scepter, its crafting recipe, and an interactive configuration screen. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Hardened Forge scepter interactions and improved anchor lifecycle handling when entities are unloaded. --- - 添加光环权杖、合成配方和交互式配置界面。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 加固 Forge 权杖交互逻辑，并改进实体卸载时的光环锚点生命周期处理。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.20.1-emf-compatible...v1.3.0-fabric-1.20.1-flash) --- - Added the Halo Scepter and its crafting recipe. - Added cross-version Halo Anchor API v2 integration and enabled YSM compatibility by default. - Improved anchor lifecycle handling when entities are unloaded. --- - 添加光环权杖及其合成配方。 - 添加跨版本 Halo Anchor API v2，并默认启用 YSM 兼容。 - 改进实体卸载时的光环锚点生命周期处理。

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.2-flash-iris-fix...v1.2.1-neoforge-26.2-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.2-flash-iris-fix...v1.2.1-fabric-26.2-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.1-ysm-compatible-flash...v1.2.1-neoforge-26.1-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.1-flash-iris-fix...v1.2.1-fabric-26.1-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-1.21.1-ysm-compatible-flash...v1.2.1-neoforge-1.21.1-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.21.1-ysm-compatible-flash...v1.2.1-fabric-1.21.1-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-forge-1.20.1-ysm-compatible-flash...v1.2.1-forge-1.20.1-emf-compatible-flash) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.20.1-ysm-compatible...v1.2.1-fabric-1.20.1-emf-compatible) --- - add EMF compatibility --- - 添加EMF兼容

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.21.1-ysm-compatible-flash...v1.2.1-neoforge-1.21.1-ysm-compatible-flash) --- - add YSM compatible - port mod from 1.21.1 fabric to 1.21.1neoforge --- - 兼容YSM - 将模组由Fabric 1.21.1迁移到Neoforge 1.21.1

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.1-flash-iris-fix...v1.2.1-neoforge-26.1-ysm-compatible-flash) --- add YSM compatible --- 兼容YSM

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-forge-1.20.1-flash...v1.2.1-forge-1.20.1-ysm-compatible-flash) --- add YSM compatible --- 兼容YSM

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.21.1-flash...v1.2.1-fabric-1.21.1-ysm-compatible-flash) --- add YSM compatible --- 兼容YSM

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1...v1.2.1-fabric-1.20.1-ysm-compatible) --- add YSM compatible --- 兼容YSM

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.2-flash...v1.2.1-neoforge-26.2-flash-iris-fix) --- Fixed the issue where the mod was incompatible with Iris in this version. --- 解决了模组在本版本与Iris不兼容的问题

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.1.x-flash...v1.2.1-neoforge-26.1-flash-iris-fix) --- Fixed the issue where the mod was incompatible with Iris in this version. --- 解决了模组在本版本与Iris不兼容的问题

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.1-flash...v1.2.1-fabric-26.2-flash-iris-fix) --- Fixed the issue where the mod was incompatible with Iris in this version. --- 解决了模组在本版本与Iris不兼容的问题

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.1-flash...v1.2.1-fabric-26.1-flash-iris-fix) --- Fixed the issue where the mod was incompatible with Iris in this version. --- 解决了模组在本版本与Iris不兼容的问题

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1...v1.2.1-forge-1.20.1-flash) --- - Ported the mod from Fabric 1.20.1 to Forge 1.20.1 and fixed bugs. --- - 将模组由1.20.1 fabric 迁移到 1.20.1 Forge，并修复错误

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-neoforge-26.1.x-flash...v1.2.1-neoforge-26.2-flash) --- - Ported the mod from Neoforge 26.1.2 to Neoforge 26.2 and fixed bugs. --- - 将模组由26.1.x Neoforge 迁移到 26.2 Neoforge，并修复错误

port mod from fabric to neoforge --- 将模组移植到 neoforge

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-26.1-flash...v1.2.1-fabric-26.2-flash) --- - Ported the mod from Fabric 26.1.1 to Fabric 26.2 and fixed bugs. --- - 将模组由26.1 fabric迁移到 26.2 fabric，并修复错误

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1-fabric-1.21.1-flash...v1.2.1-fabric-26.1-flash) --- - Ported the mod from Fabric 1.21.1 to Fabric 26.1 and fixed bugs. --- - 将模组由1.21.1 fabric迁移到 26.1 fabric，并修复错误

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.1...v1.2.1-fabric-1.21.1-flash) --- - Ported the mod from Fabric 1.20.1 to Fabric 1.21.1 and fixed bugs. --- - 将模组由1.20.1 fabric迁移到1.21.1 fabric，并修复错误

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.2.0...v1.2.1) --- - Fixed an issue where the halo would temporarily disappear when switching to Elytra flight. --- - 修复了切换鞘翅飞行时光环会暂时消失的问题

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.1.1...v1.2.0) --- - Added `glow` and `alpha` properties to the animation system, along with `inherit_glow` and `inherit_alpha` fields to control whether the current group inherits attributes from its parent node. - Fixed issues with the transition between startup/shutdown animations and persistent animations; enabled seamless chaining between startup and shutdown animations (e.g., triggering "/halo hide" during the startup animation). - Added `rotation` support to transition animations, controlled via `from`, `to`, `degrees`, `easing`, and `duration` parameters. - Added a `face_camera` field to billboard primitives to ensure they always face the camera. - Refactored the anchor point algorithm, upgrading it from 5DOF to 6DOF. - Exposed an API allowing other mods to register and provide halo anchors, enabling them to take over halo rendering for specific UUIDs or entity types (see `docs/*/API.md` for details). - Rewrote player halo rendering using the aforementioned API; halos are now precisely locked to the player's head. --- - 将发光强度（glow）和透明度（alpha）引入动画系统，同时引入inherit_glow和inherit_glow字段，用于控制当前组是否继承父节点属性 - 修复过渡动画和常驻动画衔接不畅的问题，并让启动动画与结束动画可以衔接（在启动动画过程中/halo hide） - 将旋转（rotation）引入过渡动画，使用from、to、degrees、easing、duration控制 - 为billboard图元（primitive）增加字段face_camera，使其面向摄像机 - 重整锚点算法，由5DOF变为6DOF - 开放API，允许其他模组注册和提供光环锚点，以此来接管特定uuid/实体类型的光环渲染，详见docs/*/API.md - 利用上述API重写玩家光环渲染，现在光环精确的锁定在玩家头部

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.1.0...v1.1.1) --- - Fixed an issue where halos were lost upon player death; note that this is a **breaking change** ! —updating to this version will cause all existing entity halo to disappear, so please update with caution !!! - Fixed an issue where the `/halo inspect` command was unavailable. - Fixed incorrect halo positioning caused by pressing the sneak key while airborne. - Added permission configuration options for the `halo` command; required permission levels can now be manually configured in `config/halo-azusake/halo_mod_config.json` (requires a game restart to take effect). - Removed the hard limit on the `scale` (previously capped at 5; now unlimited). --- - 修复玩家死亡后光环丢失的问题，此项为 **破坏性更新！** 当更新此版本，之前所有的实体拥有的光环都会消失，请谨慎更新！！！ - 修复/halo inspect指令无效的问题 - 修复在空中按下潜行键导致的光环位置错误 - 添加对于halo指令的权限配置选项，现在可以在config/halo-azusake/halo_mod_config.json手动配置命令需要的权限等级（需重启游戏生效） - 解除scale的硬性上限（原来为5，现在不限）

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.10...v1.1.0) - Fixed: The `/halo hide` command failed to work correctly when the halo definition included a startup animation. - Fixed: Halo definitions in the server-side `data` folder were incorrectly overriding those in `assets`; the `data` folder has been removed, and all halo definitions are now centrally managed within `assets`. > The version number has been updated to 1.1.0, signifying that no further major features will be added; instead, the focus will shift to addressing individual bugs and preparing for compatibility across multiple versions and loaders. --- - 修复：当光环定义中含有startup动画，/halo hide指令无法正常生效 - 修复：服务端的data文件夹下的光环定义错误的覆盖了assets的光环定义，现已去除data文件夹，所有光环定义由assets统一管理 > 版本号变更为1.1.0，意味着接下来将不再添加大功能，而是进行逐项bug修复并着手准备多版本多加载器适配

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.9...v1.0.10) - Added GROUP support for halo definitions, enabling multiple primitives and nested child inheritance structures. - Added schema versioning for halo definition JSON. - Added per-axis scale animation support (x/y/z). - Added startup/ending transition animations (fade-in/fade-out). - Refactored the transition animation system into a queue-based model for more stable sequencing. - Fixed multiple transition issues, including post-transition timeline continuity and backfill behavior. - Fixed an issue where ending animation from /halo hide did not play correctly on multiplayer servers. - Updated EN/ZH quickstart and reference docs, including transition animation guidance. --- - 为光环定义新增 GROUP 支持，可实现多图元组合与嵌套子组继承结构 - 为光环定义 JSON 新增 schema versioning（版本号机制） - 新增按轴缩放动画支持（x/y/z） - 新增启动/结束过渡动画（淡入/淡出） - 将过渡动画系统重构为队列模型，提升时序稳定性 - 修复多项过渡动画问题，包括过渡后时间连续性与 backfill 行为 - 修复多人服务器中 /halo hide 结束动画无法正常播放的问题 - 更新中英文 quickstart 与 reference 文档，补充过渡动画说明

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.7...v1.0.8) - Added the "allow_angular_momentum" field to the halo definition to control whether the halo exhibits angular momentum-like properties. - Correspondingly, "angularMomentumFactor" and "maxAngularMomentumDegrees" have been added to the "damping" field and the "/halo config" command. - Example fields are as follows: --- - 为光环定义添加了字段“allow_angular_momentum”，用于控制光环是否表现出类似角动量的性质 - 对应的，在"damping"字段和"/halo config"指令中添加了"angularMomentumFactor"和"maxAngularMomentumDegrees" - 示例字段如下： ```json { "orientation_mode": "locked", "allow_angular_momentum": true, "damping": { "linearFactor": 0.15, "angularFactor": 0.1, "maxLinearDistance": 3.0, "maxAngularDegrees": 180.0, "angularMomentumFactor": 0.3, "maxAngularMomentumDegrees": 45.0 } } ```

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.6...v1.0.7) - Added a primitive type for halo layers: "ring"—a ring shape with the top and bottom faces removed. - How do you use this type? You can refer to [ring_test.json](https://github.com/AzusaKe/Halo/blob/main/src/main/resources/assets/halo/halo_definitions/ring_test.json) in the project.By comparing this with the actual `halo_test` in the game, you can figure out how to create the relevant resource pack. - Detailed documentation will be added soon. - A brief example is as follows: --- - 添加了一种光环层级的primitive种类：“ring”，一种去除了上下底面的圆环 - 如何使用该类型？可以参考项目中的 [ring_test.json](https://github.com/AzusaKe/Halo/blob/main/src/main/resources/assets/halo/halo_definitions/ring_test.json)，与游戏中的实际halo_test对比即可知道如何制作相关资源包 - 很快会添加详细的文档 - 简短的示例如下： ```json { "primitive": { "type": "ring", "texture": "halo:textures/halo/ring.png", "size": [0.35, 0.08], "segments": 32 } } ```

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.5...v1.0.6) - Added local support for multiplayer servers without the mod installed; it can now be used without the server having the mod, though multiplayer synchronization is not supported—you will only see the halo locally. --- - 加入了对于未安装模组的多人服务器的本地支持，现在无需服务器安装模组即可使用，但无法进行多人同步，你只能在本地看到光环

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.4...v1.0.5) - Multiplayer synchronization is now initially implemented; you can see other players' halos on multiplayer servers (requires the mod to be installed on both the client and the server). - Preparing for compatibility with all entity models and poses (interfaces added but not yet implemented). --- - 初步完成多人同步，现在可以在多人联机服务器中看到别的玩家的光环（需要客户端和服务器同时安装模组） - 为适配所有实体模型和姿态做准备（加入了接口但尚未实现）

**Full Changelog**: [Here](https://github.com/AzusaKe/Halo/compare/v1.0.2...v1.0.3) - update docs - add tab-completion for /halo command --- - 更新文档 - 为/halo 命令添加自动补全

**Full Changelog**: https://github.com/AzusaKe/Halo/compare/v1.0.1...v1.0.2 add more docs: quickstart,referrence add planned feature in README add `hide_on_sleep` in halo definition,if true,halo will be hidden while sleeping add new halo "halo:hud" --- 增加了更多文档 包括快速起步、参考文档 向自述文件加入了计划（即将更新）的特性 向光环定义加入`hide_on_sleep`字段，当该字段为真，光环将会在该实体睡觉时隐藏 添加了新的光环 "halo:hud"

## 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.