|
|
||
|---|---|---|
| data | ||
| scripts | ||
| templates | ||
| tests | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
| TASKS.md | ||
| requirements.txt | ||
README.md
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.
Les sections 01 Caractéristiques et 02 Ressources restent visibles.
La variante base a deux onglets principaux, Compétences et Combat.
Dans Compétences, quatre sous-onglets séparent Combat et combat libre,
Compétences libres, Magie et Équipement. Les lignes répétables
gardent leurs noms d'attributs et de section. La variante cyberpunk conserve
les onglets Compétences, Combat et Autres. Le choix principal est
stocké dans d10_tab, celui des sous-onglets base dans d10_skill_tab.
Les personnages qui avaient enregistré core ou, pour la variante base,
other affichent Compétences jusqu'au prochain clic. L'en-tête reste visible. Les
thèmes parchment et night changent les couleurs sans modifier les champs
ni les jets.
Dans la variante cyberpunk, 02 affiche aussi deux cartes côte à côte : Santé (PV de la tête, du torse et des membres) et Armure (protection et intégrité aux mêmes localisations). Les cases sont posées sur une silhouette dessinée en CSS, sans image hébergée. Les noms des attributs de localisation restent ceux du générateur précédent; sur un écran étroit, les cartes se placent l'une sous l'autre.
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.