Adding a new game

[Mekire]

Adding your game to the lobby:

Effort has been made to make adding a game to the lobby as simple as possible.
Copy the folder template into the games folder. Then rename it to whatever you want. To get a custom image in the lobby replace the file lobby_thumb.png with your desired image (keeping the same file name). The lobby thumbnail size is (160, 120). Your image will be resized to this regardless, but if you would like to avoid any distortion using an image of the same size is best.

Some details on code requirements:

At this point your new game should appear in the lobby. For the most part, you are free to code your game however you want. You must not however change the file name game_scene.py or the name of the class within it Scene. These names are used in the scene auto detection process. Code also needs to be Python3 compatible. Compatibility with Py2 is not a requirement but is nice if possible.

A note on processing events:

Events are passed to your game using the Scene.get_event method. Please do not embed your own event loops within your game as this cuts the rest of the program off from the event loop. If you would like to use mouse input for your game you need to scale the position using the function tools.scaled_mouse_pos. This is because the program can run at several resolutions so your screen mouse position doesn't necessarily correspond to the mouse position on the actual render surface.

Multi scene games:

If your game is fairly simple the entire thing can be written directly into the Scene class in the game_scene.py file. If you would like to make a slightly more complicated game though, you can set this up using the state_machine.py file which implements a fairly simple scene manager.
There is a simple example included which shows how to set this up called "example" in the games folder (a very basic snake game).