Beaulieu-sur-Brume — v0.15.0

Français | English

• Roadmap
• Architecture
• Contribution
• Changelog

---

Français

Beaulieu-sur-Brume est un prototype de RPG 2D sous Godot 4.6, fondé sur les règles D&D 5.5e du SRD 5.2. Ce dépôt contient le jeu consommateur : monde, scènes, interface, sauvegarde, narration et orchestration. Les règles réutilisables vivent dans le sous-module dnd55e.

La branche develop propose actuellement :

• une boucle complète exploration → combat tactique en place → reprise, sans changement de scène ni arène séparée ;
• un menu principal, une autosave et des sauvegardes manuelles ;
• des cartes pilotées par ZoneData, avec identité et position persistantes ;
• une création de personnage niveau 3 ;
• un combat sur grille avec déplacement, Action et Action bonus indépendants, plusieurs ennemis, attaques à distance, portée et ligne de vue.

Le contenu reste volontairement réduit : une zone et une rencontre. La suite est décrite dans la roadmap.

Prérequis

• Git avec support des sous-modules ;
• Godot 4.6.3 ;
• Linux, macOS ou Windows compatible avec Godot 4.6.

Installation

git clone <url-du-depot> beaulieu-sur-brume
cd beaulieu-sur-brume
git submodule update --init --recursive

Le plugin dnd55e et ses traductions sont déjà déclarés dans project.godot.

Lancer le projet

GODOT=/chemin/vers/Godot_v4.6.3
"$GODOT" --editor .
"$GODOT" .

Chemin utilisé sur la machine de développement principale :

GODOT=/home/reliodas/Programmes/Godot_v4.6.3-stable_linux.x86_64

Contrôles

• Menu principal : Nouvelle partie, Continuer, Charger, Quitter.
• Création : espèce, classe, sous-classe, historique, tableau standard, augmentations, compétences, don humain et équipement.
• Exploration : flèches directionnelles ; F5 pour une sauvegarde manuelle.
• Combat : surimpression sur la carte (aucune scène séparée) — boutons Attaquer, Esquiver, Second Wind, Se déplacer, Fuir et Fin du tour ; cliquer une case en surbrillance pour se déplacer.
• Fin de combat : Entrée pour reprendre l'exploration en place ou recommencer.

Tests

"$GODOT" --headless --import
"$GODOT" --headless \
  --script addons/gut/gut_cmdln.gd \
  -gdir=res://tests/ \
  -ginclude_subdirs \
  -gexit

La suite couvre la logique de jeu (monde, perception, combat tactique en place, sélection de cible, sauvegarde) ; le décompte exact des tests et assertions est donné par la dernière sortie GUT/CI. Les tests du moteur dnd55e sont séparés et se lancent depuis le dépôt du sous-module.

Licence

Code du jeu : MIT, © 2026 Reza DROUIN. Voir LICENSE.

Le SRD 5.2, Godot et GUT conservent leurs licences respectives. Voir NOTICE.md.

---

English

Beaulieu-sur-Brume is a 2D RPG prototype built with Godot 4.6 and the D&D 5.5e SRD 5.2 rules. This repository is the consumer game: world, scenes, UI, saves, narrative and orchestration. Reusable rules live in the dnd55e Git submodule.

The current develop branch provides:

• a complete exploration → in-place tactical combat → resume loop, with no scene change or separate arena;
• a main menu, autosave and manual save slots;
• ZoneData-driven maps with stable identity and persistent positions;
• level-3 character creation;
• grid combat with independent movement, Action and Bonus Action budgets, multiple enemies, ranged attacks, range and line of sight.

Content is intentionally small: one zone and one encounter. See the roadmap for planned work.

Requirements

• Git with submodule support;
• Godot 4.6.3;
• a Linux, macOS or Windows system supported by Godot 4.6.

Setup

git clone <repository-url> beaulieu-sur-brume
cd beaulieu-sur-brume
git submodule update --init --recursive

The dnd55e plugin and translations are already configured in project.godot.

Run

GODOT=/path/to/Godot_v4.6.3
"$GODOT" --editor .
"$GODOT" .

Controls

• Main menu: New Game, Continue, Load, Quit.
• Character creation: species, class, subclass, background, standard array, ability increases, skills, Human feat and starting loadout.
• Exploration: arrow keys; F5 creates a manual save.
• Combat: overlaid on the map (no separate scene) — Attack, Dodge, Second Wind, Move, Flee and End Turn; click a highlighted cell to move.
• Combat result: press Enter to resume exploration in place or restart.

Tests

"$GODOT" --headless --import
"$GODOT" --headless \
  --script addons/gut/gut_cmdln.gd \
  -gdir=res://tests/ \
  -ginclude_subdirs \
  -gexit

The suite covers the game logic (world, perception, in-place tactical combat, target selection, saves); the exact test and assertion counts come from the latest GUT/CI run. The dnd55e engine has its own test suite in the submodule repository.

License

Game code: MIT, © 2026 Reza DROUIN. See LICENSE.

SRD 5.2, Godot and GUT retain their respective licenses. See NOTICE.md.