Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Describe Fractionauts #9

Open
ymoullec opened this issue Apr 16, 2020 · 5 comments
Open

Describe Fractionauts #9

ymoullec opened this issue Apr 16, 2020 · 5 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@ymoullec
Copy link
Collaborator

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 ymoullec added the documentation Improvements or additions to documentation label Apr 16, 2020
@ymoullec
Copy link
Collaborator Author

ymoullec commented Apr 16, 2020

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.

main-menu
game-screen
success-screen
help-screen

@ymoullec
Copy link
Collaborator Author

ymoullec commented Apr 17, 2020

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
Copy link

ghost commented Apr 26, 2020

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
Copy link
Collaborator

jrtechs commented Apr 26, 2020

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

@jrtechs
Copy link
Collaborator

jrtechs commented Apr 26, 2020

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants