Ce projet a été réalisé dans le cadre du cours de programmation orientée objet (POO) et de Methodologie SI, dispensés respectivement par M. HARLE Maxime et M. KALK Antonin.
Membre de l'équipe :
- Quentin BRENNER : Github
Le projet à débuté le 26 mars 2025 et livré le 17 mai 2025. Le planning est divisé en plusieurs étapes, chacune correspondant à une fonctionnalité ou un ensemble de fonctionnalités. Chaque étape est représentée par un milestone dans le diagramme de Gantt prévisionnel ci-dessous.
%%{init: { 'gantt': {'leftPadding': 100} } }%%
gantt
title Planning du développement de Geometry Dash
section Définition <br>du besoin <br> et conception
Modélisation Architecture (Diagramme de classes) :t1, 2025-03-26, 1d
Modélisation du Gameplay (Diagramme d'activités) :t2, 2025-03-26, 1d
Modélisation du Gameplay (Diagramme d'états) :t3, 2025-03-26, 1d
Définition des cas d'utilisation :t4, 2025-03-26, 1d
Milestone 1 - Définition du besoin et conception :crit, milestone,ML1, after t1 t2 t3 t4, 0d
section Menu Principal
Menu Principal :t5, after ML1, 1d
Selection de niveau :t6, after t5, 3d
Options - Editions des touches de jeu :t7, after t5, 4d
Options - Editions des touches de l'éditeur :t8, after t7, 1d
Options - Gestion de l'audio :t9, after t5, 3d
Milestone 2 - Menu principal :crit, milestone,ML2, after t5 t6 t7 t8 t9, 0d
section Niveau
Mode de jeu - Cube :t10, after ML2, 5d
Gestion du niveau, serialisation, deserialisation :t11, after t10, 6d
Gestion des obstacles :t12, after t11, 2d
Mode de jeu - Ship :t13, after t12, 2d
Mode de jeu - Wave :t14, after t12, 2d
Gestion des bonus :t15, after t13 t14, 3d
Milestone 3 - Niveau :crit, milestone,ML3, after t10 t11 t12 t13 t14 t15, 0d
section Statistiques
Statitistiques des niveaux :t16, after ML3, 2d
Statitistiques générales :t17, after ML3, 2d
Milestone 4 - Statistiques :crit, milestone,ML4, after t16 t17, 0d
section Editeur de niveaux
Editeur - Creation de niveau :t18, after ML4, 4d
Editeur - Placement/Gestion des objets :t19, after t18, 2d
Editeur - Gérer les métadonnées du niveau :t20, after t19, 1d
Editeur - Chargement/Export des niveaux :t21, after t20, 2d
Milestone 5 - Editeur de niveaux :crit, milestone,ML5, after t18 t19 t20 t21, 0d
section Intelligence Artificielle
IA - Cube :t22, after ML5, 6d
IA - Ship :t23, after t22, 3d
IA - Wave :t24, after t22, 3d
Milestone 6 - IA :crit, milestone,ML6, after t22 t23 t24, 0d
section Documention et livraison
Rédaction du rapport :t25, after ML6, 1d
Livraison :t26, after ML6, 1d
Milestone 7 - Livraison :crit, milestone, ML7, 2025-05-17, 0d
Le projet est géré par le biais de la section Projects de Github. Ci dessous les liens vers le backlog et le tableau de gestion de projet.
Les commits suivent une covention de nommage pour faciliter la compréhension de l'historique du projet. Voici les conventions utilisées :
- ADD : Ajout de fonctionnalité
- CHG : Modification dans le comportement d'une méthode/classe
- FIX : Correction d'un bug
- REM : Suppression de fonctionnalité, méthode/classe ou de fichier
- DOC : Ajout de documentation
- REF : Refactoring de code
L'ajout de fonctionnalité est fait par le biais de branches. Chaque fonctionnalité est doit être idéalement développée dans une branche lui étant propre. Les branches sont nommées de la manière suivante :
- INITIALE-NOM_DE_LA_FONCTIONNALITE
Les branches sont ensuite mergées dans la branche de developpement (dev) une fois la fonctionnalité terminée et testée. Le merge est fait par le biais d'une pull request. La pull request peut être reviewée par d'autres membres de l'équipe avant d'être mergée dans la branche. Il est recommandé de détailler le plus possible la pull request afin de faciliter la compréhension par les autres membres.
Les pull requests sont reviewées par d'autres membres de l'équipe, a défaut copilot. Chaque membre peut commenter et suggérer des modifications. Il est important de prendre en compte les retours des autres membres et de les intégrer dans la branche.
Les bugs sont gérés par le biais d'issues sur Github. Chaque bug est décrit de manière précise afin de faciliter la compréhension du problème, comment le reproduire et de proposer une solution. Les bugs sont ensuite assignés à un membre de l'équipe qui est responsable de la résolution du bug. L'issue peut être cloturée par un commit de type FIX en précisant le numéro de l'issue dans le message de commit, il est aussi possible de cloturer l'issue manuellement en ajoutant un commentaire précisant les commits qui ont permis de résoudre le bug.
Tous les diagrammes de conception sont disponibles dans le dossier Diagrams du projet.
La réalisation du projet était supposée suivre une méthode agile, les diffcultés rencontrées ont fait que le projet a été réalisé de manière plus classique.
L'idée principale était de réaliser un clone du jeu Geometry Dash, un jeu de plateforme en 2D où le joueur doit éviter des obstacles en sautant. Les contraintes de temps et de ressources font qu'une partie des fonctionnalités du jeu de base n'ont pas été prévues. Le cahier des charges mentionne :
- La gestion du joueur (déplacement, saut)
- La gestion des obstacles (collision)
- La mise en place d'au moins deux bonus, le terme étant abigu, je suis parti sur les modes de jeu (cube, vaisseau, onde), et des objets modfiant le déroulement du jeu (portail de vitesse, jump pad et jump orb).
- Feedback visuel et sonore (musique, effets sonores)
- Effet de mort
- Effet de victoire
- Son de mort
- Musique de fond
- Interfaces :
- Menu principal
- Menu pause
- Statistiques (+ en cours de partie)
- Menu options :
- Gestion de la musique
- Gestion des touches
- Import et export de niveaux au format JSON
- Editeur de niveaux
- Intégration d'une IA complétant le niveau (Non réalisée)
La plus grosse difficulté fut la prise en main du moteur de jeu, à savoir Unity. Mon absence d'experience préalable sur le moteur n'ayant pas aidé, il y a eu une grande phase d'apprentissage des différentes fonctionnalités du moteur, des menus et du fonctionnement général. De plus, n'ayant pas de formation préalable en Game Design, il y a eu pas mal de temps passé à la recherche de ressources, de trial and error avant de réelement commencer à avancer sur le projet.
Vous pouvez télécharger le projet depuis l'onglet Releases de la page Github du projet. Le projet est disponible sous forme d'archive ZIP contenant le projet Unity et les fichiers nécessaires au lancement du jeu.
Il est précompilé pour Windows et MacOS (ARM, Intel et Universal). Il est possible de le lancer directement sans avoir besoin d'installer Unity.
Rendez-vous ici pour télécharger la dernière version du projet.
Récupérer le code source du projet :
git clone https://github.com/OneLiberty/Cnam_GeometryDash
cd Cnam_GeometryDashAjouter le projet dans le Unity Hub, puis ouvrir le projet dans Unity. Le projet à été réalisé avec la version 6000.0.27f1 de Unity. Il est recommandé d'utiliser cette version pour éviter les problèmes de compatibilité.
Lors du lancement du jeu, le menu principal s'affiche. Le joueur peut choisir d'aller à la selection de niveau, d'aller dans l'éditeur de niveaux, de consulter les options ou de quitter le jeu. Les commandes par défaut sont les suivantes : Dans un niveau :
- Espace, Clic gauche : Saut - Modifiable
- Echap : Menu pause - Modifiable
- R : Recommencer le niveau - Modifiable
Dans l'éditeur de niveaux :
- Clic gauche : Placer un objet
- Clic droit : Supprimer un objet - Modifiable
- Molette de souris : Zoomer/Dézoomer la caméra
- R : Rotation de l'objet selectionné - Modifiable
- A : Modifier le point d'ancrage de l'objet selectionné (valable pour les petits objets (small tile, small spike)) - Modifiable
- Z, Q, S, D : Déplacement de la caméra - Modifiable
- Up, Down, Left, Right : Déplacement de la caméra
- Echap : Deselectionner l'objet selectionné
Différents modes de jeu sont disponibles, à savoir le mode cube, le vaisseau (ship) et l'onde (wave). Le changement s'effectue en passant dans un portail. Chaque mode de jeu se joue différemment :
- Cube : Le joueur doit sauter pour éviter les obstacles.
- Vaisseau : Le joueur doit maintenir le bouton de saut pour monter, et relacher pour descendre.
- Onde : Le joueur doit maintenir le bouton de saut pour monter en diagonale, et relacher pour descendre en diagonale.
L'éditeur de niveaux est accessible depuis le menu principal. Le joueur peut créer un niveau en plaçant des objets sur la carte. Il peut ensuite sauvegarder le niveau au format JSON et y jouer depuis le menu de selection de niveau. Attention à bien changer le nom du niveau et l'ID, auxquel cas le niveau risque de ne pas fonctionner.
L'édition d'un niveau déjà existant est possible, il suffit de le selectionner depuis le menu déroulant dans l'éditeur de niveaux et de le charger.
Oui, cependant le jeu stocke les données du joueur dans le dossier C:/Users/<NomUtilisateur>/AppData/LocalLow/Quentin_BRENNER/Cnam_GeometryDash/. Il est donc recommandé de supprimer ce dossier si vous ne souhaitez pas conserver vos données de jeu.
Sous MacOS, le dossier se trouve dans ~/Library/Application Support/Quentin_BRENNER/Cnam_GeometryDash/.
Je remercie mes camarades de promo pour leur aide et leurs conseils tout au long du projet.
- Christopher GERARD : Pour sa sympathie et ses conseils tout au long du projet.
- Benjamin COLOMBO : Pour son aide et ses précieux conseils sur la gestion de projet, conception et la gestion de code source.