AncTe
0207f3ce7b
- B-03: enemy-specials.md 新增「内置属性编号表」（0..26，逐条抄自当前 special.ts），表下 warning 诚实标注地图伤害转换器编号未对齐（以 special.ts 为准，不臆造对齐表） - B-03: enemy-map-damage.md 明确点出 code 18 在内置表=无敌、转换器=阻击的双重含义 - B-03: enemy-combat-script.md 的 code 18 示例注明 18=无敌，并说明转换器未对齐与本篇无关 - R2-01: 解释 @motajs/anon-tokyo 的来历（events.md + src-tour.md「包从哪来」） - R2-02: enemy-aura.md 补 ISpecial23Value 字段说明表 - R2-03: 补 initializeEnemy 一句话介绍（集中注册入口，内置/自定义同一流程） - R2-04: events.md 说明参数接口实际放入 src/data/event/types.ts - R2-05: hero-equipment.md 接口清单补 compareEquip - R2-06: enemy-map-damage.md code-43 示例补关键类型注解 - 追加第 2 轮复审与修正记录到 10-11-READER-REVIEW.md
3.5 KiB
勇士装备
装备是一种特殊的道具：它要穿到某个槽位上，并给属性加成。为了把「穿在哪」和「拥有哪些」分开管，装备系统分成了两部分——state.hero.equip 管理装备槽（哪件装备穿在哪一栏），state.hero.items.equipment 是装备实例仓库（管理所有已获得的装备实例）。本篇介绍如何用这两组接口。
装备槽（IHeroEquipment）
state.hero.equip 管的是「穿在身上的装备」，它提供：
slots：装备槽位数组，每一项是这一栏的名称；setSlots(slots)：设置装备槽；canEquipTo(uid, slot)：判断某件装备能否装备到指定槽，返回EquipStatus；equip(uid, slot, autoUnload?)：把装备穿上；unequip(slot)：卸下指定槽的装备；equipped(uid)：查询某装备是否处于装备状态；getEquipped(slot)：取指定槽的装备 uid；getEquips()：按槽位顺序取所有已装备实例；compareEquip(equipA, equipB, slot)：比较两件装备在同一槽位上的属性表现，详见下文「比较装备」。
slot 可以传装备槽索引（数字）或槽位名称（字符串）。EquipStatus 有三个取值：CanEquip（可以直接装备）、CannotEquip（不能装备）、NeedReplace（需要替换槽位上的装备）。
equip 的 autoUnload 参数默认为 true：当要装备的装备当前穿在别的槽上时，自动把它从原槽卸下。equip 与 unequip 都会返回被卸下的装备 uid（没有则为 undefined）。
const uid = state.hero.items.equipment.add('sword');
state.hero.equip.equip(uid, 0);
const off = state.hero.equip.unequip(0);
装备实例仓库（IHeroEquipsStore）
state.hero.items.equipment 管的是「背包里所有的装备实例」——同一件装备可以有多件，各自独立，所以这里存的是实例而非装备本身。它提供：
add(item)：获得一件装备道具、创建实例，返回新实例的 uid；delete(uid)：移除指定装备实例；get(uid)：取指定装备实例的状态，与是否装备无关；instancesOf(equip)：取某件装备的所有实例；instances()：取当前所有装备实例；count(item)：取某件装备的实例总数。
const instances = state.hero.items.equipment.instancesOf('sword');
const total = state.hero.items.equipment.count('sword');
装备的加成
每件装备实例（IEquipmentState）对勇士属性提供数值加成与百分比加成，分别通过 getValue / getPercentage 读取，setValue / setPercentage 修改。这两类加成本质上就是勇士属性中的修饰器：装备时把对应的 ValueModifier / PercentageModifier 挂到勇士属性上，卸下时移除，因此不必手动维护加成数值。
const equipState = state.hero.items.equipment.get(uid);
equipState?.setValue('atk', 12);
const atkBonus = equipState?.getValue('atk') ?? 0;
比较装备
compareEquip(equipA, equipB, slot) 用于比较两件装备在指定装备槽上的表现，返回「装备 A 时属性 − 装备 B 时属性」的差值。传入 -1 表示该侧无装备，可用来比较「某件装备相对空槽」的提升。
const diff = state.hero.equip.compareEquip(uid, -1, 0);
// diff.atk 即装备这件装备相对空槽的攻击提升