Describe Fractionauts

[ymoullec]

This issue will be used to discuss the documentation of Fractionauts, a sugar activity (thus coded in Python) that is to be ported to sugarizer (JavaScript).

[ymoullec]

This is what I came up with this morning, I'm not sure this is the right place to put it, I guess we will figure that out along the way.

Principle of the game

The player is presented with 3 fuel tanks containing various amounts of fuel, and a rocket that requires a certain amount of fuel to take off.
They must find a way to fill the rocket by using one or more of the fuel tanks.
If they succeed, they are presented with a success animation of the rocket taking off, then they can start again.
The difficulty increases as the player successfully launches the rocket.

Menus and screens

There is a main menu (screenshot 1), a screen for the actual game (screenshot 2), and an animation screen that pops up when a rocket is successfully launched (screenshot 3). There is also a help screen (screenshot 4) that helps understanding the principle of the game.

[ymoullec]

Player input and Gameplay

The player has a cursor that can be seen on screenshot 2 and 4.
It allows them to navigate the menus by left-clicking on the various buttons and to play the game.
Start redirects the player to the game screen, starting a new game (level 0).
Help redirects to the help screen.
The player can go back to the main menu by clicking the Back button (on the game and help screen).

On the game screen, the player can click on the 3 tanks to empty them and fill the rocket by the same amount.
Clicking an empty tank results in taking back the amount from the rocket back to the tank.
If clicking a tank would result in exceeding a total of 1 fuel unit in the rocket, the action is denied and an appropriate message is displayed in the bottom console (next to the Back button).
Clicking the launch button will result in launching the success animation if the amount of fuel in the rocket is correct.
Otherwise, an appropriate message is displayed in the console and the rocket is emptied and the tanks are refilled.
Clicking the rocket doesn't do anything (I feel like it should empty it and refill the tanks).
Clicking anywhere not specified above (plus the rocket) displays a message telling the player they cannot click there.

The cursor is not visible during the animation. The player exits the animation by left-clicking.
He is then redirected to the game screen, the level is increased by one, the fuel quantities are different, the score increases by 10.

[ghost]

The GitHub web interface notes the mention by @jrtechs of this issue in the corresponding development issue

#17

but I want to also point out that connection explicitly as I'm not sure all notification methods pick it up.

[jrtechs]

A quick note on running. Everything works, but you need to run it with both python2 and pygames for python2

[jrtechs]

quick info

Pertinent Links

• http://wiki.sugarlabs.org/go/Fractionauts
• https://github.com/chrisknepper/Fractionauts
• https://www.pygame.org