joywayer
5cc93483d3
倍率归 HurtBox 自己（弱点部位就是一个倍率 > 1 的 HurtBox）， 取代 WeakPointSystem 那份写进私有字段却零调用者的倍率—— 其注释称由 BossStats 调用，而项目里根本没有 BossStats 类型。 倍率 1 时数值原样返回而非"乘完再钳最低 1"：本改动先于任何消费者落地， 若默认路径引入钳制会静默改变游戏里每一次伤害计算。 测试用 ApplyDamageMultiplier(0)==0 守住这条——10 在两种实现下都得 10， 只有 0 能把二者区分开。变异验证：去掉该捷径后恰好该断言变红。
184 lines
8.9 KiB
C#
184 lines
8.9 KiB
C#
using UnityEngine;
|
||
using BaseGames.Parry;
|
||
|
||
namespace BaseGames.Combat
|
||
{
|
||
/// <summary>
|
||
/// 受击盒组件。实现完整 9 步伤害流水线（架构 06_CombatModule §5）。
|
||
/// 挂载在角色根节点或指定子节点上，Collider2D 需设 IsTrigger = true，
|
||
/// Layer = PlayerHurtBox 或 EnemyHurtBox。
|
||
/// </summary>
|
||
[RequireComponent(typeof(Collider2D))]
|
||
public class HurtBox : MonoBehaviour
|
||
{
|
||
// ── 伤害接受方（Awake 注入）──────────────────────────────────────────
|
||
private IDamageable _owner;
|
||
private IShieldable _shieldable; // 由 PlayerController.Awake() 注入
|
||
private ParrySystem _parrySystem; // 由 PlayerController.Awake() 注入
|
||
private IPoiseSource _poiseSource; // 由 EnemyBase.Awake() 注入
|
||
private IStatusEffectable _statusEffectable; // Awake 缓存，避免每次受击调用 GetComponent
|
||
|
||
private bool _isHurtBoxInvincible;
|
||
private bool _isActive = true;
|
||
// 所有者级去重保护：防止同一角色的多个 HurtBox 子节点在同一次 HitBox 激活中被重复伤害
|
||
private HurtBoxOwnerGuard _ownerGuard;
|
||
|
||
// ── 事件频道 ──────────────────────────────────────────────────────────
|
||
[SerializeField] private DamageInfoEventChannelSO _onDamageDealt;
|
||
[SerializeField] private HitConfirmedEventChannelSO _onHitConfirmed;
|
||
|
||
// ── 注入接口 ──────────────────────────────────────────────────────────
|
||
public void SetShieldable(IShieldable shieldable) => _shieldable = shieldable;
|
||
public void SetParrySystem(ParrySystem ps) => _parrySystem = ps;
|
||
public void SetPoiseSource(IPoiseSource src) => _poiseSource = src;
|
||
public void SetInvincible(bool value) => _isHurtBoxInvincible = value;
|
||
public void SetActive(bool value) => _isActive = value;
|
||
|
||
// 本 HurtBox 专属的受击倍率（弱点部位 > 1；默认 1 = 无影响）。
|
||
// 由能力在弱点窗口期间开关，语义与"这个部位更脆弱"一致。
|
||
private float _damageMultiplier = 1f;
|
||
|
||
/// <summary>本 HurtBox 当前的受击伤害倍率。</summary>
|
||
public float DamageMultiplier => _damageMultiplier;
|
||
|
||
/// <summary>设置受击倍率（弱点窗口开合时调用）。负值钳到 0。</summary>
|
||
public void SetDamageMultiplier(float value)
|
||
=> _damageMultiplier = UnityEngine.Mathf.Max(0f, value);
|
||
|
||
/// <summary>
|
||
/// 按本 HurtBox 的倍率缩放伤害。最低 1 点，与防御减免同规则
|
||
/// （倍率为 0 也不该让攻击完全无效——那属于无敌帧的语义，不是弱点倍率的）。
|
||
/// 倍率为 1 时原样返回，保证默认状态下伤害数值与未引入倍率前完全一致。
|
||
/// </summary>
|
||
public int ApplyDamageMultiplier(int raw)
|
||
=> _damageMultiplier == 1f
|
||
? raw
|
||
: UnityEngine.Mathf.Max(1, UnityEngine.Mathf.RoundToInt(raw * _damageMultiplier));
|
||
|
||
#if UNITY_EDITOR
|
||
// 付给编辑器的只读属性——避免反射并限制编辑器与运行时字段名耐合性。
|
||
public object EditorOwner => _owner;
|
||
public object EditorShieldable => _shieldable;
|
||
public object EditorParrySystem => _parrySystem;
|
||
public object EditorPoiseSource => _poiseSource;
|
||
public object EditorStatusEffectable => _statusEffectable;
|
||
#endif
|
||
private void Awake()
|
||
{
|
||
_owner = GetComponentInParent<IDamageable>();
|
||
_statusEffectable = GetComponentInParent<IStatusEffectable>();
|
||
if (_owner == null)
|
||
Debug.LogWarning($"[HurtBox] {name}: 父节点中未找到 IDamageable 实现。", this);
|
||
// 在角色根节点查找或自动创建 HurtBoxOwnerGuard（多 HurtBox 共享所有者时只有一个 Guard）
|
||
_ownerGuard = transform.root.GetComponent<HurtBoxOwnerGuard>();
|
||
if (_ownerGuard == null && _owner != null)
|
||
_ownerGuard = transform.root.gameObject.AddComponent<HurtBoxOwnerGuard>();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 接受伤害（由 HitBox.OnTriggerEnter2D 直接调用）。
|
||
/// <param name="hitPoint">弹击点世界坐标；不传则默认使用 HurtBox 节点中心。</param>
|
||
/// ⚠️ 方法名必须为 ReceiveDamage。
|
||
/// </summary>
|
||
public void ReceiveDamage(DamageInfo info, Vector3? hitPoint = null)
|
||
{
|
||
Vector3 resolvedHitPoint = hitPoint ?? transform.position;
|
||
// 兜底盖戳：直接调用本方法的路径（陷阱/环境伤害）没有 HitBox 写入的精确接触点，
|
||
// 统一以解析后的命中点填充，保证下游"击中位置"模式反馈始终有效
|
||
info.HitPoint = resolvedHitPoint;
|
||
if (!_isActive || _owner == null) return;
|
||
// 所有者级去重：同一 HitBox 激活期内多个 HurtBox 子节点只处理首次命中（共享 HP）
|
||
if (_ownerGuard != null && !_ownerGuard.TryRegisterHit(info.HitActivationId)) return;
|
||
|
||
// 1. 无敌帧检查
|
||
if ((_owner.IsInvincible || _isHurtBoxInvincible)
|
||
&& !info.Flags.HasFlag(DamageFlags.IgnoreIFrame)) return;
|
||
|
||
// 2. 弹反检查（_parrySystem == null 时跳过）
|
||
// ParrySystem 只暴露窗口状态，伤害数据留在 Combat 层，无跨程序集数据依赖。
|
||
if (_parrySystem != null && info.Flags.HasFlag(DamageFlags.CanBeParried))
|
||
{
|
||
if (_parrySystem.ConsumeParry())
|
||
{
|
||
// 若攻击来源是投射物，按弹反者阵营反射：
|
||
// 玩家弹反翻转阵营 Layer 与伤害目标层；敌人弹反仅反转方向
|
||
info.SourceProjectile?.ReflectBy(transform);
|
||
return;
|
||
}
|
||
}
|
||
|
||
// 3. 霸体检查（_poiseSource == null 时跳过）
|
||
if (!info.Flags.HasFlag(DamageFlags.ForceBreak) && _poiseSource != null)
|
||
{
|
||
PoiseLevel curPoise = _poiseSource.GetCurrentPoiseLevel();
|
||
if (curPoise == PoiseLevel.Unbreakable) return;
|
||
if ((int)info.Break < (int)curPoise)
|
||
{
|
||
_onHitConfirmed?.Raise(new HitInfo
|
||
{
|
||
DamageInfo = info,
|
||
HitPoint = resolvedHitPoint,
|
||
});
|
||
return;
|
||
}
|
||
}
|
||
|
||
// 4. 护盾层拦截（玩家专属，在防御减免前）
|
||
if (_shieldable != null && _shieldable.HasShield)
|
||
{
|
||
int passThrough = _shieldable.AbsorbDamage(info.Amount);
|
||
if (passThrough <= 0) return;
|
||
info.Amount = passThrough;
|
||
}
|
||
|
||
// 5. 本 HurtBox 受击倍率（弱点部位；默认 1 时无影响）
|
||
info.Amount = ApplyDamageMultiplier(info.Amount);
|
||
|
||
// 6. 计算 FinalDamage（防御减免，最低 1）
|
||
int finalDamage = UnityEngine.Mathf.Max(1, info.Amount - _owner.Defense);
|
||
info.Amount = finalDamage;
|
||
info.FinalDamage = finalDamage;
|
||
|
||
// 7. 调用 _owner.TakeDamage
|
||
_owner.TakeDamage(info);
|
||
|
||
// 8. 全局广播
|
||
_onDamageDealt?.Raise(info);
|
||
_onHitConfirmed?.Raise(new HitInfo
|
||
{
|
||
DamageInfo = info,
|
||
HitPoint = resolvedHitPoint,
|
||
});
|
||
|
||
// 9. 状态效果触发（DoT — Fire / Poison）
|
||
// _statusEffectable 已在 Awake 中缓存，无需每次受击调用 GetComponent
|
||
_statusEffectable?.ApplyStatusEffect(info.Type);
|
||
}
|
||
|
||
#if UNITY_EDITOR
|
||
private void OnDrawGizmos()
|
||
{
|
||
var col = GetComponent<Collider2D>();
|
||
if (col == null) return;
|
||
Color fill, outline;
|
||
if (!_isActive)
|
||
{
|
||
fill = new Color(0f, 0.85f, 1f, 0.05f);
|
||
outline = new Color(0f, 0.85f, 1f, 0.20f);
|
||
}
|
||
else if (_isHurtBoxInvincible)
|
||
{
|
||
fill = new Color(1f, 1f, 0f, 0.25f);
|
||
outline = new Color(1f, 1f, 0f, 0.90f);
|
||
}
|
||
else
|
||
{
|
||
fill = new Color(0f, 0.85f, 1f, 0.20f);
|
||
outline = new Color(0f, 0.85f, 1f, 0.90f);
|
||
}
|
||
HitBox.DrawCollider2DFilled(col, fill, outline);
|
||
}
|
||
#endif
|
||
}
|
||
}
|