Description

Inspired by the iconic halos from Blue Archive.

Some of the BA halos displayed in the gallery must be obtained here.

Halo adds configurable floating halos above entity heads. Each halo is defined by a JSON file and can stack multiple textured layers with independent position, rotation, scale, and glowing settings. A flexible animation system drives per-layer motion via sine, cosine, and linear terms on any axis, from subtle idle bobbing to staggered clock-ring rotation.

Usage

Use /halo show <entity selector> <halo definition> to show halo above target entity
Use /halo hide <entity selector> to hide its halo
Use /halo list to list halo loaded
Other command are used for debug

How to add Halo

Check Doc in English or Chinese

Or Download resource pack from Ba-Halo-Definition

Features

Multi-layer halos — stack multiple layers with per-layer transform and glowing toggle
Per-layer animation — sin, cos, and linear function terms on any offset or rotation axis; multiple terms on the same axis are summed
Orientation modes — locked (follows entity yaw), free (floats loose), sync (hybrid)
Data-driven — all definitions are JSON files under data/halo/halo_definitions/; compatible with data packs and resource packs
Ingame commands — /halo for real-time preview and management

Built-in definitions

ring_default — a 7-layer clock-ring design
hud — a hud like design

Compatibility

Minecraft 1.20.1
Fabric Loader 0.15+
Requires Fabric API

Halo Customed