Cyril Bartz

Donjon Game — jeu d'exploration 2D en Java

Jeu d'exploration de donjon au tour par tour en Java : le joueur traverse des salles, ramasse des objets et affronte des monstres aux comportements différents pour trouver la sortie.

Java Swing

Sujet

Projet universitaire de programmation orientée objet. Il fallait développer un jeu d'exploration de salles en 2D :

  • le joueur passe de page en page (pas de défilement), chaque page contenant plusieurs salles ;
  • les salles contiennent des objets, des pièges et des monstres ;
  • le jeu se joue au tour par tour : après le joueur, les monstres visibles agissent ;
  • les salles peuvent être chargées depuis un fichier ou générées aléatoirement, avec toujours un chemin vers la sortie.

Fonctionnalités

  • Joueur avec points de vie, attaque, défense et inventaire
  • Monstres : chauve-souris, gobelin, squelette, démon et boss, chacun avec ses propres caractéristiques et son comportement
  • Animal de compagnie qui accompagne le joueur
  • Objets : épée, arc, boucliers, potions de soin, pommes, coffres, pièges
  • Cartes générées aléatoirement à chaque partie (deux niveaux + la salle du boss)
  • Affichage graphique et contrôle au clavier et à la souris

Compétences acquises

  • Programmation orientée objet : encapsulation, héritage (classes abstraites Entity, Monster, Items…), polymorphisme, interfaces
  • Modélisation UML avant le développement (uml.svg)
  • Génération procédurale de cartes
  • Interface graphique avec Java Swing (JPanel, boucle de jeu dans un thread, écouteurs clavier et souris)
  • Collections Java pour gérer les entités et l'inventaire
  • Documentation Javadoc (dossier doc/)

Jouer en ligne

Le jeu tourne directement dans le navigateur : https://bartzcyril.github.io/Game2D/

Le jar Java est exécuté dans la page grâce à CheerpJ (JVM en WebAssembly).

Compiler et lancer

Prérequis : JDK 17 ou plus récent. Les images sont dans res/images/ et sont chargées depuis le classpath : le jeu fonctionne sous Windows, Linux et macOS.

Jar exécutable (recommandé)

./build.sh              # produit build/donjon.jar et build/site/ (page web + jar)
java -jar build/donjon.jar

Le jar contient les classes et les images : il se lance depuis n'importe quel dossier.

Sans jar

javac -d bin $(find src -name "*.java")
java -cp "bin;res" main.DonjonGame    # Windows (Git Bash) ; sous Linux/macOS : -cp "bin:res"

Tester la version web en local

CheerpJ exige un serveur qui gère les requêtes HTTP Range (c'est le cas de GitHub Pages). python -m http.server ne les gère pas : la page se charge une fois, puis échoue au rechargement (« HTTP server does not support the 'Range' header »). Utiliser par exemple :

./build.sh
npx http-server build/site -p 8000 -c-1

Puis ouvrir http://localhost:8000/. Le tout premier lancement télécharge le runtime Java 17 de CheerpJ et peut prendre du temps.

Eclipse

Le projet peut aussi être importé directement dans Eclipse (fichiers .project et .classpath fournis, res/ y est déclaré comme dossier source).