Serious game pour apprendre à coder en Python (une aventure à coder sur Mars)
Go to file
Philippe Roy 790d846c00 Restructuration des documents pédagogiques 2024-01-22 04:26:30 +01:00
asset Ajout d'assets KayKit et Kenney 2024-01-22 01:50:01 +01:00
img Migration de Forge AEIF -> Forge Apps.education 2024-01-22 03:43:05 +01:00
twins Détection automatique de la carte sur le port série : microbit, uno et mega 2022-11-26 05:26:32 +01:00
LICENSE Ajout de LICENSE 2023-02-08 17:27:05 +00:00
README.md Restructuration des documents pédagogiques 2024-01-22 04:26:30 +01:00
ropy-34.blend Mise en place des instructions de scriptage 2024-01-01 16:47:53 +01:00
ropy-35.blend Readme update 2024-01-09 12:16:03 +01:00
ropy.bat Ajout de la vérification du code Python 2022-12-06 03:48:40 +01:00
ropy.sh Ajout du script shell 2023-02-16 02:23:00 +01:00
ropy.svg Ajout de l'icone de l'application 2022-11-26 01:40:34 +01:00
rp.py Bugfix : Overlay et crédit du store 2024-01-01 22:04:43 +01:00
rp_about.py Migration de Forge AEIF -> Forge Apps.education 2024-01-22 03:48:29 +01:00
rp_cmd-bak.py Déplacement du rp_fin(), décor : cratères 2023-12-28 19:07:02 +01:00
rp_cmd.py Bugfix sur l'icone du script 2024-01-02 11:37:28 +01:00
rp_config-bak.xml Update configuration 2023-02-16 11:59:54 +01:00
rp_config.xml Bugfix sur l'icone du script 2024-01-02 11:37:28 +01:00
rp_doc.py Bugfix : mise en couleur 2024-01-02 06:45:17 +01:00
rp_file_qt.py Mise à jour des credits 2024-01-04 10:33:01 +01:00
rp_file_wx.py Transport du fichier de configuration dans le répertoire de travail 2023-02-06 14:40:00 +01:00
rp_lib.py Bugfix : mise en couleur 2024-01-02 06:45:17 +01:00
rp_map1.py Bugfix : mise en couleur 2024-01-02 06:45:17 +01:00
rp_pylint.py Bugfix : inspection du code par astroid, affichage du feuillage et affichage des forages 2023-12-28 17:00:24 +01:00
rp_store.py Bugfix : Overlay et crédit du store 2024-01-01 22:04:43 +01:00

README.md

Ropy

Découvre le Python avec Ropy (code ton aventure)

Ropy est un rover martien qui se programme en Python. Les aventures de Ropy permettent la découverte de la programmation procédurale et du language Python. A travers les différents missions, donc de manière graduée, les élèves vont apprendre à manipuler les structures algorithmiques et à les coder en Python.

Ropy présentation

Poster

Ropy a fortement été inpiré par RobotProg et Light Bot.

Téléchargement

Les binaires (Game Engine Runtime) sont hébergés sur phroy.org.

Instructions et missions

Le script Python qui permet la commande du robot est le fichier 'rp_cmd.py'. Il est éditable avec tout éditeur (Spyder, Emacs, Pulsar, ...).

Les instructions de base sont :

  • Avancer : rp_avancer()
  • Reculer : rp_reculer()
  • Tourner à gauche : rp_gauche()
  • Tourner à droite : rp_droite()
  • Marquer la case : rp_marquer()
  • Détecter la présence d'un mur devant à un pas : rp_detect() -> retourne True en présence d'un mur et False en absence de mur

Il y a 6 missions :

  • Mission 1 : Les premiers pas de Ropy
  • Mission 2 : Ma première fonction
  • Mission 3 : Sécuriser Ropy
  • Mission 4 : Partir au bout du monde
  • Mission 5 : Faire face à l'inconnu
  • Mission 6 : Se rendre utile

Du niveau 1 au niveau 5, chaque niveau donne lieu à la découverte d'une nouvelle structure algorithmique. Le niveau 6 correspond à la mission principale, il faudra mobiliser l'ensemble de structures vues précédement.

