vudustates's Introduction

VuduStates

Vudu is a simple finite state machine to be used in event driven applications or for game character behavior AI in HTML5 games.

How to use:

put <script src="/path/to/VuduStateMachine.js"></script> at the header of your html page.
Create a state structure that will work with Vudu. example: A simple behavior states for a zombie.

var states = [
    {
        'name': 'idle',
            'initial': true,
        'events': {
            'walkTowardPrey': 'walk',
                'closerToPrey': 'attack', // switch to attack state when prey is close
        }
    },

    {
        'name': 'attack',
            'events': {
            'isWounded': 'scream',
                'zeroHealth': 'die'
        }
    },

    {
        'name': 'scream',
            'events': {
            'closerToPrey': 'attack',
                'zeroHealth': 'die'
        }
    }, 
    {
        'name': 'walk',
            'events': {
            'closerToPrey': 'attack',
                'walk_away': 'walk',
                'isWounded': 'scream',
                'zeroHealth': 'die'
        }
    },

    {
        'name': 'die',
            'events': {
            'removeZombie': 'clear', //clear zombie from scene
        }
    },

    {
        'name': 'clear'
         
    }

];

initialize the state
var zombie = new Vudu.start(states); //the initial state would be set to a Zombie idle state
Run an event that have been declared in states
zombie.event('closerToPrey');
this event will swicth the current state from 'idle' to 'attack'
You confirm which state is running in your javascript console with:
zombie.state(); this will return the name of the current state, so you can use it in your conditionals