Files
vampire-like/Assets/GameMain/Scripts/Runtime/Battle/AttributePipeline.cs
T

249 lines
7.8 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System;
using System.Collections.Generic;
using SepCore.Definition;
namespace SepCore.Battle
{
/// <summary>
/// 多维属性修饰器管线(Attribute Pipeline)。
/// 管理角色所有属性维度,提供三段修饰求值、脏标记缓存与按 Source 批量移除机制。
/// 纯 C# 类,无 MonoBehaviour 依赖。
/// </summary>
public sealed class AttributePipeline : IAttributeProvider
{
private readonly Dictionary<StatType, CharacterStat> _stats = new();
private int _batchDepth;
private readonly HashSet<StatType> _batchedChangedStats = new();
/// <summary>
/// 当某个属性的值发生变动(添加/移除修饰器、修改基础值)时触发。
/// 参数:(StatType 属性类型, float 新的当前值)。
/// </summary>
public event Action<StatType, float> OnStatChanged;
/// <summary>
/// 开启批量修饰器更新作用域。在作用域内添加/移除修饰器不会立即触发 OnStatChanged,
/// 而是在作用域 Dispose 时对所有发生变更的属性统一触发一次最终值的 OnStatChanged。
/// </summary>
public BatchScope BeginBatchUpdate()
{
_batchDepth++;
return new BatchScope(this);
}
public void EndBatchUpdate()
{
if (_batchDepth <= 0)
{
return;
}
_batchDepth--;
if (_batchDepth == 0 && _batchedChangedStats.Count > 0)
{
StatType[] changed = new StatType[_batchedChangedStats.Count];
_batchedChangedStats.CopyTo(changed);
_batchedChangedStats.Clear();
for (int i = 0; i < changed.Length; i++)
{
StatType statType = changed[i];
OnStatChanged?.Invoke(statType, GetValue(statType));
}
}
}
private void NotifyStatChanged(StatType statType, float newValue)
{
if (_batchDepth > 0)
{
_batchedChangedStats.Add(statType);
}
else
{
OnStatChanged?.Invoke(statType, newValue);
}
}
public readonly struct BatchScope : IDisposable
{
private readonly AttributePipeline _pipeline;
public BatchScope(AttributePipeline pipeline)
{
_pipeline = pipeline;
}
public void Dispose()
{
_pipeline?.EndBatchUpdate();
}
}
public AttributePipeline()
{
// 预初始化已定义的所有 StatType 枚举
Array values = Enum.GetValues(typeof(StatType));
for (int i = 0; i < values.Length; i++)
{
StatType statType = (StatType)values.GetValue(i);
_stats[statType] = new CharacterStat(statType, 0f);
}
}
/// <summary>
/// 获取指定类型的属性容器。
/// </summary>
public CharacterStat Get(StatType statType)
{
if (!_stats.TryGetValue(statType, out CharacterStat stat))
{
stat = new CharacterStat(statType, 0f);
_stats.Add(statType, stat);
}
return stat;
}
/// <summary>
/// 获取指定属性的当前最终计算值(带脏标记缓存与边界钳制)。
/// </summary>
public float GetValue(StatType statType)
{
return Get(statType).Value;
}
/// <summary>
/// 设置指定属性的基础值。
/// </summary>
public void SetBaseValue(StatType statType, float baseValue)
{
CharacterStat stat = Get(statType);
float oldValue = stat.Value;
stat.BaseValue = baseValue;
float newValue = stat.Value;
if (Math.Abs(oldValue - newValue) > 1e-6f)
{
NotifyStatChanged(statType, newValue);
}
}
/// <summary>
/// 添加属性修饰器。
/// </summary>
public void AddModifier(StatType statType, StatModifier modifier)
{
if (modifier == null)
{
throw new ArgumentNullException(nameof(modifier));
}
CharacterStat stat = Get(statType);
stat.AddModifier(modifier);
NotifyStatChanged(statType, stat.Value);
}
/// <summary>
/// 移除属性修饰器。
/// </summary>
public bool RemoveModifier(StatType statType, StatModifier modifier)
{
if (modifier == null)
{
return false;
}
CharacterStat stat = Get(statType);
bool removed = stat.RemoveModifier(modifier);
if (removed)
{
NotifyStatChanged(statType, stat.Value);
}
return removed;
}
/// <summary>
/// 添加 Luban 导出的 modifier(自动转换为 StatModifier)。
/// </summary>
public void AddModifier(StatModifierConfig lubanMod, object source = null)
{
if (lubanMod == null)
{
throw new ArgumentNullException(nameof(lubanMod));
}
StatModifier statMod = StatModifier.FromLuban(lubanMod, source);
AddModifier(lubanMod.StatType, statMod);
}
/// <summary>
/// 移除由 Luban 导出的 modifier 所生成的对应修饰器。
/// </summary>
public bool RemoveModifier(StatModifierConfig lubanMod, object source = null)
{
if (lubanMod == null)
{
return false;
}
CharacterStat stat = Get(lubanMod.StatType);
float targetValue = lubanMod.Value;
ModifierType targetType = lubanMod.ModifierType;
IReadOnlyList<StatModifier> modifiers = stat.Modifiers;
for (int i = modifiers.Count - 1; i >= 0; i--)
{
StatModifier m = modifiers[i];
if (m.Type == targetType &&
Math.Abs(m.Value - targetValue) < 1e-6f &&
(source == null || ReferenceEquals(m.Source, source) || Equals(m.Source, source)))
{
return RemoveModifier(lubanMod.StatType, m);
}
}
return false;
}
/// <summary>
/// 一键移除所有属性中指定来源(道具、武器、羁绊、Buff 等)的所有修饰器。
/// </summary>
/// <param name="source">来源对象引用</param>
/// <returns>移除的修饰器总数</returns>
public int RemoveAllModifiersFromSource(object source)
{
if (source == null)
{
return 0;
}
int totalRemoved = 0;
foreach (KeyValuePair<StatType, CharacterStat> pair in _stats)
{
int removed = pair.Value.RemoveAllModifiersFromSource(source);
if (removed > 0)
{
totalRemoved += removed;
NotifyStatChanged(pair.Key, pair.Value.Value);
}
}
return totalRemoved;
}
/// <summary>
/// 清空所有属性的修饰器并标记为脏。
/// </summary>
public void Clear()
{
foreach (KeyValuePair<StatType, CharacterStat> pair in _stats)
{
pair.Value.ClearModifiers();
NotifyStatChanged(pair.Key, pair.Value.Value);
}
}
}
}