Par son interface sur le port série, Ropy peut devenir le jumeau numérique d'un robot réel. Trois missions sont proposées sur son jumelage avec le robot Maqueen (carte micro:bit) présentes dans les documents pédagogiques.

Deux vidéos :

Ressources pédagogiques

Les applications pédagogique se trouvent dans le dépôt des ressources pédagogiques du projet Blender-EduTech :

Ropy est une plateforme pédagogique où d'autres missions pouvent être dévelopées pour mettre en oeuvre des concepts comme la programmation objet, le multithreading ou encore le machine learning.

Développement

Les fichiers sources sont dans le projet Blender-Edutech / Ropy de La Forge des Communs Numériques Éducatifs : https://forge.apps.education.fr/blender-edutech/ropy .
 
L'environnement de développement est basé sur : la plateforme de modélisation et d'animation 3D [Blender](https://blender.org), le moteur de jeu 3D [UPBGE](https://upbge.org) et le langage [Python](https://python.org).
 
La version de Blender/UPBGE utilisée pour le développement est la version 0.36.1 (20 août 2023). Etant trop lente sous Windows, la version utilisée pour le déploiement (mise en production) est la version 0.30 (3 décembre 2021).

Les bibliothèques suivantes ne sont pas incluses par défaut dans l'environnement UPBGE :

  • Pylint : vérificateur du code Python
  • pySerial : communication sur le port série
  • pyFirmata : protocole Firmata (protocole générique de communication entre un logiciel et un microcontrôleur)
  • wxPython : interface graphique utilisateur (GUI, utilisé ici pour Windows)
  • pyQt6 : interface graphique utilisateur (GUI, utilisé ici pour GNU/Linux)

Il faut donc les installer localement (dans UPBGE), les étapes sont :

  • GNU/Linux : La configuration ici présente est UPBGE installé sur ~ avec Python 3.10 :

    • Aller dans le répertoire local de Python de UPBGE: $ cd ~/upbge-0.36.1-linux-x86_64/3.6/python/bin
    • Télécharger le script 'get-pip.py' pour installer le gestionnaire de paquet Pip
    • Installer le gestionnaire de paquet Pip : $ ./python3.10 get-pip.py
    • Installer Pylint : $ ./pip install pylint
    • Installer pySerial : $ ./pip install pyserial
    • Installer pyFirmata : $ ./pip install pyfirmata
    • Installer PyQt6 : $ ./pip install PyQt6
  • Windows : La configuration ici présente est UPBGE installé sur le bureau utilisateur (prenom.nom) :

    • Ouvrir un terminal Powershell (éventuellement en passant par Anaconda Navigator)
    • Aller dans le répertoire local de Python de UPBGE: cd C:\Users\prenom.nom\Desktop\upbge-0.36.1-windows-x86_64\3.6\python\bin
    • Télécharger le script 'get-pip.py' pour installer le gestionnaire de paquet Pip
    • Installer le gestionnaire de paquet Pip : python.exe get-pip.py
    • Aller dans le répertoire 'Scripts' : cd C:\Users\prenom.nom\Desktop\upbge-0.36.1-windows-x86_64\3.6\python\Scripts
    • Installer Pylint : pip.exe install pylint
    • Installer pySerial : pip.exe install pyserial
    • Installer pyFirmata : pip.exe install pyfirmata
    • Installer wxPython : pip.exe install wxpython
  • Si l'installation des paquets Python ne se fait pas dans le bon répertoire ('site-packages' des bibliothèques du Python embarqué par UPBGE), il faut allors spécifier le répertoire cible avec l'option '-t target' lors de la commande 'pip install'. Par exemple pour Pylint :

    • GNU/Linux : $ ./pip install pylint -t ~/upbge-0.36.1-linux-x86_64/3.6/python/lib/python3.10/site-packages
    • Windows : $ pip.exe install pylint -t C:\Users\prenom.nom\Desktop\upbge-0.36.1-windows-x86_64\3.6\python\lib\site-packages