游戏客户端架构 / 系统课时
把角色控制拆成多个能力
把角色控制拆成多个能力
角色控制脚本常把按键读取、位移、生命值、攻击和动画堆在同一个更新函数中,改动攻击逻辑也可能破坏移动。本课将它拆成五个职责清晰的组件,用薄协调层串起每帧操作,并通过运行结果验证数据没有越界修改。
学习目标
- 识别输入、移动、生命、攻击、动画各自负责的数据和行为。
- 让动作意图、伤害请求和动画状态沿明确方向传递。
- 运行角色更新示例,检查组件之间是否存在隐藏的双向依赖。
按状态所有权划分能力
拆分组件的依据不是类名有多短,而是谁有权维护一份状态。输入组件不应该知道生命值,动画组件不应该决定伤害,攻击组件也不应该直接修改目标的私有血量。把职责压在稳定的输入输出上,才能单独替换实现。
| 组件 | 输入与职责 | 不应该做的事 |
|---|---|---|
InputComponent |
将原始输入转换为 Intent |
直接移动角色 |
MovementComponent |
根据移动意图更新位置 | 判断攻击命中 |
HealthComponent |
处理伤害并维护 hp |
播放动画 |
AttackComponent |
根据请求和存活状态给出伤害量 | 修改目标生命组件内部字段 |
AnimationComponent |
根据已发生的移动、攻击和存活状态选择动作 | 反向控制战斗数值 |
这里的“组件”表示独立职责单元,不要求每个组件都继承某个引擎基类。真正落地时可以是普通对象、引擎组件或纯数据结构;关键是状态写入权不能模糊。
让协调层负责接线而不是包办业务
角色的 tick 先向输入组件获取意图,再让移动和攻击组件完成各自计算。攻击只返回伤害量,协调层通过目标公开的 receive_damage 入口交付伤害;动画最后读取本帧事实,选择表现状态。

协调层允许知道有哪些能力,却不应该重新实现移动公式、扣血规则或动画决策。单目标、同步的交互优先使用显式方法调用;只有确实存在多订阅者时,才考虑把结果发布成事件。
用一个完整示例验证协作
以下示例可在 Python 3.10 及以上版本直接运行。它用一维整数位置表示移动,固定每次攻击造成 5 点伤害;故意省略碰撞、命中距离和冷却,以便只观察组件之间如何传递消息。
from dataclasses import dataclass
@dataclass(frozen=True)
class Intent:
move_axis: int
attack: bool
class InputComponent:
def read(self, raw: dict[str, int | bool]) -> Intent:
# 只把设备输入转为意图,不直接控制移动或攻击
return Intent(int(raw.get("move", 0)), bool(raw.get("attack", False)))
class MovementComponent:
def __init__(self):
self.position = 0
def update(self, axis: int, alive: bool) -> None:
if alive:
self.position += max(-1, min(1, axis))
class HealthComponent:
def __init__(self, hp: int):
self.hp = hp
@property
def is_alive(self) -> bool:
return self.hp > 0
def receive_damage(self, amount: int) -> None:
self.hp = max(0, self.hp - max(0, amount))
class AttackComponent:
def damage_for(self, requested: bool, alive: bool) -> int:
return 5 if requested and alive else 0
class AnimationComponent:
def choose(self, alive: bool, moved: bool, attacked: bool) -> str:
if not alive:
return "Dead"
if attacked:
return "Attack"
return "Walk" if moved else "Idle"
class Character:
def __init__(self, hp: int):
self.input = InputComponent()
self.movement = MovementComponent()
self.health = HealthComponent(hp)
self.attack = AttackComponent()
self.animation = AnimationComponent()
def receive_damage(self, amount: int) -> None:
self.health.receive_damage(amount)
def tick(self, raw: dict[str, int | bool], target: "Character") -> str:
intent = self.input.read(raw)
old_position = self.movement.position
self.movement.update(intent.move_axis, self.health.is_alive)
damage = self.attack.damage_for(intent.attack, self.health.is_alive)
if damage:
# 只通过目标对外能力入口传递伤害
target.receive_damage(damage)
return self.animation.choose(
self.health.is_alive,
self.movement.position != old_position,
damage > 0,
)
player = Character(hp=20)
enemy = Character(hp=12)
state = player.tick({"move": 1, "attack": True}, enemy)
print(f"位置={player.movement.position} 动画={state} 敌人HP={enemy.health.hp}")
state = player.tick({"move": 0, "attack": False}, enemy)
print(f"位置={player.movement.position} 动画={state} 敌人HP={enemy.health.hp}")预期输出:
位置=1 动画=Attack 敌人HP=7
位置=1 动画=Idle 敌人HP=7第一帧玩家前进一个单位,并通过目标的公开入口造成 5 点伤害,使敌人生命值从 12 变为 7。第二帧没有移动或攻击,位置与生命值不变,动画退回 Idle;动画只读取结果,没有写入战斗状态。
检查边界能否独立测试
可以分别测试三个不变量:未提供移动输入时位移为零;受到超出当前生命值的伤害时 hp 最低为零;死亡角色在下一帧不能移动或攻击。若验证其中一项必须创建 UI、音频或整套场景,就说明组件边界仍然过宽。
落地到游戏引擎时,在对象装配完成后再开始更新;把真实位移交给合适的物理更新阶段,把命中检测交给战斗系统。这样输入设备、攻击规则或动画资源更换时,不必同时改动其他能力组件。