物品详解

数据库中的ancillary覆盖游戏里的武器、护甲、护符、附魔物品、奥术物品、坐骑、随从和旗帜等多种对象。本文统一按玩家界面称为“物品”，在表名和字段名中保留ancillary。

完整数据链

ancillaries_tables
    ├─ ancillary_types_tables
    ├─ ancillary_info_tables
    ├─ ancillary_to_effects_tables
    ├─ ancillary_to_included_agents_tables
    ├─ ancillaries_included_agent_subtypes_tables
    ├─ ancillaries_required_skills_tables
    ├─ ancillary_to_equipment_variants_tables
    └─ ancillary_set_ancillary_junctions_tables
             └─ ancillary_sets_tables
                    └─ ancillary_set_effect_junctions_tables

获得入口可能来自：
任务、事件、战后掉落、角色技能、仪式、脚本、起始数据或特殊系统

核心表单

表单	负责什么
ancillaries_tables	物品 Key、名称、类型、适用对象、唯一性和基础行为。
ancillary_types_tables	物品栏类型和类型图标。
ancillary_to_effects_tables	物品装备或拥有时提供的 Effect。
ancillary_info_tables	历史示例、作者和开发备注。
ancillary_to_included_agents_tables	限定领主、英雄等角色大类。
ancillaries_included_agent_subtypes_tables	限定具体角色类型。
ancillaries_required_skills_tables	要求角色拥有指定技能等级。
ancillary_to_equipment_variants_tables	把物品连接到角色模型装备变体。
ancillary_sets_tables	定义物品套装名称、说明和图标。
ancillary_set_ancillary_junctions_tables	把物品放入套装。
ancillary_set_effect_junctions_tables	套装提供的 Effect。

ancillaries_tables

橙色框从左到右标出物品 Key、类型、适用对象，以及可转移和唯一性控制字段。

身份和显示

字段	含义
key	物品唯一 Key。
onscreen_name	游戏显示名称。
type	物品栏类型，引用ancillary_types。
category、subcategory	更细的界面和系统分类。
colour_text	名称或说明颜色入口。
explanation_text	物品说明。
legendary_item	是否按传奇物品处理。

物品图标不一定直接保存在ancillaries_tables。具体图像、界面样式或模型可能由类型、装备变体和其他 UI 资源决定，应该从同类别模板查找。

装备、转移和销毁

字段	含义
applies_to	适用的角色大类入口。
transferrable	是否可在角色之间转移。
turns_before_swap_allowed	再次交换前的回合限制。
can_be_stolen	是否可被偷取。
can_be_destroyed	是否允许销毁或分解。
randomly_dropped	是否进入相应随机掉落流程。它不等于一定会掉落。
mp_exclusive	是否只用于多人或相应模式。
is_wife_ancillary	旧式或特殊随从系统标记。普通物品不要开启。

唯一性和时间

字段	含义
unique_to_world	全世界唯一。
unique_to_faction	每个派系唯一。
uniqueness_score	唯一性竞争或选择分数入口。
precedence	多个候选记录之间的优先级。
start_date、end_date	适用日期范围。普通物品通常沿用模板空值。
min_starting_age、max_starting_age	初始角色年龄范围。
min_expiry_age、max_expiry_age	过期年龄范围。
immortal	特殊不可失去或持续行为入口，必须按同类模板验证。

直接授予战斗内容

字段	含义
avatar_skill	角色模型或 Avatar 系统技能入口。
avatar_special_ability	直接关联的特殊能力入口。
provided_bodyguard_unit	提供的亲卫单位。
provided_banner	提供的旗帜。
faction_set	派系集合限制入口。

这些字段不是普通数值效果的替代品。近战攻击、护甲、收入等仍通常通过ancillary_to_effects_tables实现。

物品效果

ancillary_to_effects_tables字段：

字段	含义
ancillary	哪件物品。
effect	提供哪个 Effect。
value	数值。
effect_scope	影响角色、所属军队、派系或其他对象。

