@medieval/martingale v1.0.2

Martingale: the control is in your hands

🤨 What is a fsm

A Finite State Machine (FSM) is a computational model used to design and represent the behavior of a system. It is composed of:

• 🚥 States: Distinct modes or configurations that the system can be in. For example, a character in a game might have states like "idle", "walking", "running", etc.
• 🎬 Transitions: Rules or conditions that determine when and how the system changes from one state to another. Transitions are typically triggered by events or conditions being met.
• 🏁 Initial State: The state the system starts in.
• 🎭 Actions: Operations or behaviors that occur when entering, exiting, or updating a state.

Key Characteristics of FSMs:

• 🤨 Deterministic: The next state is determined by the current state and input.
• 🧩 Modular: States and transitions are encapsulated, making it easier to manage complex behaviors.
• 🧠 Predictable: Provides a clear and visual representation of the system's behavior, aiding in debugging and understanding.

Applications:

FSMs are widely used in various fields such as game development, robotics, and software engineering for tasks like:

• 🧩 Controlling game character behavior
• 👨🏻‍💻 Managing user interfaces
• 🕸 Protocol design in communications
• 🤖 Workflow automation

📘 Usage

1. create a fsm

const machine = new FSM();

2. add a state

machine.addState('idle', {
	onEnter: () => console.log('hi'),
	onExit: () => {},
	onUpdate: () => {}
});

3. switch states

machine.changeState('idle');

🎯 Conclusion

And here it is your fully functional fsm, that happens to work really well with Sword⚔️

License

MIT