Halo
by Azusa_Ke
Halo lets a player place floating decorative halos above entity heads, built from stacked, animated layers defined in JSON files.
What it does
Each halo is a set of layers with independent position, rotation and scale, and each layer can have a glowing setting. An animation system drives per-layer motion through sine, cosine and linear terms on chosen axes, and several terms on the same axis are summed. Subtle idle bobbing and staggered clock-ring rotation are among the motions that can be built this way.
The halo orientation can be locked to the entity, follow its yaw, float freely, sync loosely or use a hybrid mode. Halos are defined in JSON files under data/halo/halo definitions, so data packs and resource packs can add or change them. Commands cover showing a halo above a target entity, hiding it, listing the halos loaded and running a debug mode, and the mod can give a player a glowing crown.
Halo requires Fabric API. Only players need the mod on the client, and a server may run it for extra features without needing it. It is open source under the MIT License, and its source code and issue tracker are public. Builds cover 1.20 – 26.3 on Fabric, Forge and NeoForge, with files for 26.3 on Fabric, 1.20.1 on Forge and 26.2 on NeoForge.
Key features
Multi-layer halos
Each halo stacks several textured layers, each with its own position, rotation, scale and glowing toggle.
Per-layer animation
Sine, cosine and linear terms animate each layer's offset, rotation and axis, and terms on the same axis are summed.
Orientation modes
A halo can stay locked to the entity, follow its yaw, float freely, sync loosely or use a hybrid of these.
Commands and definitions
Commands show, hide and list halos, and definitions in JSON files let data packs and resource packs add new halos.
Gallery
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x1 of 1 version with builds
1.20.x5 of 5 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Decorating characters
A halo above an entity's head can mark a character or a special mob in a map or a server build.
Who it’s for: Map makers, server builders and pack authors who want custom halos on entities, defined with JSON rather than code.
Questions
Does Halo need Fabric API?
Does a server need Halo installed?
Can Halo be used with data packs?
In the catalog
Halo is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
Similar mods
What the author says
Version 1.1.1 of the mod includes a breaking change!!! Loading an old save after updating will cause all entity halo NBT data to be lost, and this data can NOT be recovered!!! Please back up your data and proceed with caution before updating! Halo adds configurable floating halos above entity heads. Each halo is…
Official listing
- Modrinth page
- modrinth.com/mod/halo-azusake
- Owner
- Azusa_Ke
- Published
- 2026-06-20
- Updated on Modrinth
- 2026-10-10
- Facts verified
- 2026-10-15