同一件物品可以有多条 Effect。角色自身加成、所属军队加成和派系加成应使用与原版物品相同上下文的 Scope，不能只按英文名字猜。

谁可以装备

装备权限可能同时由多张表控制：

• applies_to：角色大类。
• ancillary_to_included_agents_tables：领主、英雄等 Agent 类型。
• ancillaries_included_agent_subtypes_tables：具体角色类型。
• ancillaries_required_skills_tables：指定技能及等级。
• ancillary_included_subcultures_tables：Schema 中的子文化入口；当前 Assembly Kit 原始表没有正式记录，使用前验证。
• 派系集合、所有权内容包、任务和脚本条件。

一个物品在界面里不出现时，应检查整条权限链，不要立刻删除applies_to限制。

物品套装

ancillary_sets_tables

包含key、name、description和icon，定义套装身份与显示。

套装成员和效果

• ancillary_set_ancillary_junctions_tables：用ancillary_key和set_key添加成员。
• ancillary_set_effect_junctions_tables：用set_key、effect_key、effect_scope和value添加套装效果。

套装效果是否要求集齐、怎样在 UI 中显示，应复制同一套原版系统的结构并进游戏验证。不要仅凭表名假定任意数量成员都会自动触发。

物品怎样获得

一件物品定义完成后，仍需要获得入口。常见路径包括：

• 角色技能达到指定等级。
• 任务链或传奇物品任务。
• 事件、困境或战后结果。
• 起始角色物品。
• 仪式或其他载荷。
• 战役脚本直接授予。
• 特定掉落或制造系统。

当前 Assembly Kit 原始数据中的ancillary_triggers_tables没有正式记录，因此它不是可以无条件套用的现代通用掉落表。

怎样查找模板

1. 在游戏中找同一个物品栏位、同类角色和相近效果的原版物品。
2. 用简体中文名称定位ancillaries.key。
3. 全局搜索 Key，找到 Effect、角色限制、装备变体、套装和授予来源。
4. 对每个 Effect 继续检查 Bonus Value 与 Scope。
5. 对获得入口追踪到任务、事件或脚本的触发条件。

武器、随从和旗帜的共同点是都使用ancillary框架，但模型、权限、目标单位和界面位置不同，不能只复制一张ancillaries_tables记录互换类型。

新建物品的推荐顺序

1. 创建唯一 Key，选择正确type和分类。
2. 填写游戏名称、说明及必要界面资源。
3. 配置适用角色、可转移、唯一性和销毁规则。
4. 添加 Effect、战斗技能或亲卫等实际功能。
5. 如需外观变化，连接正确装备变体。
6. 如属于套装，添加成员和套装效果。
7. 选择真实获得入口，并设计重复获得和唯一性处理。
8. 运行 RPFM 诊断，检查本地化和引用。
9. 在游戏中获得、装备、转移、卸下、保存和读取。

常见错误

• 物品存在但无法获得：缺少任务、事件、脚本或其他授予入口。
• 获得后无法装备：角色类型、子类型、技能或派系限制不匹配。
• 物品有效但角色模型没变化：缺少装备变体或目标角色模型不支持。
• 卸下后效果仍在：检查 Scope、效果刷新和脚本授予是否另有来源。
• 世界唯一物品重复出现：检查唯一性字段和授予脚本是否绕过正常掉落系统。
• 套装显示但套装效果无效：检查成员 Key、套装 Effect 和游戏实际触发条件。

游戏内验收

• 正确角色能够获得和装备，其他角色受限。
• 名称、说明、栏位、颜色和图标正确。
• 每条 Effect 与部队技能作用于正确对象。
• 转移、冷却回合、偷取和销毁符合设计。
• 唯一物品不会被非预期重复授予。
• 套装和模型外观在保存读取后保持正确。

RPFM 诊断不能执行任务和脚本，也不能证明角色模型支持装备变体。至少完成一次真实获得、装备和存档读取测试。