|
|
||
|---|---|---|
| assets | ||
| data | ||
| scripts | ||
| templates | ||
| tests | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| Jenkinsfile | ||
| 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>/. 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 sous-onglets issus du
catalogue YAML sont Physique, Intellectuelles, Social et Arsenal.
Les compétences libres et les contacts répétables restent dans Autres.
Les contacts ont un nom et un niveau, sans caractéristique associée. Leur
bouton Show affiche ces informations dans le chat sans lancer de dé.
L'onglet Combat cyberpunk contient seulement l'initiative et son jet;
les attaques et dégâts des armes sont gérés dans Arsenal. La variante base
conserve ses champs de combat génériques et ses armes équipées.
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.
Arsenal contient Distance, Mêlée et Consommable. Les armes restent
dans les sections répétables distance et melee. Le sélecteur de thème dans l'en-tête 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
sous les noms Parchemin et Nuit dans le sélecteur.
--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.
Chaque arme cyberpunk a un seuil de base, une précision et une spécialité de
combat facultative. Le nombre de dés est demandé à chaque attaque dans une
fenêtre Roll20, avec 1 par défaut. L'attaque compte les dés inférieurs ou
égaux à seuil de base + compétence + précision. Les dégâts valent dégâts de base + (réussites − 1) × dégâts / réussite, ou zéro sans réussite. Une rafale
ajoute un dé. Les tirs vérifient le coût en munitions du mode choisi et retirent
ces munitions du chargeur après le jet. La réserve compte les chargeurs de
rechange, et non les balles. Recharger consomme un chargeur de réserve et
remplit le chargeur actuel à sa capacité; les balles qui restaient dans
l'ancien chargeur sont perdues. Les personnages existants dont la réserve
comptait des balles doivent corriger cette valeur. Le bouton
Dégâts permet de saisir manuellement les réussites sans dépenser de
munitions. Les champs historiques name, damage et notes de ces deux
sections sont conservés; les nouvelles valeurs doivent être renseignées sur
les personnages existants. Les anciennes sections historiques
ranged-weapons et melee-weapons ne migrent pas automatiquement.
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.