TurnBased 通用回合流程

这一页说明 GFTurnFlowSystem 如何推进阶段、收集行动并按优先级解析。具体参与者、目标规则和行动效果由项目层定义。

通用回合流程 (GFTurnFlowSystem)

GFTurnFlowSystem 提供阶段推进、行动入队和优先级解析。它适合承载“先收集行动，再按排序规则解析”的通用流程，但不定义参与者字段、目标规则或行动效果。

class_name ResolvePhase
extends GFTurnPhase


func execute(context: GFTurnContext) -> Variant:
    var flow := Gf.get_system(GFTurnFlowSystem) as GFTurnFlowSystem
    flow.resolve_actions()
    return null

var flow := GFTurnFlowSystem.new()
flow.set_phases([
    ResolvePhase.new(),
])

flow.start()
flow.enqueue_action(GFTurnAction.new(actor_a, [target_b], { "value": 10 }, 1, 20.0))
flow.advance_phase()

默认排序规则是 priority 降序，然后 sort_value 降序。需要项目自定义排序时，可向 resolve_actions(order_resolver) 传入比较回调。阶段和行动如果返回 Signal，系统会通过 signal_timeout_seconds 和当前流程 serial 做安全等待；stop() 或超时后不会继续调用旧阶段的 exit()，也不会把旧行动标记为 resolved。resolve_actions() 在上一批行动仍等待时会拒绝重入，避免同一批行动被重复解析。