Tags
Creators
Details
All versions
v2.5.0-fabric-1.20.1-adapter.3
Release
Halo 2.5.0 - 1.20.1 fabric (Adapter 3)last week 36
Compatibility
Minecraft: Java Edition
1.20.1
Platform
Fabric
Supported environments
Client-side
Client and server
Required content
Any compatible version
Changes
Full Changelog: Here
- 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。
Supplementary resources
| File | Type | Size | |
|---|---|---|---|
| halo-1.20.1-fabric-2.5.0+adapter.3-sources.jar | Sources jar | 419.79 KiB |
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:k2fEt5RO:pyntbfW6"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:k2fEt5RO:pyntbfW6"
}

