Patrón State

El patrón State proporciona a un objeto un objeto de estado independiente para cada modo en el que puede estar. El objeto delega su trabajo en el estado actual, por lo que su comportamiento cambia cuando cambia el estado.

Para unos pocos estados, un enum y un match son suficientes. Cuando cada estado reacciona a varias acciones a su manera, ese match crece con cada estado y cada acción. El patrón State traslada las reglas de cada estado a su propia clase:

# hero_state.gd
@abstract
class_name HeroState
extends RefCounted

@abstract func get_state_name() -> String
@abstract func handle(action: String) -> HeroState

handle() devuelve el siguiente estado: un nuevo objeto de estado al que cambiar, o self para quedarse.

# idle_state.gd
class_name IdleState
extends HeroState

func get_state_name() -> String:
	return "Idle"

func handle(action: String) -> HeroState:
	if action == "run":
		return RunState.new()
	return self

RunState se escribe de la misma manera: su nombre es "Running", y "stop" devuelve IdleState.new(). El héroe, el contexto, conserva el estado actual y le pregunta qué hacer:

# hero.gd
class_name Hero
extends RefCounted

var state: HeroState = IdleState.new()

func handle_action(action: String) -> void:
	var next := state.handle(action)
	if next != state:
		print(state.get_state_name(), " -> ", next.get_state_name())
		state = next

# main.gd
var hero := Hero.new()
for action in ["stop", "run", "run", "stop"]:
	hero.handle_action(action)

Idle -> Running
Running -> Idle

La misma acción significa cosas diferentes en distintos estados: "stop" no hace nada mientras está inactivo y detiene a un héroe que está corriendo. Cada regla reside en la clase de su estado, así que un estado nuevo, como saltar, es una clase nueva.

Los estados devuelven el siguiente estado en lugar de almacenar al héroe. Un estado que mantuviera al héroe mientras el héroe mantiene el estado formaría un ciclo de referencias, y ninguno de los dos objetos se liberaría nunca.