IN DEVELOPMENT, NO ANY VERSION FOR USE

---

The FSM plugin for Defold to describe states like Playmaker in Unity with predefined actions

Features

Defold Adam has next features:

• Powerful Finite State Machine to describe any behaviour you want
• Easy to start: A lot of predefined actions with good API reference and annotations
• Enough for game: Ability to build any game logic just via state machine (like Playmaker and Bolt in Unity)
• Rich features: reusable action templates and nested FSM
• Comfort: Any action describes in one line of code. It provides fast developing, easy reading and less bugs
• Performance: Good performance even with a lot of instances of FSM
• Visual Editor: not provided now, but who knows?
• Code as Data: Ability to load your FSM as JSON (from resources, from web, etc). Need visual editor to make it :)

Setup

Dependency

You can use the Defold-Adam extension in your own project by adding this project as a Defold library dependency. Open your game.project file and in the dependencies field under project add:

https://github.com/Insality/defold-adam/archive/master.zip

Or point to the ZIP file of a specific release.

Basic usage

To use Adam, you should do next:

• Describe your states with actions via create State instances: adam.state

• Describe transitions between states via create Adam instances: adam.new

The basic code looks like this:

local adam = require("adam.adam")
local actions = require("adam.actions")

function init(self)
    -- Empty state
    local initial = adam.state()

    -- The state with one instant action
    local hello = adam.state(
        actions.debug.print("Hello guys")
    )

    -- The Adam instance itself
    self.adam = adam.new(initial,
        {
            {initial, hello, adam.FINISHED}  -- Third parameter is optional, it's adam.FINISHED by default
        }
    )
    self.adam:start()
end

function final(self)
	self.adam:final() --- The final call is important!
end

function update(self, dt)
	self.adam:update(dt) --- The update call is important!
end

Custom actions

Short description how to create your custom actions and how to use it in code. Full instruction in other document

Learn more

• Core Concepts && Glossary
• States
• Events
• Actions
• Variables
• Custom Actions
• Template Actions
• Nested State Machines
• JSON representation
• EmmyLua annotations
• Performance
• Usage examples
• FAQ
• Tips

Examples

List of created examples and their code from /examples

License

Developed and supported by Insality

---

Used libraries:

• lua-fsm
• middleclass

Issues and suggestions

If you have any issues, questions or suggestions please create an issue or contact me: insality@gmail.com