d10_cs_generator/README.md

3.4 KiB

Système D10 — feuilles Roll20

Ce dépôt génère deux feuilles de personnage Roll20 : base et cyberpunk. Les compétences fixes sont dans data/base_skills.yaml et data/cyberpunk_skills.yaml. Les champs et variantes sont dans data/sheet_model.yaml, les couleurs dans data/themes.yaml, et le style commun dans templates/sheet.css. tools/build.py produit les fichiers à charger dans Roll20.

Le dossier model_ravenous_roll20/ est une référence locale fournie par l'utilisateur; il est ignoré par Git et n'entre pas dans la génération D10. Les deux scripts Mod historiques sont conservés dans scripts/.

Construire

python -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python tools/build.py --variant base --theme parchment
.venv/bin/python tools/build.py --variant cyberpunk --theme night
.venv/bin/python tools/build.py --list-themes

Chaque build crée sheet.html, sheet.css, translation.json, sheet.json et build-info.json dans build/<variante>/<thème>/. Il est possible de choisir un autre répertoire avec --output-dir. Charger le HTML, le CSS et la traduction dans les onglets correspondants de l'éditeur de feuille personnalisée Roll20. sheet.json est un manifeste; build-info.json contient la variante, le thème, le nombre de compétences et une empreinte du résultat.

La feuille a quatre onglets : Personnage (caractéristiques et ressources), Compétences, Combat et Autres (sections répétables). Le choix de l'onglet est stocké dans l'attribut d10_tab. L'en-tête reste visible. Les thèmes parchment et night changent les couleurs sans modifier les champs ni les jets.

Vérifier

.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python tools/build.py --variant base --theme parchment --check
.venv/bin/python tools/build.py --variant cyberpunk --theme night --check
node tests/test_tabs.mjs

Le test Node utilise les builds base/parchment et cyberpunk/parchment; construire ces deux variantes avant de l'exécuter. --check compare les fichiers existants aux sources sans les réécrire. Les tests vérifient la génération, les références d'attribut et les actions des onglets, mais ne simulent pas l'affichage, le parseur de dés ou la sauvegarde de Roll20. Le Custom Sheet Sandbox doit encore servir à valider les interactions et la persistance des valeurs; les points précis sont dans TASKS.md.

Sources et compatibilité

Le modèle de base reprend les attributs principaux de l'ancienne feuille feuille_sysd10.html; les compétences cyberpunk viennent de la branche origin/cyberpunk-latest, vérifiée contre origin/cyberpunk. Les anciennes sources sont conservées dans l'historique Git, pas dans la génération. Les noms des caractéristiques, ressources et de plusieurs champs de combat ont été gardés quand cela était possible. Les sections répétables reconstruites sous un autre nom ne migrent pas automatiquement.

La feuille historique utilisait aussi les macros !crit et des calculs de combat complexes. Le nouveau build utilise un seuil moins un dé et un roll template; il n'appelle pas ces macros. Les scripts historiques sous scripts/ restent disponibles séparément, sans validation avec la nouvelle feuille. Les fonctionnalités avancées non modélisées ne doivent pas être supposées compatibles.