Baubles-Expanded

[!INFO] Git Commit: e780707 | Updated: 2026-09-28

GTNH 版本扩展的 Baubles 饰品系统：将原版 Baubles 的固定 4 槽位（amulet × 1、ring × 2、belt × 1）扩展为可动态注册的最多 20 个槽位，注册类型覆盖 ring/amulet/belt/universal/head/body/charm/cape/shield/quiver/gauntlet/earring/wings 等，提供新的 IBaubleExpanded 多类型接口、可配置堆叠上限、灵魂绑定附魔、NEI 集成、原版 inventory GUI 切换按钮以及 ThaumcraftDepLoaderNuker 阻止 Thaumcraft 自动下载官方 Baubles。

源码：/home/evlos/a/mirror/Baubles-Expanded/ 关系登记：见 data/relation.md（全局 Wiki 分类映射表）

API

• BaubleType - 原始 Baubles enum（4 种基础类型）
• IBauble - 饰品基础接口
• IBaubleExpanded - 扩展接口（支持多类型 + 槽位变化回调）
• BaubleExpandedSlots - 扩展槽位类型注册表（最多 20 槽）
• BaublesApi - 反射获取玩家饰品栏
• BaubleItemHelper - 右键自动装备 + SHIFT tooltip 辅助

物品

• BaubleItemBase - 抽象基类（继承 Item 并实现 IBaubleExpanded）
• ItemDebugger - 调试物品（按 metadata 对应每个注册槽位类型）

设定

• BaublesConfig - 全部配置项 + 加载逻辑
• ThaumcraftDepLoaderNuker - 阻止 Thaumcraft 下载官方 Baubles 的 coreMod

热键

• KeyHandler - 打开饰品栏 GUI 的客户端热键（默认无绑定）

容器

• InventoryBaubles - 玩家饰品栏 IInventory 实现
• SlotBauble - bauble 槽位 Slot（校验/堆叠上限/背景贴图）
• ContainerPlayerExpanded - 玩家背包容器（含 2×2 合成、盔甲、bauble、库存、快捷栏）
• PlayerHandler - 玩家饰品栏缓存 + 文件加载/保存
• ItemStackHelper - 灵魂绑定检测

GUI

• GuiPlayerExpanded - baubles 物品栏 GUI（支持新版侧栏/旧版嵌入 + 滚动 + NEI 集成）
• GuiEvents - 在原版 inventory GUI 上添加 baubles 按钮并处理切换
• GuiBaublesButton - baubles 按钮渲染
• ClientProxy - 客户端 proxy（GUI/key 注册）

网络

• PacketHandler - SimpleNetworkWrapper 与 4 个消息注册
• PacketOpenBaublesInventory - C→S 请求打开 baubles GUI
• PacketOpenNormalInventory - C→S 请求关闭 baubles GUI
• PacketSyncBauble - S→C 单槽位同步
• PacketSyncAllBauble - S→C 全量同步（登录/跨维度/开始追踪）
• CommonProxy - 服务端 proxy（服务端 GUI handler）
• Baubles（主 mod 类） - 实际 modid=Baubles 的主类
• BaublesExpanded（mod 容器） - parent modid=Baubles|Expanded 的展示容器

事件

• EventHandlerEntity - 玩家 tick、死亡掉落、登录/保存文件、跨玩家追踪同步
• EventHandlerNetwork - 玩家登录/跨维度全量同步、客户端缓存清理
• EventHandlerCleanup - 每 200 tick 缓存剪枝