游戏 AI / 系统课时
拆出可复用的状态机框架
拆出可复用的状态机框架
当敌人数量变多后,真正拖慢开发的往往不是某个 Patrol 或 Attack 状态,而是每个敌人都重复实现状态切换、事件转发和调试日志。本节把这些共性能力收进一个轻量框架,同时把感知参数、攻击规则和动画细节留在具体敌人层。
学习目标
- 划清状态机框架与敌人业务逻辑的边界
- 实现可复用的状态接口、转移注册和事件分发
- 为状态切换加入足够的调试信息,便于定位异常跳转
先划清框架和业务的边界
可复用框架只解决四件事:保存当前状态、调用生命周期、根据事件查找转移、记录切换过程。至于“玩家进入 8 米内算发现”“重击能否打断攻击”“播放哪段动画”,都属于具体敌人的规则,不应该写进框架。

这样拆分后,同一个状态机类可以服务近战兵、远程兵甚至非敌对 NPC;它们只需要提供自己的状态对象和转移表。判断是否“足够通用”的简单标准是:框架代码里不应该出现 attackRange、playerVisible 这类具体玩法字段。
用一个最小骨架跑通生命周期
下面的 Java 17 示例把状态接口、事件转移和日志集中到 StateMachine,而 IdleState、ChaseState 与事件枚举仍属于敌人实现。代码可以直接保存为 FsmDemo.java 编译运行。
import java.util.HashMap;
import java.util.Map;
public class FsmDemo {
interface State<C> {
String id();
default void enter(C context) {}
void update(C context);
default void exit(C context) {}
}
static class StateMachine<C, E> {
private final C context;
private final Map<String, State<C>> states = new HashMap<>();
private final Map<String, Map<E, String>> transitions = new HashMap<>();
private State<C> current;
StateMachine(C context) {
this.context = context;
}
void addState(State<C> state) {
states.put(state.id(), state);
}
void addTransition(String from, E event, String to) {
transitions.computeIfAbsent(from, key -> new HashMap<>()).put(event, to);
}
void start(String stateId) {
current = requireState(stateId);
current.enter(context);
}
void update() {
current.update(context);
}
void handle(E event) {
String targetId = transitions
.getOrDefault(current.id(), Map.of())
.get(event);
// 没有匹配转移时保持当前状态,事件是否记录可由调试策略决定。
if (targetId == null || targetId.equals(current.id())) {
return;
}
State<C> target = requireState(targetId);
System.out.printf("[fsm] %s --%s--> %s%n",
current.id(), event, target.id());
current.exit(context);
current = target;
current.enter(context);
}
private State<C> requireState(String id) {
State<C> state = states.get(id);
if (state == null) {
throw new IllegalArgumentException("Unknown state: " + id);
}
return state;
}
}
static class EnemyContext {
int playerDistance = 8;
}
enum EnemyEvent {
TARGET_SEEN, TARGET_LOST
}
static class IdleState implements State<EnemyContext> {
public String id() { return "idle"; }
public void enter(EnemyContext context) { System.out.println("enter idle"); }
public void update(EnemyContext context) {}
public void exit(EnemyContext context) { System.out.println("exit idle"); }
}
static class ChaseState implements State<EnemyContext> {
public String id() { return "chase"; }
public void enter(EnemyContext context) { System.out.println("enter chase"); }
public void update(EnemyContext context) {
System.out.println("chasing, distance=" + context.playerDistance);
}
public void exit(EnemyContext context) { System.out.println("exit chase"); }
}
public static void main(String[] args) {
EnemyContext context = new EnemyContext();
StateMachine<EnemyContext, EnemyEvent> fsm = new StateMachine<>(context);
fsm.addState(new IdleState());
fsm.addState(new ChaseState());
fsm.addTransition("idle", EnemyEvent.TARGET_SEEN, "chase");
fsm.addTransition("chase", EnemyEvent.TARGET_LOST, "idle");
fsm.start("idle");
fsm.handle(EnemyEvent.TARGET_SEEN);
fsm.update();
fsm.handle(EnemyEvent.TARGET_LOST);
}
}预期输出:
enter idle
[fsm] idle --TARGET_SEEN--> chase
exit idle
enter chase
chasing, distance=8
[fsm] chase --TARGET_LOST--> idle
exit chase
enter idle这个骨架故意没有把“何时产生 TARGET_SEEN”写进状态机。感知系统只负责产生事件,状态机只负责消费事件并执行已注册的转移,职责因此不会随着敌人种类增加而重新纠缠。
让所有转移经过统一入口
状态切换最怕出现多个入口:某些状态直接修改 current,某些事件走转移表,还有些动画回调偷偷切状态。结果是 exit 漏调、重复进入同一状态,甚至出现一帧内连续跳转。
更稳妥的规则是:外部系统只能发送事件或提出“期望状态”,真正修改当前状态的权限只保留在状态机内部。统一入口还可以集中处理不可打断窗口、优先级、合法性校验和切换日志,而不必把同一套保护逻辑复制到每个状态。
把调试能力也当成框架能力
可复用框架至少应能回答三个问题:当前是什么状态、刚才因为什么发生切换、某个事件为什么没有产生转移。开发期可以记录 from -> event -> to,并在未知状态、重复注册和非法目标状态时尽早失败。
当项目进一步变大时,可以把日志输出替换成可注入的调试接口,再由编辑器面板、屏幕 HUD 或回放系统消费。这里仍然不要把具体敌人字段硬编码进框架,调试层只需要记录状态 ID、事件、时间和少量上下文快照。
哪些内容不要继续抽象
状态接口、生命周期和转移机制通常值得复用,但每个游戏都不同的决策语义不必强行塞进框架。若为了兼容所有敌人不断增加 if、特殊回调和例外参数,说明抽象层已经越界。
一个实用边界是:框架提供“怎么切”,具体敌人决定“为什么切”;框架提供事件通道,感知、战斗和动画系统决定事件何时产生。守住这条边界,状态数量增长时才主要增加配置和具体状态,而不是反复改动底层状态机。