147 lines
5.8 KiB
TypeScript
147 lines
5.8 KiB
TypeScript
/**
|
||
* @file BossPhaseSet.ts
|
||
* @description Boss 多阶段战斗方案配置（固定 3 阶段：P1 基线 / P2 / P3）
|
||
*
|
||
* 数据流：heroInfo.phase_ids（允许方案）→ RogueConfig.makeBoss 随机取一
|
||
* → Mon.load 第 8 参 → BossPhaseComp → BossPhaseSystem 检测切换
|
||
*
|
||
* 设计约束：
|
||
* - 方案 id 使用 10000 段（9100 段已被 TalentSet 9101-9199 / ICardSet 9101~9110 占用）
|
||
* - 增量驱动：切换 = removes 移除 + adds 注入，P1 = 基线技能（heroInfo.skills + RogueConfig 大招）无需配置
|
||
* - removes/adds 禁止操作普攻首键（SCastSystem.buildSkillCandidates 硬假设首键=普攻垫底；
|
||
* JS delete+set 会把键移到末尾，破坏普攻垫底契约）
|
||
* - 混合触发：同一切换点 hp_pct / time 任一满足即切换；
|
||
* hp_pct 切换点必须构成前缀（time-only 点之后禁止再配 hp_pct，防乱序连切）
|
||
*/
|
||
|
||
import { SkillSet, SkillOverrides } from "./SkillSet";
|
||
|
||
/** 阶段切换触发条件（混合触发：任一条件满足即切换） */
|
||
export interface PhaseTrigger {
|
||
/** 血量百分比阈值（1~99）：Boss 血量比例 ≤ 该值时触发 */
|
||
hp_pct?: number;
|
||
/** Boss 在场战斗秒数：超过该时长触发 */
|
||
time?: number;
|
||
}
|
||
|
||
/** 切换瞬间一次性属性修正（基于当前值链式乘算，P3 基于 P2 修正后的值） */
|
||
export interface PhaseAttrMod {
|
||
/** 攻击 ±% */
|
||
ap_pct?: number;
|
||
/** 防御 ±%（applyDefense 除法递减模型，收益非线性，配值按公式校验） */
|
||
defense_pct?: number;
|
||
}
|
||
|
||
/** 注入技能条目（与 RogueConfig 大招条目同构，cd 缺省由系统兜底 8s） */
|
||
export interface PhaseSkillEntry {
|
||
s_uuid: number;
|
||
cd?: number;
|
||
overrides?: SkillOverrides;
|
||
}
|
||
|
||
/** 单个切换点定义（switches[0] = P1→P2，switches[1] = P2→P3） */
|
||
export interface PhaseSwitchDef {
|
||
trigger: PhaseTrigger;
|
||
/** 注入的技能（追加进 skills 表，SCastSystem 按 CD 轮转）。禁止操作普攻首键 */
|
||
adds?: PhaseSkillEntry[];
|
||
/** 移除的技能 s_uuid 列表（含 RogueConfig 注入的大招）。禁止操作普攻首键 */
|
||
removes?: number[];
|
||
attr_mod?: PhaseAttrMod;
|
||
}
|
||
|
||
/** 阶段方案：固定 2 个切换点 = 3 阶段，P1 为基线 */
|
||
export interface BossPhasePlan {
|
||
name: string;
|
||
switches: [PhaseSwitchDef, PhaseSwitchDef];
|
||
}
|
||
|
||
/**
|
||
* 阶段方案表（id 段 10000）
|
||
* 示例方案 10001 挂在 6101（兽人首领-双刀dps型）的 phase_ids 上；
|
||
* 大招 s_uuid 引用 RogueConfig.BossUltPools 近战池（6100~6104）保证可达
|
||
*/
|
||
export const BossPhaseSet: Record<number, BossPhasePlan> = {
|
||
10001: {
|
||
name: "狂暴进化",
|
||
switches: [
|
||
{ trigger: { hp_pct: 70 }, adds: [{ s_uuid: 6102, overrides: { ap: 180 } }], removes: [6100] },
|
||
{ trigger: { hp_pct: 40, time: 60 }, adds: [{ s_uuid: 6103, overrides: { ap: 180 } }], attr_mod: { ap_pct: 20 } },
|
||
],
|
||
},
|
||
};
|
||
|
||
/**
|
||
* 校验阶段方案表合法性（供 validateRogueConfig 追加调用，建议启动期执行一次）
|
||
* @returns 错误信息数组，空数组表示校验通过
|
||
*/
|
||
export function validateBossPhaseSet(): string[] {
|
||
const errors: string[] = [];
|
||
|
||
for (const key in BossPhaseSet) {
|
||
const plan = BossPhaseSet[key];
|
||
const tag = `BossPhaseSet[${key}](${plan.name})`;
|
||
|
||
if (plan.switches.length !== 2) {
|
||
errors.push(`${tag} 切换点必须恰为 2 个（固定 3 阶段），实际 ${plan.switches.length}`);
|
||
continue;
|
||
}
|
||
|
||
let seenTimeOnly = false;
|
||
let lastHpPct = 101;
|
||
let lastTime = 0;
|
||
|
||
plan.switches.forEach((def, i) => {
|
||
const t = def.trigger;
|
||
const stag = `${tag} switches[${i}]`;
|
||
|
||
// 条件完备性与取值范围
|
||
if (t.hp_pct === undefined && t.time === undefined) {
|
||
errors.push(`${stag} trigger 至少需要 hp_pct 或 time 之一`);
|
||
return;
|
||
}
|
||
if (t.hp_pct !== undefined && (t.hp_pct <= 0 || t.hp_pct >= 100)) {
|
||
errors.push(`${stag} hp_pct 必须在 (0,100) 区间，实际 ${t.hp_pct}`);
|
||
}
|
||
if (t.time !== undefined && t.time <= 0) {
|
||
errors.push(`${stag} time 必须 > 0，实际 ${t.time}`);
|
||
}
|
||
|
||
// hp_pct 前缀规则：time-only 点之后禁止再配 hp_pct（防"P2 time / P3 hp_pct"乱序连切）
|
||
if (seenTimeOnly && t.hp_pct !== undefined) {
|
||
errors.push(`${stag} hp_pct 切换点必须构成前缀：time-only 切换点之后禁止再配置 hp_pct`);
|
||
}
|
||
if (t.hp_pct === undefined && t.time !== undefined) {
|
||
seenTimeOnly = true;
|
||
}
|
||
|
||
// hp_pct 严格递减 / time 严格递增
|
||
if (t.hp_pct !== undefined) {
|
||
if (t.hp_pct >= lastHpPct) {
|
||
errors.push(`${stag} hp_pct=${t.hp_pct} 未严格小于前一档 ${lastHpPct}`);
|
||
}
|
||
lastHpPct = t.hp_pct;
|
||
}
|
||
if (t.time !== undefined) {
|
||
if (t.time <= lastTime) {
|
||
errors.push(`${stag} time=${t.time} 未严格大于前一档 ${lastTime}`);
|
||
}
|
||
lastTime = t.time;
|
||
}
|
||
|
||
// 技能引用存在性（error 级）
|
||
for (const add of def.adds ?? []) {
|
||
if (!add.s_uuid || !SkillSet[add.s_uuid]) {
|
||
errors.push(`${stag} adds 技能 ${add.s_uuid} 未在 SkillSet 中定义`);
|
||
}
|
||
}
|
||
for (const s_uuid of def.removes ?? []) {
|
||
if (!SkillSet[s_uuid]) {
|
||
errors.push(`${stag} removes 技能 ${s_uuid} 未在 SkillSet 中定义`);
|
||
}
|
||
}
|
||
});
|
||
}
|
||
|
||
return errors;
|
||
}
|