Projet Endless Runner - Université Paris Cité (L2 Informatique 2025-2026) - AD1a

Table des matières

• Description du projet
• Architecture
• Prérequis
• Compilation et exécution
• Tests
• Outils
• Auteurs et remerciements

---

Description du projet

Ce projet est un jeu endless runner (course sans fin), développé en Java dans le cadre de l'UE Projet Informatique à l'Université Paris Cité.

Le joueur contrôle un personnage avançant automatiquement de gauche à droite dans un monde infini de difficulté progressive généré procéduralement.

Le projet suit une méthodologie Agile (Scrum) et est développé en plusieurs itérations (sprints).

---

Architecture

Nous suivons une architecture MVC (Modèle – Vue – Contrôleur) :

• Modèle : contient la logique du jeu (GameModel, Entity, Map)
• Vue : gère l’affichage en vue texte et graphique Swing (GameView, MapRenderer)
• Contrôleur : coordonne les entrées clavier/souris et le déroulement des tours (GameController)

Organisation des dossiers (indicative):

src/
└── main/
    ├── java/
    │   ├── app/
    │   ├── model/
    │   │   ├── entities/
    │   │   ├── physics/
    │   │   └── world/
    │   ├── view/
    │   └── controller/
    └── resources/
        ├── assets/
        │   ├── sprites/
        │   ├── backgrounds/
        │   └── ui/
        └── sounds/
            ├── music/
            └── effects/

---

Prérequis

• Java 21 ou supérieur
• Gradle (gestion du build et des dépendances)
• Compatible avec Linux, macOS et Windows

Dépendance externe requise : Javafx

---

Compilation et exécution

Placez-vous à la racine du projet.

Avec les scripts fournis (Linux/macOS/Windows)

• Lancer le jeu :
  • Sur Linux/macOS :

    ./gradlew run

  • Sur Windows :

    ./gradlew.bat run

Avec Gradle

• Compiler le projet :

  • Linux / macOS :

    ./gradlew build

  • Windows :

    ./gradlew.bat build

• Lancer le jeu :

  • Linux / macOS :

    ./gradlew run

  • Windows :

    ./gradlew.bat run

    (depuis le dossier 'meta/')

• Générer le JAR exécutable :

  ./gradlew jar

  Le fichier JAR se trouve dans build/libs/.

• Générer la Javadoc :

  ./gradlew javadoc

---

Tests

Les tests unitaires (avec JUnit) seront ajoutés au fur et à mesure dans le dossier src/test/java/. Ils permettront de valider les parties essentielles du modèle : instances correctement créées, gravité, collisions, tours de jeu, inventaire, etc.

Pour lancer les tests :

• Sur Linux/macOS :

./meta/gradlew -p meta test

---

Outils

• GitLab (système de gestion de versions, CI/CD)

• Gradle (build & dépendances)

• Java 21

• Swing / AWT / javafx (interface graphique)

• JUnit 5 et Mockito (tests)

• Checkstyle

• Cobertura et Jacoco (couverture de tests)

---

Auteurs et remerciements

Les auteurs sont consignés dans le fichier AUTHORS.

Projet réalisé dans le cadre de l'UE Projet Informatique (Université Paris Cité – 2025–2026).
Serveur GitLab : https://moule.informatique.univ-paris-diderot.fr/mesnildr/pi4-java-2526-ad1a-dlmps

Projet académique — Licence -> (voir fichier LICENSE).