Collection de scénarios D&D 5e enrichis et prêts à jouer, basés sur les règles du package dnd-5e-core.
Ce projet propose une collection de 36 scénarios D&D 5e en français, dont :
- 2 scénarios enrichis manuellement (⭐⭐⭐⭐⭐) - Qualité professionnelle, 95% fidèles aux PDFs
- 9 scénarios originaux (⭐⭐⭐) - Créés avec soin
- 25 scénarios prototypes (⭐⭐) - Enrichis automatiquement
Les scénarios utilisent le système de jeu du package dnd-5e-core v0.4.0 pour gérer les règles D&D 5e.
- ✨ ClassAbilities & RacialTraits - Appliqués automatiquement aux personnages
- ⚡ Conditions System - Poisoned, Restrained, Paralyzed, etc. (affichage en combat)
- 🎁 Magic Items - 10+ items magiques prédéfinis (Ring of Protection, Wand of Magic Missiles, etc.)
- 🎭 Multiclassing - Support complet du multiclassing
- 🎒 Inventaire Amélioré - Trésors et magic items intégrés aux inventaires
git clone https://github.com/codingame-team/DnD5e-Scenarios.git
cd DnD5e-Scenariospython3 -m venv .venv
source .venv/bin/activate # Linux/Mac
# ou
.venv\Scripts\activate # Windowspip install dnd-5e-core>=0.4.0Note: Ce projet requiert dnd-5e-core version 0.4.0 ou supérieure pour bénéficier de toutes les fonctionnalités (ClassAbilities, RacialTraits, Conditions, Magic Items, Multiclassing).
Le launcher offre une interface colorée pour choisir parmi tous les scénarios :
python launcher.pyVous verrez un menu avec :
- 📖 Scénarios enrichis manuellement (qualité ⭐⭐⭐⭐⭐)
- 📚 Scénarios originaux (qualité ⭐⭐⭐)
- 📋 Scénarios prototypes (qualité ⭐⭐)
Entrez le numéro du scénario ou 'q' pour quitter.
⚙️ Paramètres : Tapez s pour accéder aux paramètres :
- 🎬 Vitesse de texte : Lent, Normal, Rapide, Instantané
- 💾 Sauvegardes : Automatiques ou Interactives
- ⚔️ Système de combat : dnd-5e-core (complet) ou Enhanced (simple)
Voir docs/CONFIGURATION.md pour plus de détails.
Lancez directement un scénario spécifique :
# Scénarios enrichis manuellement (⭐⭐⭐⭐⭐)
python masque_utruz_enrichi_game.py
python cryptes_de_kelemvor_manual_game.py
# Scénarios originaux (⭐⭐⭐)
python chasse_gobelins_refactored.py
python yawning_portal_game.py
python tombe_rois_serpents_game.py
python oeil_gruumsh_game.py
python secte_du_crane_game.py
python collier_de_zark_game.py
python auberge_sanglier_gris_game.py
# Nouveaux scénarios (⭐⭐⭐)
python cryptes_de_kelemvor_game.py
python masque_utruz_game.py
python defis_a_phlan_game.pypython play_scenarios.py| Scénario | Niveau | Durée | Scènes | Description |
|---|---|---|---|---|
| 🎭 Le Masque Utruz | 3 | 3-4h | 33 | Cité sur une faille, usurier, Utruz, Dieu-Poisson |
| ⚰️ Les Cryptes de Kelemvor | 4 | 3-4h | 27 | Temple profané, 7 sceaux, braseros sacrés, nécrophage |
| Scénario | Niveau | Durée | Description |
|---|---|---|---|
| 🏰 La Chasse aux Gobelins | 3 | 1-2h | Sauvez le Village de Brume |
| 🏛️ The Sunless Citadel | 1 | 2-3h | Explorez une citadelle engloutie |
| 🔺 La Tombe des Rois Serpents | 2 | 2h | Pillez une pyramide ancienne |
| 👁️ L'Oeil de Gruumsh | 3 | 2-3h | Affrontez une tribu d'orques |
| 💀 La Secte du Crâne | 4 | 2-3h | Infiltrez les catacombes |
| 💎 Le Collier de Zark | 2 | 1-2h | Enquête sur un vol de collier |
| 🍺 L'Auberge du Sanglier Gris | 1 | 1-2h | Nuit mouvementée dans une auberge |
| Scénario | Niveau | Durée | Description |
|---|---|---|---|
| ⚰️ Cryptes de Kelemvor | 3 | 2-3h | Version alternative |
| 🎭 Le Masque Utruz | 2 | 2-3h | Version alternative |
| 🏰 Défis à Phlan | 1 | 1-2h | Mini-missions variées |
25 scénarios enrichis automatiquement disponibles comme prototypes.
Le projet inclut des scripts pour générer rapidement des personnages prêts à l'emploi pour vos scénarios, en utilisant simple_character_generator du package dnd-5e-core.
# Créer le groupe classique (Aragorn, Gandalf, Bilbo, Gimli) niveau 5
python scripts/create_party.py --classic --level 5
# Créer un groupe aléatoire de 6 personnages niveau 3
python scripts/create_party.py --level 3 --size 6 --out data/my_party.json# Créer Gandalf le magicien niveau 10
python scripts/create_character.py --name Gandalf --class wizard --race elf --level 10
# Créer un guerrier aléatoire niveau 5
python scripts/create_character.py --class fighter --level 5# Voir un exemple complet d'utilisation des personnages
python scripts/example_usage.pyLes personnages générés incluent :
- ⚔️ Capacités de classe automatiques (Extra Attack, Sneak Attack, Rage, etc.)
- 🧝 Traits raciaux (Darkvision, Fey Ancestry, Lucky, etc.)
- ✨ Sorts pour les lanceurs (sélection aléatoire appropriée au niveau)
- 📊 Caractéristiques générées (méthode 4d6 drop lowest)
- 💾 Export JSON pour réutilisation
📖 Documentation complète: Voir scripts/README.md
Pour enrichir un nouveau scénario depuis un PDF officiel :
# Analyser un seul PDF
python analyze_pdf_deep.py Nom-du-scenario
# Analyser 5 scénarios en batch
python enrich_batch.pyRésultat : Fichier d'analyse détaillé dans analysis/Nom-du-scenario_analysis.txt
Consultez le Guide d'Enrichissement pour :
- Extraire le contenu d'un PDF
- Créer un scénario enrichi manuellement
- Atteindre une qualité professionnelle (⭐⭐⭐⭐⭐)
DnD5e-Scenarios/
├── launcher.py # 🚀 Lanceur universel (RECOMMANDÉ)
├── play_scenarios.py # Menu alternatif
├── README.md # Ce fichier
│
├── *_game.py # Scripts de scénarios
│ ├── masque_utruz_enrichi_game.py # ⭐⭐⭐⭐⭐
│ ├── cryptes_de_kelemvor_manual_game.py # ⭐⭐⭐⭐⭐
│ ├── chasse_gobelins_refactored.py # ⭐⭐⭐
│ └── ...
│
├── data/
│ └── scenes/ # Scénarios JSON
│ ├── masque_utruz_enrichi.json
│ ├── cryptes_de_kelemvor_manual.json
│ └── ...
│
├── scenarios/ # PDFs des scénarios officiels
│ ├── Masque-utruz.pdf
│ ├── Cryptes-de-Kelemvor.pdf
│ └── ...
│
├── analysis/ # Analyses de PDFs
│ ├── Cryptes-de-Kelemvor_analysis.txt
│ └── ...
│
├── src/ # Code source
│ ├── scenarios/ # Système de scénarios
│ ├── scenes/ # Système de scènes
│ └── utils/ # Utilitaires (PDF reader)
│
├── docs/ # Documentation
│ ├── GUIDE_ENRICHISSEMENT.md
│ ├── ENRICHISSEMENT_MANUEL.md
│ ├── LISTE_SCENARIOS.md
│ └── archive/ # Docs obsolètes
│
├── savegames/ # Sauvegardes
└── tokens/ # Tokens de monstres
- Guide d'Enrichissement - Comment créer des scénarios de qualité
- Liste des Scénarios - Tous les scénarios disponibles
- Enrichissement Manuel - Méthode approfondie
launcher.py- Lanceur avec interface coloréeanalyze_pdf_deep.py- Analyser un PDF en profondeurenrich_batch.py- Analyser plusieurs PDFs en batch
# Lancer le launcher
python launcher.py
# Choisir "1" pour Le Masque Utruz
# Le scénario démarre avec 33 scènes détaillées# 1. Analyser le PDF
python analyze_pdf_deep.py Mon-Scenario
# 2. Lire l'analyse
cat analysis/Mon-Scenario_analysis.txt
# 3. Créer le JSON enrichi (manuel)
# Voir docs/GUIDE_ENRICHISSEMENT.md
# 4. Créer le script Python
# Copier un script existant et adapter
# 5. Tester
python mon_scenario_game.py- ✅ 2 scénarios enrichis manuellement (⭐⭐⭐⭐⭐)
- ✅ 9 scénarios originaux (⭐⭐⭐)
- ✅ 25 prototypes (⭐⭐)
- ✅ Launcher universel
- ✅ Outils d'enrichissement
- ⏳ Enrichir 3-5 scénarios prioritaires
- ⏳ Interface graphique (Pygame/PyQt)
- ⏳ Mode multijoueur
- ⏳ Éditeur de scénarios visuel
- ⏳ Système d'achievements
Les contributions sont bienvenues ! Vous pouvez :
- Enrichir un scénario - Suivez le Guide d'Enrichissement
- Créer un nouveau scénario - Utilisez les outils fournis
- Améliorer le code - Pull requests bienvenues
- Signaler des bugs - Issues GitHub
Ce projet est sous licence MIT. Les scénarios sont basés sur des PDFs officiels D&D 5e disponibles sur aidedd.org.
- Package dnd-5e-core : PyPI | GitHub
- Scénarios source : aidedd.org
- Repository GitHub : DnD5e-Scenarios
Pour toute question ou problème :
- Ouvrez une Issue GitHub
- Consultez la documentation
Que vos dés roulent favorablement, aventuriers !
Dernière mise à jour : 11 janvier 2026
Version : 2.0
36 scénarios disponibles