queer-frogs / froggy-and-frankie-take-a-nice-walk

Educative game made for teaching python loops to beginners.
3 stars 0 forks source link
education game loops loops-and-iterations python teaching teaching-materials

Froggy and Frankie take a nice walk

What is it ?

Froggy and Frankie take a nice walk is an educative game, made for teaching Python loops to beginners. Contrary to most coding games, the player controls its avatar using his keyboard arrows. The code they produce allow them to modify their environment (e.g. by building bridges). It was originally made during a university project by three UTC (Université de Technologie de Compiègne) students. If you can read french, the full report is the docs/report folder. You can also read (in english) the full technical documentation available in the docs/build folder.

How does it work ?

The game is coded in Python, using mainly arcade (for the regular game window) and kivy (for the code input). Having the game run in python makes it easier to run the code injected by the user. For details, see the technical documentation (href missing).

Project status

The project is no longer in development. However, anyone can contribute to it ! Please feel free to contact us if you want to know how to get started.

Installation

To start with, clone the repository :

git clone https://github.com/TX-INF1/game

Make sure you have python >= 3.11 configured as your interpreter, and install all the requirements for the project :

pip install -r requirements_win_linux.txt
pip install -r requirements_macos.txt

Credits

Special thanks to Domitile Lourdeaux, our teacher, for her essential support and advice throughout the whole project.