Vous trouverez ici la feuille de personnage type pour le système D10. Cette feuille a été crée pour fonctionner avec Roll20.
Go to file
Dandaedre 607e339e8d
Chado/d10_cs_generator/pipeline/head This commit looks good Details
Link published cyberpunk body images by default
2026-09-19 00:44:56 +02:00
assets Restore original cyberpunk body maps and integrity maxima 2026-09-19 00:25:42 +02:00
data Add selectable cyberpunk corporation palettes 2026-09-19 00:31:36 +02:00
scripts Remove obsolete sheet assets and archive legacy Mod scripts 2026-09-19 00:10:59 +02:00
templates Add selectable cyberpunk corporation palettes 2026-09-19 00:31:36 +02:00
tests Link published cyberpunk body images by default 2026-09-19 00:44:56 +02:00
tools Link published cyberpunk body images by default 2026-09-19 00:44:56 +02:00
.gitignore Ignore local theme reference styles 2026-09-19 00:33:31 +02:00
AGENTS.md Remove obsolete sheet assets and archive legacy Mod scripts 2026-09-19 00:10:59 +02:00
Jenkinsfile Deploy D10 builds to shared books directory 2026-09-19 00:41:07 +02:00
README.md Link published cyberpunk body images by default 2026-09-19 00:44:56 +02:00
TASKS.md Link published cyberpunk body images by default 2026-09-19 00:44:56 +02:00
requirements.txt Generate base and cyberpunk Roll20 sheets from YAML models 2026-09-18 23:28:18 +02:00

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>/. Le build cyberpunk copie aussi les deux images originales de assets/. 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. Ses compétences fixes ont trois sous-onglets issus des sections du catalogue YAML : Physique, Intellectuelles et Social. Les champs répétables restent dans Autres. Le choix principal est stocké dans d10_tab, celui des sous-onglets base dans d10_skill_tab et celui des catégories cyberpunk dans d10_category_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. La variante cyberpunk propose un sélecteur de thème dans l'en-tête. Il conserve le choix dans d10_theme_choice et applique immédiatement la palette via d10_theme. Les 18 palettes du dossier local styles/themes/ ont été adaptées aux cinq couleurs de la feuille et copiées dans data/themes.yaml; le build ne dépend pas de ce dossier. parchment et night restent disponibles. --theme choisit le thème initial; tous les thèmes modifient seulement les couleurs et la visibilité de la silhouette, 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, intégrité et intégrité maximale aux mêmes localisations). Les cases sont posées sur les images originales robotman_health_r.png et robotman_armor_r.png. Les attributs de localisation existants gardent leurs noms; les nouveaux maxima portent le suffixe _maximum. Sur un écran étroit, les cartes se placent l'une sous l'autre. Les champs numériques masquent les flèches de réglage des navigateurs Firefox et Chromium.

Par défaut, le HTML cyberpunk référence directement les deux PNG publiés dans RPG/d10_character_sheet/assets/. Pour un aperçu local sans réseau, les PNG restent copiés à côté de sheet.html et peuvent être référencés avec une valeur vide :

.venv/bin/python tools/build.py --variant cyberpunk --theme parchment \
  --asset-base-url ''

Une autre adresse HTTPS publique peut être fournie avec --asset-base-url. Charger le HTML généré dans l'éditeur Roll20 avec le CSS et la traduction.

Publication Jenkins

L'agent Jenkins doit disposer de Python 3 avec venv. Le test JavaScript des onglets s'exécute si Node.js est présent; son absence ne bloque pas la publication. Le Jenkinsfile exécute les tests Python, construit les deux variantes dans les 20 thèmes et archive tous les résultats sous RPG/d10_character_sheet/. Le dossier RPG/d10_character_sheet/assets/ contient les deux PNG originaux. Les fichiers HTML, CSS et JSON de chaque build sont dans RPG/d10_character_sheet/<variante>/<thème>/. La commande locale équivalente est :

.venv/bin/python tools/publish_builds.py
D10_BUILD_ROOT=RPG/d10_character_sheet node tests/test_tabs.mjs

Jenkins archive ces fichiers comme artifacts du job, puis déploie les builds de master vers /mnt/books/RPG/d10_character_sheet/ avec rsync, selon le même principe que le pipeline Ravenous. Les autres branches ne sont pas déployées. Les builds Jenkins utilisent désormais directement l'URL publique du dossier assets/ pour les images de la feuille cyberpunk.

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.