avalon-game-battle-engine/io.github.lishangbu.avalon.game.battle.engine.core.runtime.flow/BattleMoveResolutionContext

BattleMoveResolutionContext

class BattleMoveResolutionContext(snapshot: BattleRuntimeSnapshot, val moveEffect: EffectDefinition, val attackerId: String, val targetId: String, val sourceId: String, val attributes: Map<String, Any?>, accuracy: Int?, evasion: Int?, basePower: Int, damage: Int)

单次出招主流程在 pipeline 中共享的可变上下文。

设计意图：

把 move resolution 的中间状态从 DefaultBattleFlowEngine 主体中抽离出来。
让各个 phase step 只修改自己关注的字段，而不需要关心最终结果对象如何组装。

Constructors

BattleMoveResolutionContext

constructor(snapshot: BattleRuntimeSnapshot, moveEffect: EffectDefinition, attackerId: String, targetId: String, sourceId: String, attributes: Map<String, Any?>, accuracy: Int?, evasion: Int?, basePower: Int, damage: Int)

Properties

var accuracy: Int?

当前阶段持有的命中值。

val attackerId: String

出手单位标识。

val attributes: Map<String, Any?>

透传给 hook phase 的附加属性。

var basePower: Int

当前阶段持有的威力值。

var cancelled: Boolean

本次出招是否已经在前置阶段被取消。

var criticalHit: Boolean

本次出招是否击中要害。

var damage: Int

当前阶段持有的伤害值。

var damageRoll: Int?

本次伤害浮动使用的随机倍率。

var evasion: Int?

当前阶段持有的回避值。

forcedHitSuccessful

var forcedHitSuccessful: Boolean?

当前阶段是否已经被特殊规则显式判定为必中/必不中。

var hitSuccessful: Boolean

本次出招是否成功命中。

val moveEffect: EffectDefinition

当前正在结算的 effect 定义。

skipAccuracyEvasionModifiers

var skipAccuracyEvasionModifiers: Boolean

当前阶段是否应跳过常规 accuracy/evasion 修正链。

var snapshot: BattleRuntimeSnapshot

当前阶段持有的最新 battle 快照。

val sourceId: String

本次结算的来源单位标识。

val targetId: String

当前目标单位标识。

Functions

fun markCancelled(nextSnapshot: BattleRuntimeSnapshot)

把当前上下文标记为已取消。

fun toResult(): MoveResolutionResult

把当前上下文收敛为最终的 move resolution 结果。