القائمة
理解并维护 SlimefunHelper 中 `NBTType`、`NBTParsable`、`NBTRef`、`AttrKeyValue` 的自动配置链。用于分析或新增 NBT 配置类型时，追踪它如何在字符串、原始对象、NBT、Ref、可编辑 GUI 之间自动转换，并据此实现新的 `NBTParsable` / 组合型配置结构。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Analyze server-side block interaction flow around ServerPlayerInteractionManager.interactBlock, BlockState.onUseWithItem/onUse, ItemStack.useOnBlock, and BlockItem.useOnBlock in this merged Yarn Minecraft tree. Use when tracing whether right-clicking a block can fall through into item use or block placement, when classifying PASS vs PASS_TO_DEFAULT_BLOCK_ACTION behavior, or when summarizing special interactable block families.
理解并维护 SlimefunHelper 中 `ElytraExtra.applyAxisLimit2` 的 Elytra 烟花容错盒、两帧 look 叠加、目标逼近与爬升策略选择。用于分析 `currentMotion = currentRotation * 1.7` 一类上推方案，判断斜向追点、竖直拉升、前后折返等 rotation 序列的收益与约束。
Grim 中 Elytra 预测、烟花容错、offset 判定与 setback 回滚的结果逻辑。用于直接回答滑翔检测、fireworksBox、1.7 来源与拉回后高速原因。
在 SlimefunHelper 中兼容多个 Baritone 发行形态，尤其是“全混淆”版本。用于区分无混淆、仅方法混淆、类与方法全混淆三种形态，并决定 MixinPlugin、目标类定位、成员定位、反射桥接和 hooks 访问层该如何拆分。
在 SlimefunHelper 中新增或改造模块配置屏幕时，统一复用 `WidgetUtils` 的配置屏幕组装链，而不是在模块里重复手写 `DynamicListWidget + RefKeyValueInputWidget`。用于把 `BaseModule` 的 `editableConfig`、显示条件、模块标题、主题色和自定义 widget 接到同一条打开链路上。
为 SlimefunHelper 新模块补全 BaseModule 基础注册骨架。用于创建或改造模块时，统一完成模块名、ModulePath、Flag 绑定、不同类别 Ref、监听器、常用监听器、热键和命令注册。
| name | attrkeyvalue-and-nbttype-definition |
| description | 理解并维护 SlimefunHelper 中 `NBTType`、`NBTParsable`、`NBTRef`、`AttrKeyValue` 的自动配置链。用于分析或新增 NBT 配置类型时，追踪它如何在字符串、原始对象、NBT、Ref、可编辑 GUI 之间自动转换，并据此实现新的 `NBTParsable` / 组合型配置结构。 |
| disable-model-invocation | true |
这个仓库里的 NBTType 配置不是“写个 Codec 就完了”，而是一整条自动链：
TCodec<T> 负责 T <-> NbtElementWrapperFactory<String, T> 负责 String <-> TWidgetFactory 负责 WNBTType<T> 把两条链和 GUI 工厂绑成一个类型协议NBTParsable<T> 提供自动注册入口NBTRef<T> 负责配置系统里的持久化、懒解析和编辑入口AttrKeyValue<T> 负责把 Ref<T> 接成可编辑字段CustomWidgetFactory<T> 负责把值变成 GUI 控件TypeConvertAttrKeyValue / WrapperAttrKeyValue 负责把已有类型拼成新类型新增一个 NBT 配置类型时，必须把这条链一次补完整。不要只写 Codec，不要只写 GUI，也不要只写字符串解析。
在AttrKeyValue体系中 玩家gui输入以string的形态传播,经过factory反序列化出对象并通过validators后才会修改原始值， Codec则用于和配置文件中的nbt string进行序列化/反序列化，
优先阅读这些真实实现：
src/main/java/me/matl114/managers/config/NBTType.javasrc/main/java/me/matl114/managers/config/NBTParsable.javasrc/main/java/me/matl114/managers/config/NBTRef.javasrc/main/java/me/matl114/managers/config/Ref.javasrc/main/java/me/matl114/managers/config/LazilyRegisterTypeRef.javasrc/main/java/me/matl114/managers/config/Config.javasrc/main/java/me/matl114/managers/config/Refs.javasrc/main/java/me/matl114/utils/config/AttrKeyValue.javasrc/main/java/me/matl114/utils/config/BaseAttrKeyValue.javasrc/main/java/me/matl114/utils/config/WrapperFactory.javasrc/main/java/me/matl114/utils/config/kv/AttrKeyValues.javasrc/main/java/me/matl114/utils/config/kv/TypeConvertAttrKeyValue.javasrc/main/java/me/matl114/utils/config/kv/WrapperAttrKeyValue.javasrc/main/java/me/matl114/gui/McWidgetHelpers.javasrc/main/java/me/matl114/gui/complex/config/KeyValueInputWidget.javasrc/main/java/me/matl114/hacks/utils/config/NBTTypes.java理解样例时，优先看这些：
src/main/java/me/matl114/hacks/utils/config/Primitive.javasrc/main/java/me/matl114/hacks/utils/config/Holder.javasrc/main/java/me/matl114/hacks/utils/config/PrimitiveList.javasrc/main/java/me/matl114/hacks/utils/config/EntryPrimitiveMap.javasrc/main/java/me/matl114/hacks/utils/config/Vec2.javasrc/main/java/me/matl114/hacks/utils/config/TracingOption.javasrc/main/java/me/matl114/hacks/modules/combat/PositionPredict.java同一个配置值通常同时存在四种表示：
TStringNbtElement这套系统的核心就是保证这四层之间能自动来回走。
NBTType<T> 是中心枢纽NBTType<T> 持有四样东西：
typeName：持久化类型名typeCodec：T <-> NbtElementcustomWidgetFactory：T -> GUIstringifyFactory：String <-> Tempty：默认空值模板它同时负责：
parse(NbtElement)：NBT 转业务值toNbt(T)：业务值转 NBTcreateAttrKeyValue(key, value)：把值接成可编辑配置项generateValueWidget(...)：生成值输入控件关键点：
Codec 只解决 NBT <-> TWrapperFactory<String, T> 只解决 String <-> TCustomWidgetFactory<T> 只解决 AttrKeyValue 创建 GUI，GUI的行为应该转换为String状态更新向AttrKeyValueAttrKeyValue负责将用户GUI交互转换来的String反向解析为T，并进行条件验证。如果未能通过验证或者格式错误，则不会更新真实值NBTType 把这三者合并成“配置系统可用的完整类型”当创建Ref的时候，需要指定类型
如果一个类实现了NBTParsable接口 并且他类里存在静态字段NBTType TYPE 则在创建Ref的时候会自动加载该TYPE
通过读取这个TYPE, NBTRef可以惰性加载nbt字符串为具体实例
AttrKeyValue 在这里到底干什么AttrKeyValue<T> 维护的是：
valueoriginValueString <-> T 工厂BaseAttrKeyValue 的核心工作流是：
valueChange(...) 更新字符串缓存validateAndUpdate() 用 stringifyFactory.create(getValue()) 解析出 ToriginValueRef所以：
AttrKeyValue 负责把字符串态收敛回真实值CustomWidgetFactory<T> 决定“怎么编辑”基础类型默认是文本框或布尔按钮。
复杂类型则可以：
因为 GUI 不是从业务类反射出来的，而是从 NBTType.customWidgetFactory 明确给出的。
适合本质上只是别名 / 包装的类型。
套路：
createXMap(...)createComapFlatMap(...)它们会复用底层类型的：
并通过 TypeConvertAttrKeyValue 把“外层值”和“内层值”互转。
适用场景：
String 包装成 PatternString 包装成 Identifier适合固定字段个数的小结构。
套路参考：
Vec2TracingOptionPositionPredict.PredictArgument做法是：
TypeConvertAttrKeyValue 把整个对象投影成“某一个字段”NBTTypeSubScreenWidget也就是：
整体对象 T
-> 某个字段 A 的代理 AttrKeyValue<A>
-> A 对应已有的输入控件
适合 list / map / pair-list / array-map 一类组合结构。
套路参考：
NBTTypes.createListLke(...)NBTTypes.createPairLike(...)NBTTypes.createArrayMapLike(...)PrimitiveListEntryPrimitiveMapBoundedPrimitiveMap这类类型一般不是在主界面直接铺开所有输入框，而是：
WrapperFactory 的真实职责WrapperFactory<A, B> 不是仅给字符串用的，它是整个体系的“类型桥”。
常见职责有三类：
String <-> T
例如：
INT_FACTORYDOUBLE_FACTORYNBT_FACTORYSTR_LIST_FACTORYSTR_MAP_FACTORYList<W> <-> T
Map<K, V> <-> T
Pair<K1, K2> <-> T
例如：
WrapperFactory.list(...)WrapperFactory.map(...)WrapperFactory.getListMapWrapper()把已有 AttrKeyValue<Outer> 投影成 AttrKeyValue<Inner>，继续复用已有 GUI。
这里会大量配合：
TypeConvertAttrKeyValueWrapperAttrKeyValueTypeConvertAttrKeyValue 和 WrapperAttrKeyValue 的分工TypeConvertAttrKeyValue用于“基于一个外层对象，投影出一个可编辑内层值”。
典型用途：
它会：
WrapperAttrKeyValue用于“整个值结构变了，但仍想复用 delegate 的字符串链或生命周期”。
典型用途：
AttrKeyValue<TOuter> 包成 AttrKeyValue<TInner>TypeConvertAttrKeyValueWrapperAttrKeyValueNBTTypes 里的组合器怎么选createXMap / createComapFlatMap适合单值包装。
输入特征：
createListLke适合“列表像”结构。
输入特征：
List<W>TcreatePairLike适合固定二元结构。
输入特征：
(K1, K2)createArrayMapLike适合“以 pair 列表存盘、逻辑上当 map 用”的结构。
输入特征：
Map<K1, K2>注意：
CodecUtils.arrayMapCodec(...) 会把 map 存成 pair 列表LinkedHashMap 用来保序这个仓库里的 primitive 不是 Java primitive，而是“可携带自身类型信息的值盒子”。
Primitive<T>它持有：
valueTypevaluevalueString字符串协议是：
<primitive-type>|<value-string>
解析时先按前缀找 NBTTypes.PRIMITIVE_TYPES，再用对应 stringifyFactory 解析值。
这意味着：
NBTTypes.init() 扫描注册的 primitive typeNBTTypes.PRIMITIVE_TYPESPrimitiveList<W>它本质上是：
elementTypeList<W>但为了序列化和编辑，会在运行时来回转成：
List<Primitive<W>>这样每个元素都带着类型信息或至少与 elementType 协调。
EntryPrimitiveMap<T, W>它本质上是：
Map<T, W>Map<Holder<T>, Primitive<W>>也就是：
Holder<T>Primitive<W>NBTParsable 时的硬规则TYPEpublic static final NBTType<Xxx> TYPE = ...;
没有它，NBTParsable.onLoad(Class) 就无法自动注册。
type() 必须返回这个 TYPE否则 NBTRef 校验类型名时会错位。
empty 必须是真实可编辑空值它不是摆设。
这些地方会依赖它：
stringifyFactory 不能只顾着打印它必须满足：
如果真实存的是 pair / list / map：
NBTTypes 的组合器例如：
Registry这类参数必须成为值本体的一部分，不能只存在于 builder 外部。
否则 reload 后无法从持久化数据恢复完整类型。
CodecString <-> T 协议NBTType<T>NBTParsable、TYPE、type()、默认值接入 builder不要反过来从 GUI 开始硬拼。
NBTTypes 现成组合器LinkedHashMap 语义处理PrimitiveList它展示了：
List<W> 如何转成 List<Primitive<W>>EntryPrimitiveMap它展示了：
如果要继续做“primitive - primitive map”或“primitive pair list”，优先沿着这两个样板扩展，不要重新发明协议。