How to use#
Prerequisites#
Ensure you have Python 3.12 or higher installed on your system.
Download or clone the project code (check the GitHub repository).
Running the game#
Open a terminal and navigate to the folder on your computer containing the code. Then, type in the following command:
python3 main.py <level_name.in>
replacing <level_name.in> with the file name of the level you wish to load.
For example, here is how to load the file level1.in:
python3 main.py level1.in
You can find more levels inside the levels folder.
Once you open a level, you should be greeted with a screen like this:
🧱🧱🧱🧱🧱🧱🧱🧱
🧱🪹🪹🟩🥚🥚🥚🧱
🧱🧱🪹🟩🟩🪹🪹🧱
🧱🧱🧱🧱🧱🧱🧱🧱
Previous moves:
Remaining moves: 10
Points: 0
Choices: L = left, R = right, F = forwards, B = backwards
Input one or more moves:
As the prompt suggests, input one or more moves, then press ENTER. The game will then process your moves, automatically detecting valid moves (L/R/F/B) and ignoring invalid characters.
You should see the display update and show the eggs moving accordingly. After that is finished, your screen should once again update:
🧱🧱🧱🧱🧱🧱🧱🧱
🧱🪹🪺🥚🥚🟩🟩🧱
🧱🧱🪹🟩🟩🪹🪹🧱
🧱🧱🧱🧱🧱🧱🧱🧱
Previous moves: ←
Remaining moves: 9
Points: 20
Choices: L = left, R = right, F = forwards, B = backwards
Input one or more moves:
Your previous move history and the number of points you have earned will be shown on screen.
The game continues until you have exhausted all your moves, or all the eggs on screen have been consumed.
If you wish to exit the game, simply press Ctrl+C.
Good luck and have fun!
Leaderboard#
Once you finish the game, you are given the option to save your score into the leaderboard:
🧱🧱🧱🧱🧱🧱🧱🧱
🧱🪹🪺🟩🟩🟩🟩🧱
🧱🧱🪺🟩🟩🪺🪹🧱
🧱🧱🧱🧱🧱🧱🧱🧱
Previous moves: ← ↓ ← → ↑
No more eggs are left! Thanks for playing.
Your final score is: 55
Congrats! Your score made it to the leaderboard.
Please input your name (or leave it empty to cancel): Louie
New leaderboard:
1. Louie 55
Simply input your name and your score will be saved in a file named <level_name>_leaderboards.in.