1. 项目概述一个面向游戏开发的有限状态机框架如果你是一名游戏开发者或者正在涉足需要复杂状态管理的软件项目那么“状态机”这个概念你一定不陌生。简单来说状态机就是用来管理一个对象比如游戏里的角色、UI界面、或者一个任务流程在不同状态之间切换的逻辑模型。它能让你的代码从一堆混乱的if-else或switch-case中解脱出来变得清晰、可维护且易于扩展。今天要聊的这个项目imjp94/gd-YAFSM就是一个专门为 Godot 游戏引擎设计的有限状态机Finite State Machine FSM框架。它的名字 “YAFSM” 是 “Yet Another Finite State Machine” 的缩写直译过来就是“又一个有限状态机”听起来有点自嘲但恰恰说明了在游戏开发领域状态机是一个被反复造轮子、但又极其核心的组件。这个项目由开发者imjp94创建并维护旨在为 Godot 4 提供一个轻量、高效、且符合 Godot 设计哲学特别是面向节点和场景的架构的状态机解决方案。我在多个 Godot 项目中尝试过自己手写状态机、使用其他社区插件最终发现gd-YAFSM在易用性、性能以及与 Godot 编辑器的集成度上找到了一个很好的平衡点。它不仅仅是一个代码库更是一套帮助你组织状态逻辑的最佳实践。无论你是想实现一个拥有“待机、移动、攻击、受伤、死亡”等状态的游戏角色还是一个包含“加载、主菜单、游戏中、暂停、结束”等界面的 UI 流程这个框架都能让你事半功倍。2. 核心设计理念与架构解析2.1 为什么 Godot 需要专门的状态机框架Godot 引擎本身非常强大其节点Node和场景Scene系统本身就是一种层次化的状态管理工具。你可以通过启用/禁用节点、切换场景来改变状态。那为什么还需要额外的状态机框架呢原因在于“业务逻辑的复杂度”。当你的游戏角色状态超过3个并且状态间的转换条件变得复杂例如从“移动”状态可以切换到“攻击”但前提是目标在范围内且技能冷却完毕从“攻击”状态可以切换到“受伤”但无法直接切换到“跳跃”用简单的布尔标志或枚举配合if语句会迅速导致代码臃肿和难以调试。状态机框架通过明确的“状态State”、“转换Transition”、“条件Condition”等概念将这种复杂度规范化、模块化。gd-YAFSM的设计目标很明确保持 Godot 的原生感。它不强迫你学习一套全新的、与 Godot 格格不入的 API而是尝试将状态机的概念映射到 Godot 的节点树上让你能在编辑器中直观地配置和调试状态逻辑。2.2 框架的核心组件与工作流gd-YAFSM的核心架构围绕几个关键类展开理解它们之间的关系是上手的关键StateMachine 节点这是状态机的“大脑”或容器。它是一个自定义的Node通常是Node2D或Node3D的子类负责管理当前活跃的状态、处理状态转换的请求。你通常会将它作为你的游戏角色Player或敌人Enemy场景根节点的一个子节点。State 资源每个具体的状态如 Idle, Run, Jump都被定义为一个继承自YState的资源Resource。这是gd-YAFSM一个非常巧妙的设计。将状态定义为资源.tres文件意味着可复用性一个“跳跃”状态资源可以被多个不同的角色状态机共享。编辑器友好你可以在 Godot 的资源面板中创建、编辑状态并为其添加自定义属性如跳跃力度、动画名称。与场景解耦状态逻辑不直接硬编码在场景节点中更清晰。Transition 资源状态转换也被定义为资源YTransition。一个转换资源关联了一个“目标状态”和一系列“条件Condition”。它回答了“何时”以及“切换到哪个状态”的问题。Condition 节点条件是转换是否被触发的判断逻辑。gd-YAFSM提供了一些内置条件如布尔条件、计时器条件也允许你编写继承自YCondition的自定义条件节点。这些条件节点作为StateMachine节点的子节点存在可以访问状态机所属实体的各种属性如玩家的速度、输入、生命值等来进行判断。典型的工作流如下你在角色场景中创建一个StateMachine节点。在文件系统中创建若干个.tres状态资源如idle_state.tres,run_state.tres。在StateMachine节点的属性面板中将这些状态资源添加到它的状态列表里并指定一个初始状态。为每个状态创建转换资源在转换资源中设置目标状态并为其关联一个或多个条件节点这些条件节点是StateMachine的子节点。运行游戏StateMachine会自动根据条件评估结果驱动状态间的切换。注意这种“资源化”的设计理念需要一点时间来适应尤其是习惯了将所有逻辑都写在脚本里的开发者。但一旦掌握你会发现它对于管理大型、复杂的状态机非常有优势因为所有配置都是数据驱动的易于调整而不需要修改代码。2.3 与手动实现或其他插件的对比在接触gd-YAFSM之前我常用的方法是“状态模式”的手动实现定义一个状态基类然后为每个具体状态创建子类在状态机类里维护当前状态实例。这种方法很灵活但缺点也很明显编辑器支持弱。你无法在编辑器中可视化状态之间的连接调试时需要打印日志或依赖断点。也有一些其他 Godot 状态机插件采用“节点即状态”的方式即每个状态都是一个场景Scene。这种方式编辑器集成度最高但可能会带来额外的场景实例化开销并且在状态逻辑非常简单时显得有些重。gd-YAFSM采取了折中方案状态是资源逻辑在脚本中转换和条件可编辑器配置。它既提供了足够的编辑器可视化能力通过自定义属性面板和调试信息又保持了轻量和高效。资源在内存中是共享的不会为每个状态机实例都创建一份新的状态逻辑副本。3. 从零开始搭建你的第一个状态机理论说得再多不如动手实践。让我们用一个最经典的例子——实现一个简单的平台游戏角色状态机包含待机、奔跑、跳跃、下落来一步步拆解gd-YAFSM的使用。3.1 环境准备与插件安装首先你需要一个 Godot 4.x 的项目。gd-YAFSM的安装非常 Godot 化主要有两种方式使用 AssetLib资源库在 Godot 编辑器内点击顶部菜单栏的 “AssetLib”搜索 “YAFSM”找到后直接下载并安装。这是最推荐的方式Godot 会自动处理依赖和插件启用。手动安装从项目的 GitHub 仓库https://github.com/imjp94/gd-YAFSM下载最新版本将addons文件夹下的yafsm目录复制到你项目的addons目录下。然后进入项目设置 - 插件找到 YAFSM 并启用它。安装并启用后你会在创建新节点时的搜索框中看到新增的节点类型如StateMachine、BoolCondition等。3.2 创建角色与状态机节点假设我们有一个名为Player的CharacterBody2D场景作为我们的游戏角色。在这个场景中添加一个Sprite2D用于显示一个CollisionShape2D用于碰撞。关键的一步添加一个StateMachine节点。右键点击Player根节点选择“添加子节点”搜索 “StateMachine”。注意StateMachine本身是一个Node但为了更方便地访问父节点角色的属性我们通常将其类型改为Node2D如果你的角色是 3D 的则用Node3D。你可以在创建后在检查器面板顶部将其类型从Node改为Node2D。我们将其重命名为StateMachine。现在你的场景树看起来应该是这样的Player (CharacterBody2D) ├── Sprite2D ├── CollisionShape2D └── StateMachine (Node2D)3.3 定义状态资源.tres接下来我们要创建状态资源。在文件系统面板中右键点击你想保存资源的文件夹例如res://states/选择“新建资源”。在资源列表中你应该能找到YState如果没找到请确认插件已正确启用。我们创建四个状态资源idle_state.tresrun_state.tresjump_state.tresfall_state.tres创建后每个资源在检查器中都有一个Script属性。你需要为它们分配脚本。通常我们会为所有状态创建一个共用的基础脚本然后每个状态一个脚本。但为了入门简单我们可以先从一个脚本处理所有状态开始。在res://scripts/下创建一个名为player_state.gd的脚本extends YState class_name PlayerState # 这个函数在该状态进入时调用 func enter(_msg: {}) - void: print(进入状态: , name) # 这个函数在该状态退出时调用 func exit() - void: print(退出状态: , name) # 这个函数在状态机处理物理帧时调用在 _physics_process 中 func physics_update(_delta: float) - void: pass # 这个函数在状态机处理帧时调用在 _process 中 func update(_delta: float) - void: pass然后分别将idle_state.tres、run_state.tres等资源的Script属性指向这个player_state.gd。同时在检查器中为每个资源的Name属性赋予易读的名字如 “Idle”, “Run”。实操心得在实际项目中我更倾向于为每个状态创建独立的脚本如idle_state.gd,run_state.gd它们都继承自一个公共的PlayerStateBase。这样代码更清晰也便于利用 Godot 的“脚本类”功能进行类型提示。但初期混合使用一个脚本有助于快速理解流程。3.4 配置状态机与初始状态回到场景中的StateMachine节点。在检查器中你会发现它有几个重要属性States: 一个数组用于存放所有可能的状态资源。点击它将我们刚才创建的四个.tres资源都拖进去。Initial State: 初始状态。从下拉列表中选择idle_state.tres。Debug: 启用后可以在运行时查看当前状态对于调试非常有用建议开启。3.5 创建条件节点与转换资源状态有了现在需要定义它们之间如何转换。转换由“条件”触发。第一步创建条件节点。条件节点是StateMachine节点的子节点。右键点击StateMachine添加子节点搜索BoolCondition一个内置的布尔条件节点。我们可能需要多个条件例如IsOnFloor: 判断角色是否在地面上。我们可以将其重命名为Cond_IsOnFloor。IsMoving: 判断角色是否有水平输入。重命名为Cond_IsMoving。VelocityYNegative: 判断垂直速度是否向上跳跃。重命名为Cond_Jumping。VelocityYPositive: 判断垂直速度是否向下下落。重命名为Cond_Falling。这些BoolCondition节点需要脚本来提供实际的布尔值。我们需要编写一个附着在StateMachine节点上的脚本来更新这些条件。在StateMachine节点上附加一个新脚本命名为player_state_machine.gdextends Node2D # 注意我们之前将StateMachine的类型改为了Node2D onready var bool_is_on_floor: BoolCondition $Cond_IsOnFloor onready var bool_is_moving: BoolCondition $Cond_IsMoving onready var bool_is_jumping: BoolCondition $Cond_Jumping onready var bool_is_falling: BoolCondition $Cond_Falling var player: CharacterBody2D func _ready() - void: player get_parent() as CharacterBody2D if not player: push_error(StateMachine 的父节点不是 CharacterBody2D!) # 初始化条件节点的“检查函数” bool_is_on_floor.check_func is_on_floor_check bool_is_moving.check_func is_moving_check bool_is_jumping.check_func is_jumping_check bool_is_falling.check_func is_falling_check func is_on_floor_check() - bool: return player.is_on_floor() if player else false func is_moving_check() - bool: # 假设我们通过一个 input_direction 向量来获取输入 return abs(player.input_direction.x) 0.1 if player else false func is_jumping_check() - bool: return player.velocity.y 0 if player else false # 向上速度为负 func is_falling_check() - bool: return player.velocity.y 0 and not player.is_on_floor() if player else false # 向下速度为正且不在地面这里我们通过将每个BoolCondition节点的check_func属性绑定到一个返回布尔值的函数上来动态更新条件。第二步创建转换资源。转换资源.tres将状态和条件联系起来。例如我们需要一个从“待机Idle”到“奔跑Run”的转换。新建一个YTransition资源命名为trans_idle_to_run.tres。将其To State属性设置为run_state.tres。关键属性Conditions。这是一个条件节点路径的数组。我们需要点击编辑然后添加我们之前创建的条件节点路径例如../Cond_IsMoving因为条件节点是状态机的子节点在资源中引用需要使用相对路径。这意味着当Cond_IsMoving条件为true时这个转换就会被触发。类似地我们需要创建其他转换trans_run_to_idle.tres:To Stateidle_state.tres,Conditions[../Cond_IsMoving]但这里我们需要Cond_IsMoving为false。BoolCondition节点本身有一个Is Not复选框可以反转逻辑。所以我们可以创建另一个条件节点Cond_IsNotMoving其check_func返回!is_moving_check()或者直接使用Cond_IsMoving并在转换逻辑中处理反转YTransition资源可能支持条件反转需查看具体文档或源码这里假设我们创建新节点。trans_any_to_jump.tres: 从任何状态跳转到“跳跃”状态。通常跳跃由按键触发我们可以创建一个Cond_JumpPressed条件节点其check_func检查跳跃键是否刚按下。然后将此转换资源的From State留空或设置为*代表任何状态To Statejump_state.tres,Conditions[../Cond_JumpPressed]。trans_jump_to_fall.tres: 跳跃到下落。To Statefall_state.tres,Conditions[../Cond_Falling]。trans_fall_to_idle.tres: 下落到待机落地。To Stateidle_state.tres,Conditions[../Cond_IsOnFloor]。trans_fall_to_run.tres: 下落到奔跑落地且正在移动。To Staterun_state.tres,Conditions[../Cond_IsOnFloor, ../Cond_IsMoving]。第三步将转换分配给状态。最后一步回到状态资源。例如打开idle_state.tres找到Transitions属性可能叫Out Transitions或类似名称这是一个转换资源的数组。将trans_idle_to_run.tres和trans_any_to_jump.tres如果跳跃是全局的添加进去。这意味着当处于 Idle 状态时状态机会检查这两个转换的条件是否满足。为run_state.tres添加trans_run_to_idle.tres和trans_any_to_jump.tres。 为jump_state.tres添加trans_jump_to_fall.tres。 为fall_state.tres添加trans_fall_to_idle.tres和trans_fall_to_run.tres。至此一个基础的角色状态机框架就搭建完成了。当游戏运行时StateMachine节点会自动轮询当前活跃状态所关联的所有转换条件并在条件满足时切换到目标状态。4. 深入核心状态逻辑的实现与交互框架搭好了但状态本身还没任何行为。我们需要在状态脚本中实现具体的逻辑比如播放动画、应用移动物理、处理输入等。4.1 在状态脚本中访问所属实体状态脚本如player_state.gd需要能够影响它所属的角色。gd-YAFSM的状态基类YState提供了一个state_machine属性通过它可以访问到StateMachine节点进而访问到角色的根节点。修改player_state.gd添加一个便捷属性extends YState class_name PlayerState # 获取状态机节点 var fsm: StateMachine: get: return state_machine as StateMachine # 通过状态机获取父节点即我们的Player角色 var player: CharacterBody2D: get: if fsm and is_instance_valid(fsm.get_parent()): return fsm.get_parent() as CharacterBody2D return null现在在enter,exit,physics_update,update函数中我们都可以通过self.player来访问和操作角色。4.2 实现具体状态行为让我们丰富player_state.gd并为不同状态添加差异化逻辑。我们可以使用match语句根据状态名来区分行为但更好的做法是利用 Godot 的继承或“脚本类”。这里为了演示我们先在一个脚本内用match实现func enter(_msg: {}) - void: if not player: return match name: Idle: player.velocity.x 0 player.play_animation(idle) Run: player.play_animation(run) Jump: player.velocity.y player.jump_velocity # 假设jump_velocity是Player的一个负值属性 player.play_animation(jump_start) Fall: player.play_animation(fall) print(进入状态: , name) func physics_update(delta: float) - void: if not player: return # 公共物理逻辑例如重力 player.velocity.y player.gravity * delta match name: Idle: # 待机状态可能只需要处理滑行停止 player.velocity.x move_toward(player.velocity.x, 0, player.friction) Run: # 奔跑状态处理水平移动 var input_dir Input.get_vector(move_left, move_right, move_up, move_down) player.velocity.x input_dir.x * player.run_speed # 可能还需要处理转身逻辑 if input_dir.x ! 0: player.sprite.flip_h input_dir.x 0 Jump, Fall: # 跳跃和下落状态都允许水平控制但可能加速度不同 var input_dir Input.get_vector(move_left, move_right, move_up, move_down) var air_accel player.air_acceleration if name Jump else player.fall_acceleration player.velocity.x move_toward(player.velocity.x, input_dir.x * player.run_speed, air_accel * delta) if input_dir.x ! 0: player.sprite.flip_h input_dir.x 0 player.move_and_slide() func update(_delta: float) - void: # 处理一些每帧更新但不涉及物理的逻辑比如动画过渡 pass func exit() - void: print(退出状态: , name) # 退出状态时可能需要清理一些临时效果在实际项目中player对象应该提供诸如play_animation()、apply_gravity()、get_input()等方法状态脚本主要调用这些接口保持状态逻辑的整洁。4.3 状态间传递消息有时从一个状态切换到另一个状态时需要传递一些数据。例如从“受伤”状态退出时可能需要知道伤害来源的方向以便播放正确的被击退动画。gd-YAFSM的enter()函数接受一个可选的msg参数字典。在触发转换的代码中可能是在条件节点的检查函数里或者在其他系统如伤害系统中你可以调用状态机的transition_to(state_name, msg)方法具体方法名需查看插件API。在目标状态的enter(msg)方法里你就可以解析这个字典获取需要的信息。例如在hurt_state.gd的enter方法中func enter(msg: {}) - void: var damage_source_direction: Vector2 msg.get(direction, Vector2.RIGHT) # 根据击退方向播放动画或应用力 player.apply_knockback(damage_source_direction)4.4 层级状态机与并行状态机对于更复杂的角色比如既能在地上跑又能游泳同时还能使用武器简单的平面状态机可能不够用。gd-YAFSM支持更高级的概念层级状态机一个状态本身可以包含一个子状态机。例如你可以有一个“移动Locomotion”顶层状态它内部包含“地面移动”和“空中移动”子状态机而“地面移动”子状态机又包含“待机”、“行走”、“奔跑”等状态。这有助于将相关的状态逻辑分组减少转换的复杂度。并行状态机多个状态机可以同时运行在同一个实体上。例如一个状态机控制角色的移动待机、跑、跳另一个独立的状态机控制角色的表情或嘴部动画中性、说话、微笑。它们互不干扰共同决定角色的最终表现。实现这些高级功能通常需要在设计状态资源时进行更复杂的配置可能涉及将StateMachine节点作为另一个状态的子节点。gd-YAFSM的文档和示例项目中通常会有相关的演示。5. 调试、优化与常见问题排查使用任何框架调试能力都至关重要。gd-YAFSM提供了一些内置的调试支持结合 Godot 自身的工具可以有效地排查状态机问题。5.1 利用内置调试功能在StateMachine节点的检查器中启用Debug属性。运行游戏后你可以在场景树中选中StateMachine节点在 Godot 编辑器的“调试器”面板或“远程”视图中看到当前活跃的状态名。一些插件版本甚至会在游戏窗口上叠加显示当前状态这对于快速验证状态转换是否正确非常有用。你可以在状态脚本的enter和exit函数中加入print()语句这是最直接的调试方式。确保你能看到符合预期的状态切换日志。5.2 常见问题与解决方案以下是我在项目中使用gd-YAFSM时遇到的一些典型问题及解决方法问题1状态转换没有发生。检查点1条件节点路径是否正确。在转换资源.tres中Conditions数组里填写的节点路径必须是正确的相对路径从状态机节点出发。在编辑器中你可以将条件节点从场景树拖拽到转换资源的属性栏Godot 会自动生成正确路径。检查点2条件节点的check_func是否被正确赋值。确保在你的状态机控制器脚本如player_state_machine.gd的_ready()函数中已经将所有BoolCondition节点的check_func绑定到了对应的函数。如果check_func是null条件永远为false。检查点3条件逻辑是否正确。在check_func绑定的函数内部打印返回值确认在预期情况下它返回了true。注意BoolCondition的Is Not复选框是否被误勾选。检查点4转换是否被添加到了正确的状态上。确认你创建的转换资源如trans_idle_to_run.tres被添加到了源状态idle_state.tres的Transitions列表中。问题2进入状态时player变量为null。原因状态脚本的enter()方法可能在_ready()之前就被调用了此时state_machine引用可能尚未就绪或者获取父节点的逻辑有问题。解决在player属性的 getter 中增加空值检查或者将需要player的逻辑移到physics_update或update中因为这些函数在状态进入后的每一帧都会被调用此时引用通常已准备就绪。另一种方法是在状态机的_ready()中显式地初始化所有状态对状态机的引用如果插件支持。问题3性能开销。分析状态机本身开销极低。主要开销来自于每帧对所有活跃转换的条件进行检查。如果条件检查函数非常复杂例如进行了大量的物理查询或计算可能会成为瓶颈。优化缓存结果对于计算成本高的条件可以在状态机控制器脚本的_process或_physics_process中计算一次然后将结果存储在一个成员变量中条件节点的check_func直接返回这个缓存值。减少条件数量审视状态设计是否可以通过更简洁的状态划分来减少转换和条件的数量。使用更高效的条件类型gd-YAFSM可能提供了ExpressionCondition表达式条件允许你在编辑器中直接编写 GDScript 表达式。虽然方便但解释执行可能比编译好的函数稍慢。对于性能关键处使用BoolCondition并绑定到优化过的函数是更好的选择。问题4与 Godot 4 新特性的兼容性。gd-YAFSM是为 Godot 4 设计的通常兼容性良好。但需要注意GDScript 2.0 语法确保你的脚本使用正确的 GDScript 2.0 语法如onready注解、强类型声明等。信号与回调状态基类YState提供的enter,exit,update,physics_update都是虚函数确保正确使用override关键字如果插件基类使用了virtual或直接定义。资源唯一ID在 Godot 4 中.tres资源文件管理要小心。重命名或移动资源文件有时会导致场景中引用丢失需要重新指定。5.3 扩展创建自定义条件内置的BoolCondition很常用但有时你需要更复杂的判断逻辑比如“距离小于某个值”、“冷却时间结束”等。你可以轻松创建自定义条件。创建一个继承自YCondition或Condition具体类名需查看插件的新脚本例如distance_condition.gd。在这个脚本中你需要实现一个is_triggered()方法返回一个布尔值。将这个脚本附加到一个普通的Node上然后将这个节点作为StateMachine的子节点。在转换资源中将这个自定义条件节点的路径添加到Conditions列表。# distance_condition.gd extends YCondition # 请根据插件实际基类名调整 class_name DistanceCondition export var target_path: NodePath export var max_distance: float 100.0 var _target: Node2D func _ready() - void: if target_path: _target get_node(target_path) as Node2D func is_triggered() - bool: if not _target or not state_machine: return false var fsm_pos (state_machine as Node2D).global_position var target_pos _target.global_position return fsm_pos.distance_to(target_pos) max_distance这样你就可以在编辑器中配置这个条件的目标节点和最大距离实现一个可复用的距离条件。6. 项目实战构建一个简单的敌人AI状态机为了更全面地展示gd-YAFSM的能力我们用它来实现一个简单的巡逻-追击-攻击的敌人AI。设计状态Patrol巡逻在预设点之间移动。Chase追击当玩家进入警戒范围时朝玩家移动。Attack攻击当玩家进入攻击范围时执行攻击动作。Hurt受伤被玩家攻击时进入短暂硬直。Die死亡生命值归零时播放死亡动画并禁用。实现要点状态机节点附加在敌人场景的根节点下。条件节点Cond_PlayerInSight使用RayCast2D或区域Area2D判断玩家是否在视野内且无遮挡。Cond_PlayerInAttackRange判断与玩家的距离是否小于攻击距离。Cond_IsHealthZero判断生命值是否为零。Cond_HurtTimerExpired一个计时器条件受伤状态持续一段时间后自动退出。转换Patrol - Chase:Cond_PlayerInSight为真。Chase - Attack:Cond_PlayerInAttackRange为真。Attack - Chase:Cond_PlayerInAttackRange为假玩家跑出范围。Chase - Patrol:Cond_PlayerInSight为假玩家丢失。(Any) - Hurt: 当受到伤害时通过代码调用状态机的transition_to(“Hurt”)并传递伤害信息。Hurt - (Previous):Cond_HurtTimerExpired为真状态机可以设计为返回之前的状态。(Any) - Die:Cond_IsHealthZero为真。状态逻辑PatrolState: 在physics_update中沿着路径点移动。ChaseState: 在physics_update中计算朝向玩家的方向并移动。AttackState: 在enter中播放攻击动画并触发伤害检测在physics_update中可能停止移动。通过动画帧事件或计时器在攻击结束后自动触发转换回Chase。HurtState: 在enter中播放受击动画、应用击退、设置一个定时器用于Cond_HurtTimerExpired并短暂无敌。DieState: 在enter中播放死亡动画、禁用碰撞体、计划后续的节点队列释放。通过这个例子你可以看到gd-YAFSM如何清晰地组织一个拥有多个状态和复杂转换规则的 AI 逻辑。所有状态和转换都在编辑器中可配置行为逻辑封装在各自的状态脚本中使得整个 AI 系统模块化程度高易于阅读、调试和扩展。最后一点个人体会gd-YAFSM可能不是功能最强大的状态机插件但它“刚刚好”的设计与 Godot 引擎的契合度非常高。它强迫你以资源化的方式思考状态这起初会增加一些学习成本但长期来看这种数据与逻辑的分离让调整游戏手感比如修改状态转换条件、动画名称变得异常轻松——你甚至可以让策划或美术同学在编辑器中微调部分参数而无需触碰代码。对于中小型 Godot 项目来说它是一个能显著提升开发效率和代码质量的选择。刚开始使用时建议从一个小型、具体的状态机比如一个门的状态关闭、打开中、打开、关闭中开始实践熟悉整个工作流后再应用到复杂的角色或系统上会顺畅很多。
Godot游戏开发：基于gd-YAFSM框架的有限状态机实践指南
发布时间：2026/5/19 3:45:09
1. 项目概述一个面向游戏开发的有限状态机框架如果你是一名游戏开发者或者正在涉足需要复杂状态管理的软件项目那么“状态机”这个概念你一定不陌生。简单来说状态机就是用来管理一个对象比如游戏里的角色、UI界面、或者一个任务流程在不同状态之间切换的逻辑模型。它能让你的代码从一堆混乱的if-else或switch-case中解脱出来变得清晰、可维护且易于扩展。今天要聊的这个项目imjp94/gd-YAFSM就是一个专门为 Godot 游戏引擎设计的有限状态机Finite State Machine FSM框架。它的名字 “YAFSM” 是 “Yet Another Finite State Machine” 的缩写直译过来就是“又一个有限状态机”听起来有点自嘲但恰恰说明了在游戏开发领域状态机是一个被反复造轮子、但又极其核心的组件。这个项目由开发者imjp94创建并维护旨在为 Godot 4 提供一个轻量、高效、且符合 Godot 设计哲学特别是面向节点和场景的架构的状态机解决方案。我在多个 Godot 项目中尝试过自己手写状态机、使用其他社区插件最终发现gd-YAFSM在易用性、性能以及与 Godot 编辑器的集成度上找到了一个很好的平衡点。它不仅仅是一个代码库更是一套帮助你组织状态逻辑的最佳实践。无论你是想实现一个拥有“待机、移动、攻击、受伤、死亡”等状态的游戏角色还是一个包含“加载、主菜单、游戏中、暂停、结束”等界面的 UI 流程这个框架都能让你事半功倍。2. 核心设计理念与架构解析2.1 为什么 Godot 需要专门的状态机框架Godot 引擎本身非常强大其节点Node和场景Scene系统本身就是一种层次化的状态管理工具。你可以通过启用/禁用节点、切换场景来改变状态。那为什么还需要额外的状态机框架呢原因在于“业务逻辑的复杂度”。当你的游戏角色状态超过3个并且状态间的转换条件变得复杂例如从“移动”状态可以切换到“攻击”但前提是目标在范围内且技能冷却完毕从“攻击”状态可以切换到“受伤”但无法直接切换到“跳跃”用简单的布尔标志或枚举配合if语句会迅速导致代码臃肿和难以调试。状态机框架通过明确的“状态State”、“转换Transition”、“条件Condition”等概念将这种复杂度规范化、模块化。gd-YAFSM的设计目标很明确保持 Godot 的原生感。它不强迫你学习一套全新的、与 Godot 格格不入的 API而是尝试将状态机的概念映射到 Godot 的节点树上让你能在编辑器中直观地配置和调试状态逻辑。2.2 框架的核心组件与工作流gd-YAFSM的核心架构围绕几个关键类展开理解它们之间的关系是上手的关键StateMachine 节点这是状态机的“大脑”或容器。它是一个自定义的Node通常是Node2D或Node3D的子类负责管理当前活跃的状态、处理状态转换的请求。你通常会将它作为你的游戏角色Player或敌人Enemy场景根节点的一个子节点。State 资源每个具体的状态如 Idle, Run, Jump都被定义为一个继承自YState的资源Resource。这是gd-YAFSM一个非常巧妙的设计。将状态定义为资源.tres文件意味着可复用性一个“跳跃”状态资源可以被多个不同的角色状态机共享。编辑器友好你可以在 Godot 的资源面板中创建、编辑状态并为其添加自定义属性如跳跃力度、动画名称。与场景解耦状态逻辑不直接硬编码在场景节点中更清晰。Transition 资源状态转换也被定义为资源YTransition。一个转换资源关联了一个“目标状态”和一系列“条件Condition”。它回答了“何时”以及“切换到哪个状态”的问题。Condition 节点条件是转换是否被触发的判断逻辑。gd-YAFSM提供了一些内置条件如布尔条件、计时器条件也允许你编写继承自YCondition的自定义条件节点。这些条件节点作为StateMachine节点的子节点存在可以访问状态机所属实体的各种属性如玩家的速度、输入、生命值等来进行判断。典型的工作流如下你在角色场景中创建一个StateMachine节点。在文件系统中创建若干个.tres状态资源如idle_state.tres,run_state.tres。在StateMachine节点的属性面板中将这些状态资源添加到它的状态列表里并指定一个初始状态。为每个状态创建转换资源在转换资源中设置目标状态并为其关联一个或多个条件节点这些条件节点是StateMachine的子节点。运行游戏StateMachine会自动根据条件评估结果驱动状态间的切换。注意这种“资源化”的设计理念需要一点时间来适应尤其是习惯了将所有逻辑都写在脚本里的开发者。但一旦掌握你会发现它对于管理大型、复杂的状态机非常有优势因为所有配置都是数据驱动的易于调整而不需要修改代码。2.3 与手动实现或其他插件的对比在接触gd-YAFSM之前我常用的方法是“状态模式”的手动实现定义一个状态基类然后为每个具体状态创建子类在状态机类里维护当前状态实例。这种方法很灵活但缺点也很明显编辑器支持弱。你无法在编辑器中可视化状态之间的连接调试时需要打印日志或依赖断点。也有一些其他 Godot 状态机插件采用“节点即状态”的方式即每个状态都是一个场景Scene。这种方式编辑器集成度最高但可能会带来额外的场景实例化开销并且在状态逻辑非常简单时显得有些重。gd-YAFSM采取了折中方案状态是资源逻辑在脚本中转换和条件可编辑器配置。它既提供了足够的编辑器可视化能力通过自定义属性面板和调试信息又保持了轻量和高效。资源在内存中是共享的不会为每个状态机实例都创建一份新的状态逻辑副本。3. 从零开始搭建你的第一个状态机理论说得再多不如动手实践。让我们用一个最经典的例子——实现一个简单的平台游戏角色状态机包含待机、奔跑、跳跃、下落来一步步拆解gd-YAFSM的使用。3.1 环境准备与插件安装首先你需要一个 Godot 4.x 的项目。gd-YAFSM的安装非常 Godot 化主要有两种方式使用 AssetLib资源库在 Godot 编辑器内点击顶部菜单栏的 “AssetLib”搜索 “YAFSM”找到后直接下载并安装。这是最推荐的方式Godot 会自动处理依赖和插件启用。手动安装从项目的 GitHub 仓库https://github.com/imjp94/gd-YAFSM下载最新版本将addons文件夹下的yafsm目录复制到你项目的addons目录下。然后进入项目设置 - 插件找到 YAFSM 并启用它。安装并启用后你会在创建新节点时的搜索框中看到新增的节点类型如StateMachine、BoolCondition等。3.2 创建角色与状态机节点假设我们有一个名为Player的CharacterBody2D场景作为我们的游戏角色。在这个场景中添加一个Sprite2D用于显示一个CollisionShape2D用于碰撞。关键的一步添加一个StateMachine节点。右键点击Player根节点选择“添加子节点”搜索 “StateMachine”。注意StateMachine本身是一个Node但为了更方便地访问父节点角色的属性我们通常将其类型改为Node2D如果你的角色是 3D 的则用Node3D。你可以在创建后在检查器面板顶部将其类型从Node改为Node2D。我们将其重命名为StateMachine。现在你的场景树看起来应该是这样的Player (CharacterBody2D) ├── Sprite2D ├── CollisionShape2D └── StateMachine (Node2D)3.3 定义状态资源.tres接下来我们要创建状态资源。在文件系统面板中右键点击你想保存资源的文件夹例如res://states/选择“新建资源”。在资源列表中你应该能找到YState如果没找到请确认插件已正确启用。我们创建四个状态资源idle_state.tresrun_state.tresjump_state.tresfall_state.tres创建后每个资源在检查器中都有一个Script属性。你需要为它们分配脚本。通常我们会为所有状态创建一个共用的基础脚本然后每个状态一个脚本。但为了入门简单我们可以先从一个脚本处理所有状态开始。在res://scripts/下创建一个名为player_state.gd的脚本extends YState class_name PlayerState # 这个函数在该状态进入时调用 func enter(_msg: {}) - void: print(进入状态: , name) # 这个函数在该状态退出时调用 func exit() - void: print(退出状态: , name) # 这个函数在状态机处理物理帧时调用在 _physics_process 中 func physics_update(_delta: float) - void: pass # 这个函数在状态机处理帧时调用在 _process 中 func update(_delta: float) - void: pass然后分别将idle_state.tres、run_state.tres等资源的Script属性指向这个player_state.gd。同时在检查器中为每个资源的Name属性赋予易读的名字如 “Idle”, “Run”。实操心得在实际项目中我更倾向于为每个状态创建独立的脚本如idle_state.gd,run_state.gd它们都继承自一个公共的PlayerStateBase。这样代码更清晰也便于利用 Godot 的“脚本类”功能进行类型提示。但初期混合使用一个脚本有助于快速理解流程。3.4 配置状态机与初始状态回到场景中的StateMachine节点。在检查器中你会发现它有几个重要属性States: 一个数组用于存放所有可能的状态资源。点击它将我们刚才创建的四个.tres资源都拖进去。Initial State: 初始状态。从下拉列表中选择idle_state.tres。Debug: 启用后可以在运行时查看当前状态对于调试非常有用建议开启。3.5 创建条件节点与转换资源状态有了现在需要定义它们之间如何转换。转换由“条件”触发。第一步创建条件节点。条件节点是StateMachine节点的子节点。右键点击StateMachine添加子节点搜索BoolCondition一个内置的布尔条件节点。我们可能需要多个条件例如IsOnFloor: 判断角色是否在地面上。我们可以将其重命名为Cond_IsOnFloor。IsMoving: 判断角色是否有水平输入。重命名为Cond_IsMoving。VelocityYNegative: 判断垂直速度是否向上跳跃。重命名为Cond_Jumping。VelocityYPositive: 判断垂直速度是否向下下落。重命名为Cond_Falling。这些BoolCondition节点需要脚本来提供实际的布尔值。我们需要编写一个附着在StateMachine节点上的脚本来更新这些条件。在StateMachine节点上附加一个新脚本命名为player_state_machine.gdextends Node2D # 注意我们之前将StateMachine的类型改为了Node2D onready var bool_is_on_floor: BoolCondition $Cond_IsOnFloor onready var bool_is_moving: BoolCondition $Cond_IsMoving onready var bool_is_jumping: BoolCondition $Cond_Jumping onready var bool_is_falling: BoolCondition $Cond_Falling var player: CharacterBody2D func _ready() - void: player get_parent() as CharacterBody2D if not player: push_error(StateMachine 的父节点不是 CharacterBody2D!) # 初始化条件节点的“检查函数” bool_is_on_floor.check_func is_on_floor_check bool_is_moving.check_func is_moving_check bool_is_jumping.check_func is_jumping_check bool_is_falling.check_func is_falling_check func is_on_floor_check() - bool: return player.is_on_floor() if player else false func is_moving_check() - bool: # 假设我们通过一个 input_direction 向量来获取输入 return abs(player.input_direction.x) 0.1 if player else false func is_jumping_check() - bool: return player.velocity.y 0 if player else false # 向上速度为负 func is_falling_check() - bool: return player.velocity.y 0 and not player.is_on_floor() if player else false # 向下速度为正且不在地面这里我们通过将每个BoolCondition节点的check_func属性绑定到一个返回布尔值的函数上来动态更新条件。第二步创建转换资源。转换资源.tres将状态和条件联系起来。例如我们需要一个从“待机Idle”到“奔跑Run”的转换。新建一个YTransition资源命名为trans_idle_to_run.tres。将其To State属性设置为run_state.tres。关键属性Conditions。这是一个条件节点路径的数组。我们需要点击编辑然后添加我们之前创建的条件节点路径例如../Cond_IsMoving因为条件节点是状态机的子节点在资源中引用需要使用相对路径。这意味着当Cond_IsMoving条件为true时这个转换就会被触发。类似地我们需要创建其他转换trans_run_to_idle.tres:To Stateidle_state.tres,Conditions[../Cond_IsMoving]但这里我们需要Cond_IsMoving为false。BoolCondition节点本身有一个Is Not复选框可以反转逻辑。所以我们可以创建另一个条件节点Cond_IsNotMoving其check_func返回!is_moving_check()或者直接使用Cond_IsMoving并在转换逻辑中处理反转YTransition资源可能支持条件反转需查看具体文档或源码这里假设我们创建新节点。trans_any_to_jump.tres: 从任何状态跳转到“跳跃”状态。通常跳跃由按键触发我们可以创建一个Cond_JumpPressed条件节点其check_func检查跳跃键是否刚按下。然后将此转换资源的From State留空或设置为*代表任何状态To Statejump_state.tres,Conditions[../Cond_JumpPressed]。trans_jump_to_fall.tres: 跳跃到下落。To Statefall_state.tres,Conditions[../Cond_Falling]。trans_fall_to_idle.tres: 下落到待机落地。To Stateidle_state.tres,Conditions[../Cond_IsOnFloor]。trans_fall_to_run.tres: 下落到奔跑落地且正在移动。To Staterun_state.tres,Conditions[../Cond_IsOnFloor, ../Cond_IsMoving]。第三步将转换分配给状态。最后一步回到状态资源。例如打开idle_state.tres找到Transitions属性可能叫Out Transitions或类似名称这是一个转换资源的数组。将trans_idle_to_run.tres和trans_any_to_jump.tres如果跳跃是全局的添加进去。这意味着当处于 Idle 状态时状态机会检查这两个转换的条件是否满足。为run_state.tres添加trans_run_to_idle.tres和trans_any_to_jump.tres。 为jump_state.tres添加trans_jump_to_fall.tres。 为fall_state.tres添加trans_fall_to_idle.tres和trans_fall_to_run.tres。至此一个基础的角色状态机框架就搭建完成了。当游戏运行时StateMachine节点会自动轮询当前活跃状态所关联的所有转换条件并在条件满足时切换到目标状态。4. 深入核心状态逻辑的实现与交互框架搭好了但状态本身还没任何行为。我们需要在状态脚本中实现具体的逻辑比如播放动画、应用移动物理、处理输入等。4.1 在状态脚本中访问所属实体状态脚本如player_state.gd需要能够影响它所属的角色。gd-YAFSM的状态基类YState提供了一个state_machine属性通过它可以访问到StateMachine节点进而访问到角色的根节点。修改player_state.gd添加一个便捷属性extends YState class_name PlayerState # 获取状态机节点 var fsm: StateMachine: get: return state_machine as StateMachine # 通过状态机获取父节点即我们的Player角色 var player: CharacterBody2D: get: if fsm and is_instance_valid(fsm.get_parent()): return fsm.get_parent() as CharacterBody2D return null现在在enter,exit,physics_update,update函数中我们都可以通过self.player来访问和操作角色。4.2 实现具体状态行为让我们丰富player_state.gd并为不同状态添加差异化逻辑。我们可以使用match语句根据状态名来区分行为但更好的做法是利用 Godot 的继承或“脚本类”。这里为了演示我们先在一个脚本内用match实现func enter(_msg: {}) - void: if not player: return match name: Idle: player.velocity.x 0 player.play_animation(idle) Run: player.play_animation(run) Jump: player.velocity.y player.jump_velocity # 假设jump_velocity是Player的一个负值属性 player.play_animation(jump_start) Fall: player.play_animation(fall) print(进入状态: , name) func physics_update(delta: float) - void: if not player: return # 公共物理逻辑例如重力 player.velocity.y player.gravity * delta match name: Idle: # 待机状态可能只需要处理滑行停止 player.velocity.x move_toward(player.velocity.x, 0, player.friction) Run: # 奔跑状态处理水平移动 var input_dir Input.get_vector(move_left, move_right, move_up, move_down) player.velocity.x input_dir.x * player.run_speed # 可能还需要处理转身逻辑 if input_dir.x ! 0: player.sprite.flip_h input_dir.x 0 Jump, Fall: # 跳跃和下落状态都允许水平控制但可能加速度不同 var input_dir Input.get_vector(move_left, move_right, move_up, move_down) var air_accel player.air_acceleration if name Jump else player.fall_acceleration player.velocity.x move_toward(player.velocity.x, input_dir.x * player.run_speed, air_accel * delta) if input_dir.x ! 0: player.sprite.flip_h input_dir.x 0 player.move_and_slide() func update(_delta: float) - void: # 处理一些每帧更新但不涉及物理的逻辑比如动画过渡 pass func exit() - void: print(退出状态: , name) # 退出状态时可能需要清理一些临时效果在实际项目中player对象应该提供诸如play_animation()、apply_gravity()、get_input()等方法状态脚本主要调用这些接口保持状态逻辑的整洁。4.3 状态间传递消息有时从一个状态切换到另一个状态时需要传递一些数据。例如从“受伤”状态退出时可能需要知道伤害来源的方向以便播放正确的被击退动画。gd-YAFSM的enter()函数接受一个可选的msg参数字典。在触发转换的代码中可能是在条件节点的检查函数里或者在其他系统如伤害系统中你可以调用状态机的transition_to(state_name, msg)方法具体方法名需查看插件API。在目标状态的enter(msg)方法里你就可以解析这个字典获取需要的信息。例如在hurt_state.gd的enter方法中func enter(msg: {}) - void: var damage_source_direction: Vector2 msg.get(direction, Vector2.RIGHT) # 根据击退方向播放动画或应用力 player.apply_knockback(damage_source_direction)4.4 层级状态机与并行状态机对于更复杂的角色比如既能在地上跑又能游泳同时还能使用武器简单的平面状态机可能不够用。gd-YAFSM支持更高级的概念层级状态机一个状态本身可以包含一个子状态机。例如你可以有一个“移动Locomotion”顶层状态它内部包含“地面移动”和“空中移动”子状态机而“地面移动”子状态机又包含“待机”、“行走”、“奔跑”等状态。这有助于将相关的状态逻辑分组减少转换的复杂度。并行状态机多个状态机可以同时运行在同一个实体上。例如一个状态机控制角色的移动待机、跑、跳另一个独立的状态机控制角色的表情或嘴部动画中性、说话、微笑。它们互不干扰共同决定角色的最终表现。实现这些高级功能通常需要在设计状态资源时进行更复杂的配置可能涉及将StateMachine节点作为另一个状态的子节点。gd-YAFSM的文档和示例项目中通常会有相关的演示。5. 调试、优化与常见问题排查使用任何框架调试能力都至关重要。gd-YAFSM提供了一些内置的调试支持结合 Godot 自身的工具可以有效地排查状态机问题。5.1 利用内置调试功能在StateMachine节点的检查器中启用Debug属性。运行游戏后你可以在场景树中选中StateMachine节点在 Godot 编辑器的“调试器”面板或“远程”视图中看到当前活跃的状态名。一些插件版本甚至会在游戏窗口上叠加显示当前状态这对于快速验证状态转换是否正确非常有用。你可以在状态脚本的enter和exit函数中加入print()语句这是最直接的调试方式。确保你能看到符合预期的状态切换日志。5.2 常见问题与解决方案以下是我在项目中使用gd-YAFSM时遇到的一些典型问题及解决方法问题1状态转换没有发生。检查点1条件节点路径是否正确。在转换资源.tres中Conditions数组里填写的节点路径必须是正确的相对路径从状态机节点出发。在编辑器中你可以将条件节点从场景树拖拽到转换资源的属性栏Godot 会自动生成正确路径。检查点2条件节点的check_func是否被正确赋值。确保在你的状态机控制器脚本如player_state_machine.gd的_ready()函数中已经将所有BoolCondition节点的check_func绑定到了对应的函数。如果check_func是null条件永远为false。检查点3条件逻辑是否正确。在check_func绑定的函数内部打印返回值确认在预期情况下它返回了true。注意BoolCondition的Is Not复选框是否被误勾选。检查点4转换是否被添加到了正确的状态上。确认你创建的转换资源如trans_idle_to_run.tres被添加到了源状态idle_state.tres的Transitions列表中。问题2进入状态时player变量为null。原因状态脚本的enter()方法可能在_ready()之前就被调用了此时state_machine引用可能尚未就绪或者获取父节点的逻辑有问题。解决在player属性的 getter 中增加空值检查或者将需要player的逻辑移到physics_update或update中因为这些函数在状态进入后的每一帧都会被调用此时引用通常已准备就绪。另一种方法是在状态机的_ready()中显式地初始化所有状态对状态机的引用如果插件支持。问题3性能开销。分析状态机本身开销极低。主要开销来自于每帧对所有活跃转换的条件进行检查。如果条件检查函数非常复杂例如进行了大量的物理查询或计算可能会成为瓶颈。优化缓存结果对于计算成本高的条件可以在状态机控制器脚本的_process或_physics_process中计算一次然后将结果存储在一个成员变量中条件节点的check_func直接返回这个缓存值。减少条件数量审视状态设计是否可以通过更简洁的状态划分来减少转换和条件的数量。使用更高效的条件类型gd-YAFSM可能提供了ExpressionCondition表达式条件允许你在编辑器中直接编写 GDScript 表达式。虽然方便但解释执行可能比编译好的函数稍慢。对于性能关键处使用BoolCondition并绑定到优化过的函数是更好的选择。问题4与 Godot 4 新特性的兼容性。gd-YAFSM是为 Godot 4 设计的通常兼容性良好。但需要注意GDScript 2.0 语法确保你的脚本使用正确的 GDScript 2.0 语法如onready注解、强类型声明等。信号与回调状态基类YState提供的enter,exit,update,physics_update都是虚函数确保正确使用override关键字如果插件基类使用了virtual或直接定义。资源唯一ID在 Godot 4 中.tres资源文件管理要小心。重命名或移动资源文件有时会导致场景中引用丢失需要重新指定。5.3 扩展创建自定义条件内置的BoolCondition很常用但有时你需要更复杂的判断逻辑比如“距离小于某个值”、“冷却时间结束”等。你可以轻松创建自定义条件。创建一个继承自YCondition或Condition具体类名需查看插件的新脚本例如distance_condition.gd。在这个脚本中你需要实现一个is_triggered()方法返回一个布尔值。将这个脚本附加到一个普通的Node上然后将这个节点作为StateMachine的子节点。在转换资源中将这个自定义条件节点的路径添加到Conditions列表。# distance_condition.gd extends YCondition # 请根据插件实际基类名调整 class_name DistanceCondition export var target_path: NodePath export var max_distance: float 100.0 var _target: Node2D func _ready() - void: if target_path: _target get_node(target_path) as Node2D func is_triggered() - bool: if not _target or not state_machine: return false var fsm_pos (state_machine as Node2D).global_position var target_pos _target.global_position return fsm_pos.distance_to(target_pos) max_distance这样你就可以在编辑器中配置这个条件的目标节点和最大距离实现一个可复用的距离条件。6. 项目实战构建一个简单的敌人AI状态机为了更全面地展示gd-YAFSM的能力我们用它来实现一个简单的巡逻-追击-攻击的敌人AI。设计状态Patrol巡逻在预设点之间移动。Chase追击当玩家进入警戒范围时朝玩家移动。Attack攻击当玩家进入攻击范围时执行攻击动作。Hurt受伤被玩家攻击时进入短暂硬直。Die死亡生命值归零时播放死亡动画并禁用。实现要点状态机节点附加在敌人场景的根节点下。条件节点Cond_PlayerInSight使用RayCast2D或区域Area2D判断玩家是否在视野内且无遮挡。Cond_PlayerInAttackRange判断与玩家的距离是否小于攻击距离。Cond_IsHealthZero判断生命值是否为零。Cond_HurtTimerExpired一个计时器条件受伤状态持续一段时间后自动退出。转换Patrol - Chase:Cond_PlayerInSight为真。Chase - Attack:Cond_PlayerInAttackRange为真。Attack - Chase:Cond_PlayerInAttackRange为假玩家跑出范围。Chase - Patrol:Cond_PlayerInSight为假玩家丢失。(Any) - Hurt: 当受到伤害时通过代码调用状态机的transition_to(“Hurt”)并传递伤害信息。Hurt - (Previous):Cond_HurtTimerExpired为真状态机可以设计为返回之前的状态。(Any) - Die:Cond_IsHealthZero为真。状态逻辑PatrolState: 在physics_update中沿着路径点移动。ChaseState: 在physics_update中计算朝向玩家的方向并移动。AttackState: 在enter中播放攻击动画并触发伤害检测在physics_update中可能停止移动。通过动画帧事件或计时器在攻击结束后自动触发转换回Chase。HurtState: 在enter中播放受击动画、应用击退、设置一个定时器用于Cond_HurtTimerExpired并短暂无敌。DieState: 在enter中播放死亡动画、禁用碰撞体、计划后续的节点队列释放。通过这个例子你可以看到gd-YAFSM如何清晰地组织一个拥有多个状态和复杂转换规则的 AI 逻辑。所有状态和转换都在编辑器中可配置行为逻辑封装在各自的状态脚本中使得整个 AI 系统模块化程度高易于阅读、调试和扩展。最后一点个人体会gd-YAFSM可能不是功能最强大的状态机插件但它“刚刚好”的设计与 Godot 引擎的契合度非常高。它强迫你以资源化的方式思考状态这起初会增加一些学习成本但长期来看这种数据与逻辑的分离让调整游戏手感比如修改状态转换条件、动画名称变得异常轻松——你甚至可以让策划或美术同学在编辑器中微调部分参数而无需触碰代码。对于中小型 Godot 项目来说它是一个能显著提升开发效率和代码质量的选择。刚开始使用时建议从一个小型、具体的状态机比如一个门的状态关闭、打开中、打开、关闭中开始实践熟悉整个工作流后再应用到复杂的角色或系统上会顺畅很多。
相关文章
对比自行维护多个 API 密钥，使用 Taotoken 在管理上轻松许多
🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度 对比自行维护多个 API 密钥，使用 Taotoken 在管理上轻松许多 作为一名个人开发者，我曾长期在多个大模型服务…
Floquet量子码的动态纠错与时空同步技术解析
1. Floquet量子码的时空同步原理在量子纠错领域，Floquet码代表了一种通过周期性测量实现动态稳定的新型编码方案。与传统静态量子纠错码不同，Floquet码的核心创新在于将时间维度纳入编码结构，形成时空一体的纠错机制。这种动态特性使其在容错…
Cursor Pro终极破解教程：三步免费解锁AI编程助手完整指南
Cursor Pro终极破解教程：三步免费解锁AI编程助手完整指南 【免费下载链接】cursor-free-vip [Support 0.45]（Multi Language 多语言）自动注册 Cursor Ai ，自动重置机器ID ， 免费升级使用Pro 功能: Youve reached your …
探秘游戏安全：驱动级防护与图标守护的开源宝藏
探秘游戏安全：驱动级防护与图标守护的开源宝藏 【下载地址】驱动保护进程与游戏破图标技术实现代码 驱动保护进程与游戏破图标技术实现代码 项目地址: https://gitcode.com/open-source-toolkit/beb83 随着电子竞技的兴起和游戏产业的繁荣，游戏安…
【亲测免费】 探索卷积神经网络之美：一键绘制专业结构图的利器
探索卷积神经网络之美：一键绘制专业结构图的利器 【下载地址】卷积神经网络结构绘制工具 本资源适用于需要展示卷积神经网络具体结构的研究人员。用户下载本项目后，按照README官方教程中的“Getting Started”部分进行操作，简单学习语法后即可…
SillyTavern角色卡片系统：从图片到智能伙伴的魔法之旅
SillyTavern角色卡片系统：从图片到智能伙伴的魔法之旅 【免费下载链接】SillyTavern LLM Frontend for Power Users. 项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern 你是否曾想过，一张普通的图片如何能变成一个会思考、会对话、…
【亲测免费】 探索海洋奥秘：Trash-ICRA19 Dataset——海洋目标检测的利器
探索海洋奥秘：Trash-ICRA19 Dataset——海洋目标检测的利器 【下载地址】海洋目标检测数据集-Trash-ICRA19Dataset 本资源文件提供了一个用于海洋水下目标检测的数据集，名为Trash-ICRA19 Dataset。该数据集包含1144张图片及其对应的标签，适用…
强大的CRC校验工具：保障数据完整性的利器
强大的CRC校验工具：保障数据完整性的利器 【下载地址】QT制作CRC校验工具和源码 本仓库提供了一个使用QT框架制作的CRC校验工具及其源码。CRC（循环冗余校验）是一种常用的数据校验方法，广泛应用于数据传输和存储中，以确…
【亲测免费】 中文停用词表集合：提升文本处理效率的利器
中文停用词表集合：提升文本处理效率的利器 【下载地址】中文停用词表集合分享 中文停用词表集合本仓库汇总了五个广泛应用于中文文本处理的停用词表，旨在为语言分析、文本挖掘和自然语言处理(NLP)领域的研究者及开发者提供便利 项目地址: https://gitc…
5分钟快速上手：biliTickerBuy开源工具助你轻松抢购B站会员购热门票务
5分钟快速上手：biliTickerBuy开源工具助你轻松抢购B站会员购热门票务 【免费下载链接】biliTickerBuy b站会员购购票辅助工具 项目地址: https://gitcode.com/GitHub_Trending/bi/biliTickerBuy biliTickerBuy是一款专为B站会员购平台设计的开源辅助工具&…
一口气讲清楚 Monorepo、Turborepo、pnpm、Changesets 到底是什么？
你肯定遇到过这种情况：项目里同时有前端、后端、公共组件，放在一个仓库嫌乱，拆成多个仓库又改一个公共函数要在五个项目里各改一遍。于是出现了 Monorepo、Turborepo、pnpm、Changesets 这四个词。它们不是互相替代，而是分别解决工…
从ok-skills项目解析技能树：设计理念、技术实现与工程实践
1. 项目概述与核心价值最近在GitHub上看到一个挺有意思的项目，叫“ok-skills”。光看这个名字，可能有点摸不着头脑，但点进去一看，发现这是一个关于“技能树”或“知识图谱”的开源项目。简单来说，它试图用一种结构化的…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…