pan/heros

Files

panw b38e63e200 refactor(skill): 重构技能组件目录结构并重命名施法请求组件

将技能相关组件从hero目录移动到skill目录
将CastSkillRequestComp重命名为CSRequestComp
更新相关引用和文档说明

2025-10-31 09:22:50 +08:00

17 KiB

Raw Blame History

英雄系统

**本文档中引用的文件** - [HeroAttrs.ts](file://assets/script/game/common/config/HeroAttrs.ts) - [SkillSet.ts](file://assets/script/game/common/config/SkillSet.ts) - [TalSet.ts](file://assets/script/game/common/config/TalSet.ts) - [Hero.ts](file://assets/script/game/hero/Hero.ts) - [HeroViewComp.ts](file://assets/script/game/hero/HeroViewComp.ts) - [HSkillSystem.ts](file://assets/script/game/hero/HSkillSystem.ts) - [BuffComp.ts](file://assets/script/game/hero/BuffComp.ts) - [TalComp.ts](file://assets/script/game/hero/TalComp.ts) - [heroSet.ts](file://assets/script/game/common/config/heroSet.ts) - [HeroAttrsComp.ts](file://assets/script/game/hero/HeroAttrsComp.ts) - [HeroAtk.ts](file://assets/script/game/hero/HeroAtk.ts) - [EBusComp.ts](file://assets/script/game/hero/EBusComp.ts)

更新摘要

变更内容

移除了 SkillConComp 组件，重构为基于ECS系统的技能控制机制
将 is_atking 攻击状态从视图层 HeroViewComp 迁移到数据层 HeroAttrsComp
拆分通用移动组件为专属的英雄和怪物移动系统
在攻击和死亡事件中集成视觉反馈
根据ECS框架重构角色视图和数据逻辑，新增事件总线组件 EBusComp

新增章节

ECS架构下的技能系统
攻击与死亡事件的视觉反馈

已移除章节

原有的 SkillConComp 技能控制组件相关内容

来源追踪系统更新

更新了受影响文件的引用链接和行号范围
添加了新组件和系统的文件引用
标记了已移除组件的废弃状态

简介

英雄系统是游戏的核心战斗机制，负责管理英雄的属性、技能、天赋和状态。本系统采用模块化设计，通过ECS架构实现组件间的松耦合通信，支持复杂的战斗逻辑和动态效果管理。近期重构移除了 SkillConComp 组件，将技能控制逻辑迁移至基于ECS系统的 HSkillSystem，同时将攻击状态从视图层迁移至数据层，实现了更合理的数据与表现分离。

系统架构概览

英雄系统采用分层架构设计，主要包含以下核心层次：

graph TB
subgraph "表现层"
HV[HeroViewComp<br/>英雄视图组件]
BC[BuffComp<br/>状态显示组件]
end
subgraph "控制层"
HC[Hero<br/>英雄实体]
SS[HSkillSystem<br/>技能系统]
TC[TalComp<br/>天赋控制组件]
end
subgraph "配置层"
HA[HeroAttrs<br/>属性配置]
SSC[SkillSet<br/>技能配置]
TS[TalSet<br/>天赋配置]
end
subgraph "数据层"
HAC[HeroAttrsComp<br/>属性数据组件]
HM[HeroModelComp<br/>模型数据]
MM[MonModelComp<br/>怪物数据]
end
HC --> HV
HC --> HAC
SS --> HV
TC --> HV
HV --> BC
HV --> HA
SS --> SSC
TC --> TS
HV --> MM

图表来源

英雄属性系统

属性枚举与分类

英雄属性系统定义了完整的战斗属性体系，按照功能分为多个类别：

classDiagram
class Attrs {
<<enumeration>>
+HP_MAX : 0
+MP_MAX : 1
+SHIELD_MAX : 2
+HP_REGEN : 3
+MP_REGEN : 4
+AP : 10
+MAP : 11
+DEF : 20
+MDEF : 21
+CRITICAL : 30
+CRITICAL_DMG : 31
+SPEED : 63
+EXP_GAIN : 64
+STRENGTH : 90
+INTELLIGENCE : 91
+AGILITY : 92
+SPIRIT : 93
+LUCK : 94
}
class BType {
<<enumeration>>
+VALUE : 0
+RATIO : 1
}
class HeroAttrs {
+getAttrs() Object
+isRatioAttr(attrType) boolean
+calculateAttributeGains() Object
+addStrength() Object
+addIntelligence() Object
+addAgility() Object
+addSpirit() Object
+addLuck() Object
}
HeroAttrs --> Attrs
HeroAttrs --> BType

图表来源

HeroAttrs.ts

属性类型配置

系统通过 AttrsType 配置表区分属性的计算方式：

属性类型	计算方式	示例属性
数值型	直接相加	HP_MAX, AP, DEF
百分比型	基础值×(1+百分比/100)	CRITICAL, SPEED, BUFF_UP

职业属性成长系统

不同职业具有独特的属性成长曲线：

flowchart TD
A[基础属性输入] --> B{职业类型}
B --> |战士| C[力量→HP_MAX:3, AP:1.5, DEF:0.8]
B --> |远程| D[敏捷→CRITICAL:0.8, DODGE:0.6, AS:0.5]
B --> |法师| E[智力→MP_MAX:2, MAP:1.8, MDEF:0.8]
B --> |辅助| F[精神→MP_MAX:2, CON_RES:0.5, BUFF_UP:0.6]
B --> |刺客| G[敏捷→CRITICAL:1, DODGE:0.8, AS:0.6]
C --> H[属性增长计算]
D --> H
E --> H
F --> H
G --> H
H --> I[最终属性值]

图表来源

HeroAttrs.ts

章节来源

HeroAttrs.ts

技能系统

技能配置结构

技能系统提供了完整的技能数据定义框架：

classDiagram
class SkillConfig {
+uuid : number
+name : string
+TGroup : TGroup
+SType : SType
+DTType : DTType
+DType : DType
+ap : number
+cd : number
+cost : number
+speed : number
+buffs : BuffConf[]
+neAttrs : NeAttrsConf[]
+info : string
}
class TGroup {
<<enumeration>>
+Self : 0
+Ally : 1
+Team : 2
+Enemy : 3
+All : 4
}
class SType {
<<enumeration>>
+damage : 0
+heal : 1
+shield : 2
+buff : 11
}
class BuffConf {
+buff : Attrs
+BType : BType
+value : number
+time : number
+chance : number
}
SkillConfig --> TGroup
SkillConfig --> SType
SkillConfig --> BuffConf

图表来源

SkillSet.ts

ECS架构下的技能系统

技能系统已重构为基于ECS的系统架构，主要包含以下组件：

classDiagram
class CSRequestComp {
+skillIndex : number
+targetPositions : Vec3[]
+reset() void
}
class SkillCastSystem {
+filter() IMatcher
+entityEnter(e : Entity) void
+checkCastConditions() boolean
+executeCast() void
+createSkillEntity() void
}
class SkillCDSystem {
+filter() IMatcher
+update(e : Entity) void
+updateCDs(dt : number) void
}
class SkillAutocastSystem {
+filter() IMatcher
+update(e : Entity) void
+selectTargets() Vec3[]
}
CSRequestComp --> SkillCastSystem
SkillCastSystem --> SkillCDSystem
SkillAutocastSystem --> CSRequestComp

章节来源

HSkillSystem.ts

技能施法流程

技能施法遵循ECS标记组件驱动的时序控制：

sequenceDiagram
participant Player as 玩家输入
participant SC as SkillAutocastSystem
participant HV as HeroViewComp
participant SE as SkillEnt
participant Target as 目标实体
Player->>SC : 添加CastSkillRequest
SC->>SC : 检查英雄状态
SC->>HV : 选择目标
HV-->>SC : 返回目标坐标
SC->>HV : 播放技能特效
SC->>SE : 创建技能实体
SE->>Target : 执行伤害/效果
Target-->>SE : 反馈结果
SE-->>HV : 更新状态

图表来源

HSkillSystem.ts

目标选择算法

系统实现了智能的目标选择机制：

flowchart TD
A[开始目标选择] --> B[获取敌方实体列表]
B --> C{是否有目标?}
C --> |否| D[返回默认位置]
C --> |是| E[确定最前排目标]
E --> F[添加最前排为目标]
F --> G[随机选择剩余目标]
G --> H[返回目标坐标数组]
D --> I[结束]
H --> I

图表来源

HSkillSystem.ts

章节来源

天赋系统

天赋类型与触发机制

天赋系统支持多种触发条件和效果类型：

classDiagram
class TalType {
<<enumeration>>
+LEVEL : 1
+LEVEL_UP : 2
+ACTION_COUNT : 3
+SKILL_COUNT : 4
+DAMAGE_COUNT : 5
+INIT : 6
+DEAD : 7
}
class TalEType {
<<enumeration>>
+ATTRS : 1
+SKILL : 2
+SKILL_MORE : 3
}
class ItalConf {
+uuid : number
+name : string
+desc : string
+type : TalType
+triggerType : TalEType
+chance : number
+t_value : number
+e_value : number
+e_name : number
+e_type : BType
+e_scaling : number
+e_count : number
+stackable : boolean
+maxStack : number
}
class FightStats {
+aCount : number
+sCount : number
+dCount : number
+level : number
}
ItalConf --> TalType
ItalConf --> TalEType
TalComp --> FightStats

图表来源

天赋触发流程

flowchart TD
A[事件发生] --> B{事件类型}
B --> |等级提升| C[更新FStats.level]
B --> |普通攻击| D[更新aCount]
B --> |技能使用| E[更新sCount]
B --> |受到伤害| F[更新dCount]
C --> G[检查LEVEL天赋]
D --> H[检查ACTION_COUNT天赋]
E --> I[检查SKILL_COUNT天赋]
F --> J[检查DAMAGE_COUNT天赋]
G --> K{满足触发条件?}
H --> K
I --> K
J --> K
K --> |是| L[执行天赋效果]
K --> |否| M[等待下次检查]
L --> N[应用属性增益]
L --> O[触发技能]
L --> P[增加技能数量]
N --> Q[重新计算属性]
O --> R[技能释放]
P --> S[技能列表更新]

图表来源

TalComp.ts

章节来源

状态管理系统

Buff/Debuff系统架构

状态管理系统实现了完整的增益/减益效果管理：

classDiagram
class HeroAttrsComp {
+BUFFS : Record~number, Array~
+BUFFS_TEMP : Record~number, Array~
+NeAttrs : Record~number, Object~
+addBuff(buffConf) void
+removeBuff(attrIndex, value, isPermanent) void
+clearBuffs(attrIndex, isBuff) void
+recalculateSingleAttr(attrIndex) void
+updateTemporaryBuffsDebuffs(dt) void
}
class BuffInfo {
+attr : Attrs
+value : number
+remainTime : number
}
class NeAttrs {
+IN_FROST : 0
+IN_STUN : 1
+IN_BURN : 2
+IN_POISON : 3
}
HeroAttrsComp --> BuffInfo
HeroAttrsComp --> NeAttrs

图表来源

HeroAttrsComp.ts

属性计算公式

系统采用复合计算公式处理不同类型的属性：

属性类型	计算公式	说明
数值型	`(基础值 + 所有数值型buff之和) × (1 + 所有百分比buff之和/100)`	攻击力、防御力等
百分比型	`基础值 + 所有数值型buff之和 + 所有百分比buff之和`	暴击率、闪避率等

状态更新机制

sequenceDiagram
participant Game as 游戏循环
participant HAC as HeroAttrsComp
participant Buff as Buff系统
participant Attr as 属性计算
Game->>HAC : update(dt)
HAC->>Buff : updateTemporaryBuffsDebuffs(dt)
Buff->>Buff : 减少剩余时间
Buff->>Buff : 移除过期buff
Buff->>Attr : recalculateSingleAttr()
Attr->>Attr : 重新计算属性值
Attr-->>HAC : 更新后的属性
HAC->>HAC : clampSingleAttr()
HAC-->>Game : 状态更新完成

图表来源

HeroAttrsComp.ts

章节来源

组件间通信机制

ECS架构下的组件交互

graph LR
subgraph "英雄实体"
E[Hero实体]
HV[HeroViewComp]
HAC[HeroAttrsComp]
BM[HeroMoveComp]
end
subgraph "技能系统"
SS[HSkillSystem]
SE[SkillEnt]
end
subgraph "状态系统"
BC[BuffComp]
TC[TalComp]
end
E --> HV
E --> HAC
E --> BM
HAC --> SS
SS --> SE
HV --> BC
HV --> TC
TC --> HV
SS --> HV

图表来源

事件驱动通信

系统通过事件机制实现组件间的解耦通信：

事件类型	发送者	接收者	用途
GameEvent.MasterCalled	Hero	Talent系统	英雄召唤事件
GameEvent.CastHeroSkill	HSkillSystem	其他组件	技能释放通知
GameEvent.FightEnd	Battle	所有组件	战斗结束事件
GameEvent.HeroDead	HeroView	Talent系统	英雄死亡事件

章节来源

关键功能实现

技能释放流程

技能释放是英雄系统的核心功能，涉及多个组件的协调工作：

flowchart TD
A[玩家输入技能] --> B[HSkillSystem接收]
B --> C{英雄状态检查}
C --> |眩晕/冰冻| D[阻止技能释放]
C --> |正常状态| E[检查冷却时间]
E --> |冷却完成| F[检查魔法值]
F --> |魔法值充足| G[选择目标]
F --> |魔法值不足| H[显示提示]
G --> I[播放技能特效]
I --> J[创建技能实体]
J --> K[执行伤害计算]
K --> L[应用Buff效果]
L --> M[更新英雄状态]
D --> N[技能释放失败]
H --> N
M --> O[技能释放成功]

图表来源

HSkillSystem.ts

属性升级系统

属性升级通过职业成长配置实现：

flowchart TD
A[属性点分配] --> B{职业类型}
B --> |力量| C[addStrength函数]
B --> |智力| D[addIntelligence函数]
B --> |敏捷| E[addAgility函数]
B --> |精神| F[addSpirit函数]
B --> |幸运| G[addLuck函数]
C --> H[计算力量成长]
D --> I[计算智力成长]
E --> J[计算敏捷成长]
F --> K[计算精神成长]
G --> L[计算幸运成长]
H --> M[应用到属性]
I --> M
J --> M
K --> M
L --> M
M --> N[重新计算所有属性]
N --> O[更新显示]

图表来源

HeroAttrs.ts

天赋触发机制

天赋系统实现了复杂的触发逻辑：

flowchart TD
A[事件触发] --> B[更新统计数据]
B --> C[遍历天赋配置]
C --> D{检查触发条件}
D --> |满足| E[计算触发概率]
D --> |不满足| F[跳过此天赋]
E --> |触发| G[执行天赋效果]
E --> |不触发| F
G --> H{效果类型}
H --> |属性增益| I[添加Buff]
H --> |技能触发| J[释放技能]
H --> |技能增加| K[增加技能列表]
I --> L[重新计算属性]
J --> M[技能执行]
K --> N[技能可用]
L --> O[更新界面]
M --> O
N --> O
F --> P[检查下一个天赋]
P --> C

图表来源

TalComp.ts

章节来源

攻击与死亡事件的视觉反馈

攻击和死亡事件现在集成视觉反馈，增强游戏表现力：

sequenceDiagram
participant Attack as 攻击事件
participant HAC as HeroAttrsComp
participant HV as HeroViewComp
participant AtkSys as HeroAtkSystem
Attack->>HAC : 发起攻击
HAC->>AtkSys : doAttack()
AtkSys->>HV : do_atked()
HV->>HV : 显示伤害数字
HV->>HV : 播放受击动画
HV->>HV : 角色后退
Attack->>HAC : 造成伤害
HAC->>HAC : 更新血量
HAC->>HV : 检查死亡
HV->>HV : do_dead()
HV->>HV : 播放死亡特效
HV->>HV : 触发死亡事件

章节来源

性能优化考虑

内存管理优化

对象池化: 技能实体和伤害数字使用对象池减少GC压力
延迟加载: 天赋效果按需计算，避免不必要的属性重计算
弱引用: 避免组件间的强引用导致内存泄漏

计算优化

增量计算: 只重新计算受影响的属性，而不是全部属性
缓存机制: 缓存属性计算结果，避免重复计算
批量更新: 在同一帧内批量处理多个状态变化

渲染优化

状态显示: BuffComp只更新可见的状态信息
特效管理: 技能特效使用预制体池，避免频繁创建销毁
层级管理: 合理管理UI层级，减少渲染开销

总结

英雄系统通过模块化设计和ECS架构实现了高度可扩展和可维护的战斗机制。系统的主要特点包括：

完整的属性体系: 支持数值型和百分比型属性的灵活组合
智能技能管理: 提供丰富的技能配置选项和自动化的目标选择
动态天赋系统: 支持多种触发条件和效果类型的天赋配置
高效状态管理: 实现了完整的Buff/Debuff生命周期管理
松耦合架构: 通过ECS和事件机制实现组件间的解耦通信

近期重构将技能控制逻辑迁移至ECS系统，移除了 SkillConComp 组件，同时将攻击状态从视图层迁移至数据层，实现了更合理的数据与表现分离。该系统为游戏提供了坚实的战斗基础，支持复杂的游戏玩法和深度的角色养成体验。通过合理的架构设计和性能优化，确保了系统的稳定性和可扩展性。

17 KiB Raw Blame History Unescape Escape

英雄系统

更新摘要

目录

简介

系统架构概览

英雄属性系统

属性枚举与分类

属性类型配置

职业属性成长系统

技能系统

技能配置结构

ECS架构下的技能系统

技能施法流程

目标选择算法

天赋系统

天赋类型与触发机制

天赋触发流程

状态管理系统

Buff/Debuff系统架构

属性计算公式

状态更新机制

组件间通信机制

ECS架构下的组件交互

事件驱动通信

关键功能实现

技能释放流程

属性升级系统

天赋触发机制

攻击与死亡事件的视觉反馈

性能优化考虑

内存管理优化

计算优化

渲染优化

总结

17 KiB

Raw Blame History