用途
Biped Slot Reference 是一个参考查找类技能,用于在 Skyrim 中按 biped 槽位定位、筛选、审计或修补护甲与服装记录。Skyrim 的护甲和服装占用编号 30–61 的 biped 槽位,这些槽位以位掩码形式存储在记录的 BodyTemplate.FirstPersonFlags 字段中。该技能把槽位——无论是数字(如 52)、原版名称(如 Body)还是社区标签(如 SOS、pelvis、背部/披风槽)——转换为正确的 housecarl_cross_plugin_query 过滤条件,使“查找槽位 X 上的所有护甲”变成一次查询而非猜测。
主要能力
- 提供经过验证的槽位 30–61 对照表(编号、位、要传入的值、十六进制、Mutagen 名称、备注),以及命名注意事项和社区约定,位于 references/biped-slots.md。
- 支持通过 housecarl_cross_plugin_query 的 where ... has 谓词进行位测试查询,使多槽位物品仍能匹配所查询的单个槽位。
- 支持对命名槽位(30–43、50、51、61)使用标志名称(如 has Body、has Feet、has DecapitateHead),对模组槽位(44–49、52–60)使用表中数值(如 has 4194304 或 has 0x400000)。
- 说明 = 精确匹配仅用于单槽位记录,会静默跳过所有组合槽位。
- 说明 FirstPersonFlags 作为 [Flags] 枚举的渲染分裂:当所有置位均为命名槽位时显示名称,一旦出现模组槽位则显示原始十进制数。
- 指出两个命名槽位隐藏在模组范围内:50 DecapitateHead 和 51 Decapitate。
使用方式
第一步是打开槽位表:阅读 references/biped-slots.md 获取槽位 30–61 的验证表,取出任务所指槽位的值,不要心算 2^(N−30)。
查询时使用 where ... has 谓词(位测试),例如:
housecarl_cross_plugin_query( type="Armor", where=["BodyTemplate.FirstPersonFlags has 4194304"]) # slot 52
has <value> 在该位被置位时为真,无论其他槽位如何,因此 body+slot-52 的部件也会匹配。当物品可能占用多个槽位时(大多数护甲如此)应使用它。
模组槽位(44–49、52–60):传入表中的数值,如 has 4194304 或 has 0x400000。
命名槽位(30–43、50、51、61):标志名称也可用,如 has Body、has Feet、has DecapitateHead。
精确单槽位:= 4194304 仅匹配槽位 52 且不含其他槽位的记录,仅在明确需要单槽位部件时使用。它会静默跳过所有组合,这是让槽位看起来为空实则非空的陷阱。
has 也可用于普通整数字段,数值范围现在也可用于标志字段(FirstPersonFlags >= 65536 不再报错),但判断“该槽位是否被占用”时应使用 has。
适用场景
- 按槽位编号、槽位名称或 FirstPersonFlags 值查找、筛选、审计或修补 Skyrim 护甲/服装。
- 需要确认某物品实际使用哪个槽位时,读取其 BodyTemplate.FirstPersonFlags(houseCARL 会返回)或用 has 查询该位并检查命中结果。
限制
- 该技能仅按 biped 槽位定位和筛选记录,不负责分发或编辑:向找到的物品分发关键字应使用 kid-authoring;向 NPC 分发法术/技能/物品应使用 spid-authoring;更改记录自身字段(包括 FirstPersonFlags)应使用 skypatcher-authoring 或 houseCARL 记录写入。
- 社区槽位约定(SOS = 52、背部槽位约 46–48 等)只是提示而非保证,模组槽位没有引擎强制含义,模组可使用任意空闲槽位。位才是事实依据,约定只是猜测。若无法确认槽位,应说明而非依据约定断言。
- 手工推算映射容易出错:槽位 N 是位 (N − 30),值为 2^(N − 30),且字段渲染不一致(命名槽位显示为文本,模组槽位显示为原始数字)。手工猜测的掩码会静默过滤错误槽位,看起来却像干净答案。