calico's Introduction

calico

A simple reverse inheritance state machine library for gamemaker

It has a simple api to create simple state machines:

state = calico_create()

calico_mutate_state(state, "addition")
calico_mutate_on(state, "addition", "run", function () {
   frame++
})

calico_mutate_state(state, "subtract")
calico_mutate_on(state, "subtract", "run", function () {
   frame--
})

calico_change(state, "addition")
calico_run(state, "run")

calico_change(state, "subtract")
calico_run(state, "run")

Alternatively, create a template:

template = calico_template()
.init("addition")
.state("addition").add({
   run: function() {
      frame++
   },
})
.state("subtract").add({
   run: function() {
      frame++
   },
})

state = calico_create(template)

And if you need it, utilize the unique reverse inheritance model:

template = calico_template()
.state("top").add({
   run: function (_) {
      calico_child(_) // delegates to a child
      show_debug_message("top")
   },
})
   .child("bottom").add({
      run: function () {
         show_debug_message("bottom")
      },
   })

state = calico_create(template)

calico_change(state, "top")
calico_run(state, "run") // only prints "top"

calico_change(state, "bottom")
calico_run(state, "run") // prints "bottom", then "top"

Check the documentation for more details.

calico's People

Contributors

Stargazers

Watchers

calico's Issues

time tracking

A way to check how long a state has been visited.

calico_time(machine) // returns total frames the machine has been running
calico_time_state(machine) // returns total frames the state has been running

sequence states

A way to sequence a timeline of state changes.

api idea:

timeline = calico_timeline()
   .next("state1")
   .next("state2", 20) // timer
   .run(function () {})
   .next("state3")

calico_change(machine, timeline)

history

A way to track the last few states that have been visited.

calico_mutate_history_enable(machine, bool)
calico_mutate_history_length(machine, length)
calico_mutate_history(machine, index, replacement)
calico_get_history(machine)

Recommend Projects