Halo

警告

模组 1.1.1 版本包含一项破坏性变更！！！更新后加载旧存档将导致所有实体光环的 NBT 数据丢失，且该数据无法恢复！！！
请在更新前备份数据并谨慎操作！

描述

灵感来源于Blue Archive中标志性的光环。

图库中展示的部分BA光环必须从此处获取。

Halo 会在实体头顶添加可配置的漂浮光环。每个光环由一个 JSON 文件定义，可堆叠多个带纹理的图层，每个图层拥有独立的位置、旋转、缩放和发光设置。灵活的动画系统通过任意轴上的正弦、余弦和线性项驱动每个图层的运动，从细微的待机浮动到错开的时钟环旋转。

YSM 兼容

YSM 兼容性目前正在测试中；你可能会遇到图形故障。

此功能默认禁用。要启用它，请导航至游戏实例的根目录，找到 ./config/halo-azusake/halo_mod_config.json，用文本编辑器打开，并将 experimentalYsmAnchorEnabled 字段设置为 true。需要重启才能使更改生效。

如果光环显示位置过高或过低，请调整同一文件中的 experimentalYsmHeadLocalOffset 字段。三个参数分别对应 [x, y, z]，表示向右、向上和向后的位移。

用法

• 使用 /halo show <entity selector> <halo definition> 在目标实体上方显示光环
• 使用 /halo hide <entity selector> 隐藏其光环
• 使用 /halo list 列出已加载的光环
• 其他命令用于调试

如何添加光环

查看英文或中文文档

或从 Ba-Halo-Definition 下载资源包

特性

• 多层光环 — 堆叠多个图层，每个图层可独立变换和切换发光
• 逐层动画 — 在任意偏移或旋转轴上使用 sin、cos 和线性函数项；同一轴上的多个项会相加
• 朝向模式 — 锁定（跟随实体偏航角）、自由（松散漂浮）、同步（混合）
• 数据驱动 — 所有定义均为 data/halo/halo_definitions/ 下的 JSON 文件；兼容数据包和资源包
• 游戏内命令 — 使用 /halo 进行实时预览和管理

内置定义

• ring_default — 一个 7 层时钟环设计
• hud — 一个类似 HUD 的设计

兼容性

• Minecraft 1.19.4 ~ 1.20.4 , 1.21.1 , 26.1.x , 26.2
• Fabric Loader 0.15+
• 需要 Fabric API

1.19.4 注意：核心功能（显示/隐藏、多人同步、持久化）可正常工作，但 /halo list、/halo active 和 /halo dump 不会产生聊天输出。其他版本不受影响。

NeoForge / Forge

此模组原生为 Fabric 构建，但也可通过 Sinytra Connector + Forgified Fabric API 在 NeoForge / Forge 1.20.1 上运行。光影包兼容。

1. 为 Minecraft 1.20.1 安装 NeoForge 或 Forge
2. 安装 Sinytra Connector
3. 安装 Forgified Fabric API
4. 将 Halo 模组 JAR 放入 mods 文件夹