1
public readonly struct GameplayTag : IEquatable<GameplayTag>
2
{
3
    public GameplayTag(string value)
4
    {
5
        if (string.IsNullOrWhiteSpace(value))
6
            throw new ArgumentException("Tag cannot be empty.", nameof(value));
7

8
        Value = value;
9
    }
10

11
    public string Value { get; }
12

13
    public bool Equals(GameplayTag other)
14
    {
15
        return StringComparer.Ordinal.Equals(Value, other.Value);
16
    }
17

18
    public override bool Equals(object obj)
19
    {
20
        return obj is GameplayTag other && Equals(other);
21
    }
22

23
    public override int GetHashCode()
24
    {
25
        return StringComparer.Ordinal.GetHashCode(Value);
26
    }
27

28
    public override string ToString()
29
    {
30
        return Value;
31
    }
32
}

1
public sealed class TagSet
2
{
3
    private readonly Dictionary<GameplayTag, int> counts = new();
4

5
    public bool HasExact(GameplayTag tag)
6
    {
7
        return counts.TryGetValue(tag, out int count) && count > 0;
8
    }
9

10
    public void Add(GameplayTag tag)
11
    {
12
        counts.TryGetValue(tag, out int count);
13
        counts[tag] = checked(count + 1);
14
    }
15

16
    public void Remove(GameplayTag tag)
17
    {
18
        if (!counts.TryGetValue(tag, out int count))
19
            throw new InvalidOperationException($"Tag not owned: {tag}");
20

21
        if (count == 1)
22
            counts.Remove(tag);
23
        else
24
            counts[tag] = count - 1;
25
    }
26
}

1
public enum ModifierOperation
2
{
3
    Additive,
4
    Multiplicative,
5
    Override
6
}
7

8
public readonly struct Modifier
9
{
10
    public Modifier(
11
        AttributeId attribute,
12
        ModifierOperation operation,
13
        double magnitude,
14
        EffectHandle source,
15
        int priority)
16
    {
17
        Attribute = attribute;
18
        Operation = operation;
19
        Magnitude = magnitude;
20
        Source = source;
21
        Priority = priority;
22
    }
23

24
    public AttributeId Attribute { get; }
25
    public ModifierOperation Operation { get; }
26
    public double Magnitude { get; }
27
    public EffectHandle Source { get; }
28
    public int Priority { get; }
29
}

1
Definition:
2
  Id = Effect.Burning
3
  Duration = 5 秒
4
  Period = 1 秒
5
  Granted Tag = Effect.Burning
6
  Tick Resolver = BurningTick
7

8
Spec:
9
  Source = 施法者
10
  Target = 被命中者
11
  CreatedBy = Ability.Fireball
12
  Level / Snapshot / Context = 本次应用上下文
13

14
Instance:
15
  Handle = E1001
16
  StartTime = 20.0
17
  EndTime = 25.0
18
  NextTickTime = 按周期策略确定
19
  State = Active

1
public EffectApplicationResult Apply(
2
    EffectSpec spec,
3
    CombatRuntime target)
4
{
5
    if (!requirements.CanApply(spec, target))
6
        return EffectApplicationResult.Rejected();
7

8
    if (spec.DurationPolicy == EffectDurationPolicy.Instant)
9
        return ApplyInstant(spec, target);
10

11
    EffectInstance instance = CreateInstance(spec, target);
12
    target.Effects.Add(instance);
13
    ApplyOngoingContributions(instance, target);
14
    return EffectApplicationResult.Applied(instance.Handle);
15
}

1
public sealed class EffectInstance
2
{
3
    public EffectHandle Handle { get; init; }
4
    public EffectSpec Spec { get; init; }
5
    public double StartTime { get; init; }
6
    public double EndTime { get; init; }
7
    public double? NextTickTime { get; private set; }
8
    public EffectInstanceState State { get; private set; }
9

10
    public void MarkRemoving()
11
    {
12
        if (State != EffectInstanceState.Active)
13
            return;
14

15
        State = EffectInstanceState.Removing;
16
    }
17

18
    public void MarkRemoved()
19
    {
20
        State = EffectInstanceState.Removed;
21
    }
22
}

1
施法者 Runtime:
2
  Mana = 80
3
  不包含 Cooldown.Fireball
4

5
激活检查:
6
  Mana >= 30
7
  Blocked Tag Query 不命中
8

9
Commit:
10
  应用 Instant Mana Cost Effect
11
    Mana -= 30
12

13
  应用 Duration Cooldown Effect
14
    Duration = 2 秒
15
    Granted Tag = Cooldown.Fireball