Implementing a Game Engine

Game engines currently run along with the Laink server, in the same process, and so (for now) must be written in Ruby. See domohnoes.rb for an example game.

In the future these should move to a separate process using the same communication framework, turning the server into a lightweight broker for setting up games. This will require games to support n reader threads for n players, instead of the server doing this.

To add a new game type supported by the server:

1. require the gametype.rb file.

2. Create a new class that subclasses Laink::GameType.

3. Add the required method calls:

    gametype "com.danceliquid.domohnoes" # The unique signature identifying this game type
    name     "Domohnoes"                 # A nice name for your game
    players  2..4                        # The number of players supported (may be an integer or range)
   

4. [optional] Provide an initialize method that calls super().

5. [optional] Provide a start method that calls super().

6. Provide a current_player method that returns the appropriate item from the players array

7. Provide a state method that, given a player from the players array, returns an object that supports to_json and describes everything a player would need to know to make a move. (And nothing they shouldn't know!)

8. Provide a handle_message(message,player) method that either processes the message or calls super. Most important, be able to handle {"command":"move"} messages.

9. Call finish_game(winning_player) on the superclass when the game is over.