154 lines
8.5 KiB
Markdown
154 lines
8.5 KiB
Markdown
# 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/`](scripts/).
|
||
|
||
## Construire
|
||
|
||
```sh
|
||
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/`](https://books.dandaedre.com/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 :
|
||
|
||
```sh
|
||
.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 :
|
||
|
||
```sh
|
||
.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
|
||
|
||
```sh
|
||
.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`](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.
|