StructureLib

[!INFO] Git Commit: 4fdea65 | Updated: 2026-09-21

StructureLib 是一个提供多方块建造辅助系统的库 mod，本身不包含任何多方块结构。modid 为 structurelib，@Mod 类为 com.gtnewhorizon.structurelib.StructureLib。

核心功能是提示方块——一种在多方块组装过程中向玩家展示方块放置位置的可视化占位符系统。mod 包含一个构造触发器物品用于查看全息预览与配置通道，一个前面旋转工具用于旋转有方向性的方块，以及用于管理每玩家通道数据和注册表排序的指令。

方块列表

方块	描述
Hint Block	可视化占位符方块，注册名 `structurelib:blockhint`，16 种 metadata 状态

物品	描述
Front Rotation Tool	旋转结构件前面的工具，不潜行改旋转、潜行改翻转
Constructable Trigger	多方块构造触发器，全息预览 + 通道配置入口
Block Hint	Hint Block 的方块物品，带每 metadata 悬浮提示

两个独立物品的注册名中会重复出现一次 item. 前缀（如 structurelib:item.structurelib.frontRotationTool），这是注册时传入 getUnlocalizedName() 的结果。

实体	描述
Weightless Particle FX	提示可视化用的客户端漂浮粒子特效，未注册为 Forge 实体

设定	描述
mod 元信息与打包数据	`@Mod` 注解、core mod、仓库内全部数据文件、mixin 列表、本 mod 不含有的内容
配置	全部 6 个配置项的类型、默认值与范围，以及注册表排序配置
多方块构造机制	构造框架总览：目标解析、提示/放置分流、A/B/C 坐标系、PlaceResult
提示渲染系统	全息组的生命周期、渲染方式、染色与错误态、网络消息
通道系统	通道 NBT 字段、存取 API、GUI、mod 间注册、中键拾取
Extended Facing 对齐系统	96 种对齐状态的组成、IAlignment 接口、状态限制
AlignmentUtility	旋转结构件朝向的唯一实现入口
SortedRegistry 排序注册表	每玩家独立排序的注册表，本 mod 自带两个
/sl_channel	管理手持构造触发器上的每玩家通道数据
/sl_registry_debug	显示玩家特定的注册表排序