feat(skill-system): 新增计时debuff机制,支持技能命中敌方附加减益效果
本次提交完整实现了技能对敌附加debuff的完整流程: 1. 新增TimedDebuffSnapshot数据结构,用于透传debuff配置 2. 在SkillConfig和SkillOverrides中新增debuff相关配置项 3. 实现HeroAtkSystem中debuff的判定与施加逻辑 4. 完善后台配置、前端编辑器的debuff配置支持 5. 调整了buff目标判定逻辑,修复了原有默认目标的语义混淆问题 6. 优化了BuffSystem的调试日志,新增了debuff分类标识 7. 批量更新了现有英雄技能的debuff配置示例
This commit is contained in:
@@ -31,10 +31,9 @@
|
||||
"lv": 2,
|
||||
"s_lv": 2,
|
||||
"overrides": {
|
||||
"timed_buff_id": 7012,
|
||||
"buff_value": 30,
|
||||
"buff_chance": 100,
|
||||
"buff_duration": 5
|
||||
"timed_debuff_id": 7007,
|
||||
"debuff_value": -10,
|
||||
"debuff_chance": 100
|
||||
},
|
||||
"desc": "普通攻击造成 120% 攻击伤害"
|
||||
}
|
||||
@@ -146,7 +145,7 @@
|
||||
"cdExpr": null,
|
||||
"overrides": {
|
||||
"ap": 150,
|
||||
"timed_buff_id": 7002,
|
||||
"timed_debuff_id": 7002,
|
||||
"icon": "Stat_AttackSpeed_02"
|
||||
},
|
||||
"desc": "斩出气刃,对{target}造成攻击力{ap}%伤害,并使目标易伤(受到伤害加深,持续{dur}秒)",
|
||||
@@ -435,11 +434,11 @@
|
||||
"lv": 2,
|
||||
"s_lv": 2,
|
||||
"overrides": {
|
||||
"timed_buff_id": 7007,
|
||||
"buff_value": 30,
|
||||
"buff_chance": 30
|
||||
"timed_debuff_id": 7007,
|
||||
"debuff_value": 30,
|
||||
"debuff_chance": 30
|
||||
},
|
||||
"desc": "普通攻击有{buff_chance}%概率使目标出血(每0.5秒受到{buff_value}点伤害,持续{dur}秒)"
|
||||
"desc": "普通攻击有{debuff_chance}%概率使目标出血(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -458,20 +457,20 @@
|
||||
"s_lv": 2,
|
||||
"overrides": {
|
||||
"ap": 250,
|
||||
"timed_buff_id": 7007,
|
||||
"buff_value": 40
|
||||
"timed_debuff_id": 7007,
|
||||
"debuff_value": 40
|
||||
},
|
||||
"desc": "高速斩击{target},造成攻击力{ap}%,并使目标出血(每0.5秒受到{buff_value}点伤害,持续{dur}秒)"
|
||||
"desc": "高速斩击{target},造成攻击力{ap}%,并使目标出血(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)"
|
||||
},
|
||||
{
|
||||
"lv": 16,
|
||||
"s_lv": 3,
|
||||
"overrides": {
|
||||
"ap": 350,
|
||||
"timed_buff_id": 7007,
|
||||
"buff_value": 60
|
||||
"timed_debuff_id": 7007,
|
||||
"debuff_value": 60
|
||||
},
|
||||
"desc": "高速斩击{target},造成攻击力{ap}%,附带 50% 概率麻痹,并使目标出血(每0.5秒受到{buff_value}点伤害,持续{dur}秒)"
|
||||
"desc": "高速斩击{target},造成攻击力{ap}%,附带 50% 概率麻痹,并使目标出血(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -1479,11 +1478,11 @@
|
||||
"lv": 2,
|
||||
"s_lv": 2,
|
||||
"overrides": {
|
||||
"timed_buff_id": 7005,
|
||||
"buff_value": 30,
|
||||
"buff_chance": 30
|
||||
"timed_debuff_id": 7005,
|
||||
"debuff_value": 30,
|
||||
"debuff_chance": 30
|
||||
},
|
||||
"desc": "普通攻击有{buff_chance}%概率使目标中毒(每0.5秒受到{buff_value}点伤害,持续{dur}秒)"
|
||||
"desc": "普通攻击有{debuff_chance}%概率使目标中毒(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -1494,12 +1493,12 @@
|
||||
"cdExpr": null,
|
||||
"overrides": {
|
||||
"ap": 150,
|
||||
"timed_buff_id": 7005,
|
||||
"buff_value": 30,
|
||||
"buff_chance": 50,
|
||||
"timed_debuff_id": 7005,
|
||||
"debuff_value": 30,
|
||||
"debuff_chance": 50,
|
||||
"icon": "4-Apply-Poison"
|
||||
},
|
||||
"desc": "毒箭如雨,对{target}造成攻击力{ap}%伤害,{buff_chance}%概率使目标中毒(每0.5秒受到{buff_value}点伤害,持续{dur}秒)",
|
||||
"desc": "毒箭如雨,对{target}造成攻击力{ap}%伤害,{debuff_chance}%概率使目标中毒(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)",
|
||||
"lv_entries": [
|
||||
{
|
||||
"lv": 8,
|
||||
@@ -1534,11 +1533,11 @@
|
||||
"t_num": 3,
|
||||
"overrides": {
|
||||
"ap": 80,
|
||||
"timed_buff_id": 7005,
|
||||
"buff_value": 40,
|
||||
"buff_chance": 100
|
||||
"timed_debuff_id": 7005,
|
||||
"debuff_value": 40,
|
||||
"debuff_chance": 100
|
||||
},
|
||||
"desc": "追加射出蚀骨毒箭,对{target}造成攻击力{ap}%伤害,必定使目标中毒(每0.5秒受到{buff_value}点伤害,持续{dur}秒)"
|
||||
"desc": "追加射出蚀骨毒箭,对{target}造成攻击力{ap}%伤害,必定使目标中毒(每0.5秒受到{debuff_value}点伤害,持续{dur}秒)"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -1726,10 +1725,10 @@
|
||||
"lv": 2,
|
||||
"s_lv": 2,
|
||||
"overrides": {
|
||||
"timed_buff_id": 7008,
|
||||
"buff_chance": 30
|
||||
"timed_debuff_id": 7008,
|
||||
"debuff_chance": 30
|
||||
},
|
||||
"desc": "普通攻击有{buff_chance}%概率使目标破甲(防御降低,持续{dur}秒)"
|
||||
"desc": "普通攻击有{debuff_chance}%概率使目标破甲(防御降低,持续{dur}秒)"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -1740,7 +1739,7 @@
|
||||
"cdExpr": null,
|
||||
"overrides": {
|
||||
"ap": 150,
|
||||
"timed_buff_id": 7008
|
||||
"timed_debuff_id": 7008
|
||||
},
|
||||
"desc": "释放碎甲能量波,对{target}造成攻击力{ap}%伤害,并使目标破甲(防御降低,持续{dur}秒)",
|
||||
"lv_entries": [
|
||||
@@ -1775,7 +1774,7 @@
|
||||
"t_num": 1,
|
||||
"overrides": {
|
||||
"ap": 150,
|
||||
"timed_buff_id": 7008
|
||||
"timed_debuff_id": 7008
|
||||
},
|
||||
"desc": "战斗开始时掷出蚀甲酸瓶,对{target}造成攻击力{ap}%伤害,并必定使其破甲(防御降低,持续{dur}秒)"
|
||||
}
|
||||
|
||||
@@ -87,7 +87,7 @@
|
||||
## 6. overrides 白名单与特殊存储格式
|
||||
|
||||
可用键(对照 `SkillSet.ts` 的 `SkillOverrides` 接口;编辑器 UI 白名单 `OVERRIDE_KEYS` 是其子集,手动改 JSON 可用全集):
|
||||
`ap, hit_count, hitcd, crt, frz, stun, para, bck, bck_chance, TGroup, buff_type, timed_buff_id, buff_value, buff_duration, buff_chance, buff_target, call_hero, summon_count, is_accel, num, revive_hp, revive_count, proc_skill, icon`
|
||||
`ap, hit_count, hitcd, crt, frz, stun, para, bck, bck_chance, TGroup, buff_type, timed_buff_id, buff_value, buff_duration, buff_chance, buff_target, timed_debuff_id, debuff_value, debuff_duration, debuff_chance, call_hero, summon_count, is_accel, num, revive_hp, revive_count, proc_skill, icon`
|
||||
|
||||
特殊存储格式(导出时由 server 还原为 TS 枚举表达式):
|
||||
- `TGroup`:JSON 存字符串(如 `"Team"`),导出还原 `TGroup.Team`;`null` 表示不覆写;
|
||||
@@ -96,27 +96,35 @@
|
||||
- `icon`:字符串图标帧名(uicons 图集),非数值;
|
||||
- 其余一律直存数值。
|
||||
|
||||
引用校验:`timed_buff_id` 必须 ∈ `BuffList`;`proc_skill.s_uuid` / 触发组 key / 召唤类引用必须 ∈ `SkillSet`。
|
||||
引用校验:`timed_buff_id` / `timed_debuff_id` 必须 ∈ `BuffList`;`proc_skill.s_uuid` / 触发组 key / 召唤类引用必须 ∈ `SkillSet`。
|
||||
|
||||
### 6.1 timed_buff_id(计时 buff 注入)
|
||||
### 6.1 timed_buff_id / timed_debuff_id(计时 buff / debuff 注入)
|
||||
|
||||
**编辑器 UI**:overrides 添加 `timed_buff_id 计时buff` 行后,值栏为 BuffList 下拉(`id 名称` + 右侧 buff 效果摘要,数据来自 `/api/meta` 的 `BuffList`);meta 未加载时可手输数字 id(allow-create,保存时自动归一化为数字)。选定 buff id 后编辑器自动补齐 `buff_value` / `buff_chance` / `buff_duration` 三行(已存在不重复),数值预填 BuffList 默认值。
|
||||
**语义划分(新规则)**:
|
||||
- `timed_buff_id`:**增益语义**。释放/命中时给友方或自身挂 buff;伤害技能缺省挂**施法者自身**(如吸血、攻击后强化),辅助技能缺省挂**友方目标**。可用 `buff_target` 覆写目标。
|
||||
- `timed_debuff_id`:**减益语义**。命中敌人后给**被命中者**挂 debuff(目标固定,不可覆写);仅伤害路径(HeroAtkSystem)结算,DoT 不触发。
|
||||
|
||||
**编辑器 UI**:overrides 添加 `timed_buff_id 计时buff` 或 `timed_debuff_id 计时debuff` 行后,值栏为 BuffList 下拉(`id 名称` + 右侧 buff 效果摘要,数据来自 `/api/meta` 的 `BuffList`);meta 未加载时可手输数字 id(allow-create,保存时自动归一化为数字)。选定 id 后编辑器自动补齐配套三行(buff 补 `buff_value`/`buff_chance`/`buff_duration`,debuff 补 `debuff_value`/`debuff_chance`/`debuff_duration`,已存在不重复),数值预填 BuffList 默认值。
|
||||
|
||||
**配套键**(同一 overrides 内按需添加):
|
||||
|
||||
| 键 | 说明 | 缺省 |
|
||||
|---|---|---|
|
||||
| `buff_value` | 覆写修饰数值(modifiers.value / tick.damage_or_heal,单位同 BuffList) | 回退 BuffList 默认 |
|
||||
| `buff_duration` | 覆写持续时间(秒) | 回退 BuffList.duration |
|
||||
| `buff_chance` | 触发概率 %(命中时掷骰) | 100(必触发) |
|
||||
| `buff_target` | 施加目标:0 被命中者(Hit) / 1 施法者(Self) / 2 全体友方(Ally) / 3 全体敌方(Enemy) | 按主效果推导:伤害→被命中者,辅助→友方 |
|
||||
| `buff_value` | 覆写 buff 修饰数值(modifiers.value / tick.damage_or_heal,单位同 BuffList) | 回退 BuffList 默认 |
|
||||
| `buff_duration` | 覆写 buff 持续时间(秒) | 回退 BuffList.duration |
|
||||
| `buff_chance` | buff 触发概率 %(命中时掷骰) | 100(必触发) |
|
||||
| `buff_target` | buff 施加目标:0 被命中者(Hit) / 1 施法者(Self) / 2 全体友方(Ally) / 3 全体敌方(Enemy) | 按主效果推导:伤害→施法者自身,辅助→友方目标 |
|
||||
| `debuff_value` | 覆写 debuff 修饰数值 | 回退 BuffList 默认 |
|
||||
| `debuff_duration` | 覆写 debuff 持续时间(秒) | 回退 BuffList.duration |
|
||||
| `debuff_chance` | debuff 触发概率 %(命中时掷骰) | 100(必触发) |
|
||||
|
||||
**生效路径(重要)**:
|
||||
- ✅ 友方/辅助技能(TGroup 为 Self/Team/Ally,或 6300/6500 段辅助底座):走 SCastSystem merged config,overrides 注入完整生效;`buff_target: 3`(Enemy)可把 buff 分流挂到敌方网格,实现对敌 debuff;
|
||||
- ✅ 对敌技能的命中附带 debuff:以 SkillSet **底座配置**为准(HeroAtkSystem 按 `SkillSet[s_uuid]` 读取 `timed_buff_id`/`buff_chance` 等),对敌 debuff 写入底座即可起效;
|
||||
- ✅ 友方/辅助技能(TGroup 为 Self/Team/Ally,或 6300/6500 段辅助底座):走 SCastSystem merged config,`timed_buff_id` 注入完整生效;`buff_target: 3`(Enemy)可把 buff 分流挂到敌方网格(如群体减甲);
|
||||
- ✅ 对敌伤害技能的命中附带 debuff:用 `timed_debuff_id`(可写在 SkillSet 底座或 heroSet overrides),HeroAtkSystem 命中结算时挂被命中者;
|
||||
- ✅ 对敌伤害技能的命中附带增益(吸血/自强化):用 `timed_buff_id`,缺省挂施法者自身;
|
||||
- 同一 overrides 不要既配 `timed_buff_id` 又依赖永久 `buff_type` 加成:timed 路径生效后永久分支被跳过。
|
||||
|
||||
**语义陷阱**:`buff_target` 缺省为被命中者——若想"攻击回血/吸血",必须显式配 `"buff_target": 1`,否则 buff 挂到被打的敌人身上(如 7010 回血会奶敌人)。
|
||||
**语义陷阱**:`timed_buff_id` 在伤害技能上缺省挂**施法者自身**——若想"命中给敌人挂减益",必须用 `timed_debuff_id`,否则会把减益挂到自己身上。
|
||||
|
||||
### 6.2 proc_skill(命中概率触发主动技能)
|
||||
|
||||
@@ -166,5 +174,5 @@
|
||||
- 普攻用数值 cd 而不给 `cdExpr` → 丢失攻速档位语义(编辑器攻速下拉失效);
|
||||
- 档位 overrides 全量复制基础档 → 浅合并下冗余且后续改基础值不生效;
|
||||
- desc 与 overrides 数值脱节 → desc 模板只写 `{ap}` 等占位符,不要硬编码数字;
|
||||
- 对敌技能 debuff 写在 overrides → 命中附带判定按 SkillSet 底座读取,应写入底座配置(详见 §6.1);
|
||||
- 想做吸血但漏配 `buff_target:1` → 缺省挂被命中者,回血 buff 会奶敌人。
|
||||
- 对敌技能 debuff 误用 `timed_buff_id` → buff 缺省挂施法者自身,会把减益挂到自己身上;应改用 `timed_debuff_id`(详见 §6.1);
|
||||
- 想做吸血但把 buff 写到 `timed_debuff_id` → debuff 目标固定为被命中者,会奶敌人;吸血/自强化请用 `timed_buff_id`(缺省即挂自身)。
|
||||
|
||||
Reference in New Issue
Block a user