光环

光环

实体头部上方漂浮的装饰光环 — 多层、全动画、高度可配置。为每位玩家赋予专属的闪耀王冠。

装饰

光环预览查看大图

描述

灵感来源于《蔚蓝档案》的标志性光环。

画廊中显示的某些 BA 光环需从此处获取。

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

使用方法

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

如何添加光环

查看英文文档或中文文档

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

特性

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

内置定义

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

兼容性

  • Minecraft 1.19.4 ~ 1.20.4
  • 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 文件夹