用途:本技能是 MSW 2D 战斗系统的集成指南,只覆盖有 MSW 原生 API 支持的常见战斗层内容,不限游戏类型,不涉及公式与理论。API 签名基于 Environment/NativeScripts 下的 .d.mlua 文件。
主要能力:攻击判定用 AttackComponent 与 HitComponent,形状仅支持 Box/Circle/Polygon,可用 Attack、AttackFast、AttackFrom 触发;攻击方 IsAttackTarget 与防守方 IsHitTarget 可做阵营/距离/无敌过滤;cg 参数对防守方 HitComponent.CollisionGroup 做精确匹配。伤害模型通过 CalcDamage、CalcCritical、GetCriticalDamageRate、GetDisplayHitCount 等钩子与 HitEvent.Extra 扩展。受击反应含按身体类型的击退 API 与基于 IsHitTarget 的无敌帧。手感层原生提供顿帧、镜头震动、缩放、闪白、特效与音效。战斗状态用 StateComponent 配合 DeadEvent/ReviveEvent、PlayerComponent。事件总线含 HitEvent、AttackEvent、StateChangeEvent 等。AI 侧有 StateComponent 状态机、AIComponent 行为树与追踪/游荡组件。还包含伤害皮肤、命中特效与 Avatar 动作映射。参考文件涉及怪物组装、血条、投射物与行为树。
必要用法:碰撞判定不要手写逐帧距离;连续移动用每帧 OnUpdate(delta) 配合 MovementComponent:MoveToDirection 或 TransformComponent:Translate,禁止用定时器以小间隔移动,也禁止在 OnUpdate 中用 SetPosition 做连续移动。覆盖钩子时不要加 @ExecSpace 注解,否则运行时报 LEA-3014。
限制:穿透、最大命中数、元素相性、状态效果等需自行实现;FeedbackAction 枚举整体已废弃;模型 JSON 与完整脚本见 references,暂未提供更多细节。