🔥 Projet de fin d'année D&D - 5ttr

🎯 Objectif du projet

Ce projet a pour objectif de développer un univers technique et narratif complet, inspiré de Donjons & Dragons (5e édition), réparti en quatre volets applicatifs :

• 🧰 Un back-office PHP : pour la gestion complète des personnages, des objets et des règles du jeu.

• 🌐 Un front-office Flask (Python) : pour une visualisation interactive et esthétique du monde et des personnages.

• 🎮 Un mini-jeu Pygame : qui met en scène les personnages et leur permet d’interagir dans des combats ou défis.

• 🔗 Une API REST (option PHP ou Python) : qui permettra à d’autres applications ou modules d’interagir avec les données.

L’ensemble est relié par une base de données MySQL unique, partagée entre les différents modules.

Ce projet te demandera de combiner plusieurs compétences acquises durant l’année : modélisation de base de données, programmation web côté serveur, développement front-end, gestion de projet, intégration de bibliothèques, réutilisation de données, etc.

🧙 Contexte général : Donjons & Dragons

Dans Donjons & Dragons, chaque joueur incarne un personnage imaginaire dans un univers médiéval-fantastique. Ce personnage a des caractéristiques, une race (elfe, nain, humain…), une classe (guerrier, voleur, magicien…) et progresse en accumulant de l’expérience.

Notre projet se base sur les principes de la 5e édition de D&D, en les adaptant légèrement pour qu’ils restent simples à gérer informatiquement.

🧙 Univers Donjons & Dragons : rappel des bases

Un joueur incarne un personnage évoluant dans un monde médiéval-fantastique. Ce personnage a une race, une classe, des caractéristiques, un niveau, une expérience, un inventaire, etc.

👤 Personnages

• Personnages Jouables (PJ): Ce sont les héros que le joueur peut créer et faire évoluer.
• Personnages Non-Jouables (PNJ): Ce sont des créatures ou humains contrôlés par le système. Ils partagent les mêmes attributs que les PJ, mais ont en plus une catégorie :
  • Allié : aide le joueur
  • Ennemi : s’oppose au joueur

Tous les personnages (PJ ou PNJ) possèdent :

• Nom

• Race (ex. : Humain, Elfe, Nain, Orc…)

• Classe (ex. : Guerrier, Mage, Voleur, Clerc…)

• Alignement (ex: bon, neutre, mauvais)

• Niveau (de 1 à 5)

• Points d’expérience (XP)

• Points de vie (PV)

• 6 caractéristiques notées sur 20 :

  • FOR (Force)
  • DEX (Dextérité)
  • CON (Constitution)
  • INT (Intelligence)
  • SAG (Sagesse)
  • CHA (Charisme)

• Chaque caractéristique possède un modificateur : mod = (valeur - 10) // 2

Par exemple, une Force de 16 donne un modificateur de +3.

🔹 Points de vie (PV)

Les points de vie représentent la résistance physique d’un personnage. Ils dépendent de la classe et du niveau.

🔹 Points d’expérience (XP) et niveau

Les personnages gagnent des XP en accomplissant des actions ou des défis. L’accumulation d’XP permet d’atteindre un niveau supérieur, ce qui améliore les compétences du personnage.

(On s’arrêtera au niveau 5 pour ce projet)

🎒 Inventaire et objets

Chaque personnage peut posséder un ou plusieurs items. Les objets enrichissent l’univers et ont un type, des effets, un niveau requis, etc.

Types d’objets

• Armes : épée, arc, dague (peuvent améliorer les dégâts)
• Armures : cape magique, bouclier (peuvent améliorer les PV)
• Objets magiques : anneau de feu, talisman d’invisibilité
• Potions : soin, force, vitesse
• Sorts : boule de feu, soin, illusion

Exemple d’objet

{
  "nom": "Épée du feu",
  "type": "arme",
  "effet": "+3 dégâts",
  "niveau requis": 2
}

🎲 Tests de caractéristiques

Les tests de caractéristiques permettent de simuler des actions risquées (ex : escalader, persuader, détecter un piège…). Chaque test :

• utilise une des six caractéristiques
• a un degré de difficulté (DD) choisi par le MJ (Maître du Jeu)
• consiste à lancer un d20 et à ajouter le modificateur de la caractéristique testée
• le résultat est succès (≥ DD) ou échec

Conséquences possibles

• Gain ou perte de points de vie
• Gain ou perte de points d’expérience
• Gain ou perte d’un objet
• Déblocage d’une scène ou interaction

⚔️ Organisation du projet

Tu développeras 3 applications connectées à une base de données MySQL commune :

🔌 REST API – Communication entre systèmes

Une API REST (Representational State Transfer) est une interface qui permet à différentes applications de communiquer via Internet de manière structurée.

Elle pourra être développée au choix en PHP ou en Python.

🔧 Avantages de l’API REST

• Standardisée (utilise HTTP, JSON)
• Flexible : séparation entre les données et les interfaces
• Réutilisable : d’autres projets pourront l’exploiter
• Sécurisable : accès contrôlé via tokens, rôles, etc.

Chaque partie fera l’objet d’un cahier des charges précis, que nous aborderons ensemble.

🗝️ Compétences mobilisées

Ce projet te permettra de mobiliser :

• la modélisation de base de données relationnelles
• la programmation orientée objet (Python, PHP)
• la création d’interfaces web (HTML, CSS, JS, Bootstrap/Tailwind)
• le développement d’un mini-jeu graphique avec Pygame
• la lecture/écriture de données entre plusieurs technologies
• la gestion de projet (Trello, Git, documentation, présentation orale)