Buff 与技能示例

Combat 的 Buff、技能和属性修饰器都是通用原语。项目应在自己的技能脚本、AI、输入系统或状态机里决定何时创建、添加、施放和移除它们。

Tick Buff

class_name RegenBuff
extends GFBuff

func on_tick(p_delta: float) -> void:
    # 假设宿主有方法获取 HP 属性。
    var hp := owner.get_attribute(&"HP") as GFModifiedAttribute
    hp.set_base_value(hp.get_base_value() + 5.0 * p_delta)
    hp.force_recalculate()

自动索敌技能

class_name FireBallSkill
extends GFSkill

func _init(p_owner: Object) -> void:
    super._init(p_owner)
    id = &"FireBall"
    cooldown_max = 2.0

    targeting_rule = GFSkillTargetingRule.new()
    targeting_rule.shape = GFSkillTargetingRule.Shape.CIRCLE
    targeting_rule.radius = 300.0
    targeting_rule.max_count = 3
    targeting_rule.sort_rule = GFSkillTargetingRule.SortRule.ATTRIBUTE_LOWEST
    targeting_rule.sort_attribute_name = &"HP"

func _try_execute(p_targets: Array[Object]) -> bool:
    for target in p_targets:
        print("Fireball hits: ", target)
    return true

需要项目自定义成本、状态或上下文检查时，不必把规则写进 GFSkill 子类深处，可以把纯检查和提交拆到激活管线：

var skill := FireBallSkill.new(caster)
skill.activation_checks.append(func(context: GFSkillActivationContext) -> Dictionary:
    return {
        "ok": mana >= 10,
        "reason": &"not_enough_resource",
    }
)
skill.activation_commit_callbacks.append(func(context: GFSkillActivationContext) -> Dictionary:
    mana -= 10
    return { "ok": true }
)

skill.execute(enemy, null, { "input_id": &"primary" })

检查回调应尽量保持无副作用；真正消耗或预留资源放到提交回调中。上下文的 metadata 只作为项目诊断和串联数据，框架不解释其中字段。

属性修饰器

var strength_buff := GFBuff.new()
strength_buff.setup(&"StrBoost", 5.0, entity)
strength_buff.modifiers.append(GFModifier.create_percent_add(0.2, &"STR", &"StrBoost"))
combat_system.add_buff(entity, strength_buff)

attribute_id 表示修饰器要挂到哪一个属性上；source_id 表示它来自哪个装备、Buff 或技能，便于按来源批量移除。2.0 起 Buff 不再把 source_id 当作目标属性回退，也不再提供旧字段名 source_tag。迁移旧代码时，应把目标属性写入 attribute_id，把来源写入 source_id。