Skip to content

Repository files navigation

DBRPG

Un RPG textuel en français dans un univers inspiré de Dragon Ball, mené par un agent maître du jeu (MJ) branché directement sur ce repo. Le « jeu » n'est pas un logiciel : c'est le contenu de ce repo (système, prompts, état, lore) que l'agent lit et fait vivre.

In English. DBRPG is a solo, text-based tabletop RPG set in a world inspired by Dragon Ball, run by an AI agent acting as Game Master. The game is not a program. It is the content of this repo (rules, lore, prompts, state) that the agent reads, narrates, and keeps up to date. Play happens in French, live or over Telegram. To start, point an agent at instructions_mj.md.

Comment ça marche

  • Un agent (harness type Hermès) est connecté à ce dépôt et joue le rôle de MJ.
  • Le joueur lui parle en langage naturel, en direct ou via Telegram (voir docs/jouer_via_telegram.md).
  • L'agent lit les fichiers pertinents, narre, arbitre avec de vrais dés, et sauvegarde l'état en fin de session (commit git).

Point d'entrée de l'agent : instructions_mj.md.

Le système en une page

  • Résolution 2d6 + attribut : 10+ réussite · 7-9 réussite à un coût · 6- échec intéressant.
  • 4 attributs : Corps, Ki, Vivacité, Cœur (de -1 à +3).
  • Paliers de puissance (0→8) = modificateur de difficulté (anti-power-creep).
  • États au lieu de points de vie ; horloges pour la tension.
  • Liens & Élan pour le « pouvoir de l'amitié ».
  • Dé réel et visible (outils/des.py), zéro power level dans la fiction.
  • Manœuvres nommées (actions du jeu) : 00_regles/manoeuvres.md.

Détails : 00_regles/regles_de_base.md.

Structure du repo

instructions_mj.md        # prompt central du MJ
configuration_campagne.md # réglages de la campagne en cours
00_regles/                # le système (règles, conventions, modèles meta)
01_univers/               # lore : canon, glossaire, races, factions
02_lieux/                 # lieux
03_personnages/           # PNJ canon, perso(s) joueur, modèles
04_techniques/            # techniques & pouvoirs
05_objets/                # objets & technologies
06_campagne/              # ÉTAT DUR de la partie (hub : etat_campagne.md)
07_sessions/              # historique des sessions
08_arcs/                  # structure narrative des arcs
09_prompts/               # rôles de l'agent (narrateur, arbitre, etc.)
outils/                   # utilitaires (dé : des.py ; garde-fou : verifier_etat.py)
.githooks/                # hook pré-commit (garde-fou d'intégrité)

Principe clé : on sépare le lore (01-05) de l'état dur de la campagne (06), de l'historique (07) et des arcs (08).

Démarrer

Pointer l'agent sur ce repo et lui faire lire instructions_mj.md. S'il s'agit d'une nouvelle partie, il lance l'arc 1 (08_arcs/) et aide à créer la feuille de perso (03_personnages/originaux/personnage_joueur.md).

On joue sur une branche, jamais sur main (qui reste le tronc vierge : règles + lore + état neuf). Une partie = une branche partie/<nom> créée depuis main. Voir 00_regles/nouvelle_partie.md.

Garde-fou d'intégrité

outils/verifier_etat.py refuse les corruptions récurrentes dans les fichiers de contenu/état : balises d'outil parasites (</content>, </invoke>...) écrites par erreur par l'Archiviste, et tirets cadratin bannis par le ton. Un hook pré-commit le lance automatiquement et bloque le commit en cas de violation.

Activation (une fois par clone, car core.hooksPath est une config locale) :

git config core.hooksPath .githooks

Lancer le contrôle à la main : python3 outils/verifier_etat.py.

Documents de conception

  • docs/decisions/0001-architecture-langue-et-organisation.md (ADR)
  • docs/superpowers/specs/2026-06-28-dbrpg-design.md (design du jeu)

Licence

Le contenu de ce dépôt (système de jeu, règles, lore, personnages originaux, textes) est publié sous Creative Commons Attribution - Pas d'Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International (CC BY-NC-SA 4.0). Voir LICENSE.

Les outils Python du dossier outils/ sont aussi disponibles sous licence MIT (voir outils/LICENSE), pour qui voudrait les réutiliser indépendamment du jeu.

Projet de fan non officiel. DBRPG est un projet amateur et non commercial, sans affiliation avec les ayants droit de Dragon Ball. Dragon Ball et ses personnages sont la propriété de leurs détenteurs respectifs (Bird Studio, Shueisha, Toei Animation). Seuls le système de jeu original, les textes originaux et l'outillage sont couverts par les licences ci-dessus.

About

Solo text RPG in a world inspired by Dragon Ball, run by an AI agent as Game Master. The game is this repo's content, not a program.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages