d10_cs_generator/README.md

6.4 KiB

Introduction

Vous trouverez ici la feuille de personnage type pour le système D10. Cette feuille a été crée pour fonctionner avec Roll20.

Macros roll20

Peuvent etre utile a modifier ou récuperer:

  • Life_Points / Life_Points_maximum : Points de Vie
  • Endurance_Points / Endurance_Points_maximum : Points de fatigue
  • general_item_weapon1 : La valeur de dégats de l'arme 1
  • general_item_weapon1_name : Le nom de l'arme 1
  • general_effective_weapon1 : La valeur de dégats de l'arme 1 si elle est activée; 0 sinon
  • base_damage_dices : La base de dégats offensif (a priori, rien sauf compétence particulière)
  • exal_damage_dices : Le modificateur de dégats (Un bonus de charge, un buff de dégats temporaires)

Exemple (avec chatSetAttr) chatSetAttr:

  • !setattr --sel --Life_Points|21
  • !setattr --set --mod --Life_Points|-5
  • !setattr --name Basil --general_item_weapon1|55

HTML

  • Ne pas utiliser d'ID, seulement des classes. Il y a en effet plusieurs copies de la feuille lors d'une partie, l'utilisation d'ID pourra par conséquent entraîner des comportements inattendus.

CSS

  • La feuille complète est contenue dans une grande div .charsheet, pour éviter d'appliquer le CSS au reste de roll20. Le CSS sera modifié en conséquence lors de l'import.
  • Lors de l'import, toutes les classes qui ne sont pas préfixées de shield, roll_ ou repeating_ seront préfixées de sheet-. Il faut donc prévoir le CSS en conséquence.
Ces informations proviennent de la doc Roll20, et plus particulièrement de la page Building Character Sheet.

Générateur YAML (base et cyberpunk)

La nouvelle génération utilise uniquement les variantes base et cyberpunk. Les anciennes feuilles à la racine restent comme références pour les attributs Roll20 et les règles qui ne sont pas encore modélisées. Le dossier model_ravenous_roll20/ est une référence de méthode, sans contenu Ravenous importé dans la feuille D10.

Installer PyYAML dans un environnement virtuel puis 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
.venv/bin/python tools/build.py --variant cyberpunk --theme night --check
.venv/bin/python -m unittest discover -s tests -v

Chaque commande produit sheet.html, sheet.css, translation.json, sheet.json et build-info.json dans build/<variant>/<theme>/. Le dossier peut être changé avec --output-dir. Copier HTML, CSS et traduction dans les onglets correspondants de l'éditeur de feuille personnalisée Roll20. sheet.json sert de manifeste pour un dépôt de feuilles; build-info.json indique la variante, le thème, le nombre de compétences et une empreinte. --check compare les fichiers existants sans les réécrire.

Les compétences fixes sont dans data/base_skills.yaml et data/cyberpunk_skills.yaml. Le premier reprend les compétences de combat nommées dans la feuille de base; la feuille de base conserve aussi des lignes libres. Le second est issu du catalogue helpers/cyberpunk2.txt de origin/cyberpunk-latest (153 compétences), comparé à origin/cyberpunk. Les sections, champs et variantes sont définis dans data/sheet_model.yaml; les palettes sont dans data/themes.yaml. Ajouter une compétence ne demande pas de modifier le code Python. Les identifiants sont stables et validés avant la génération. Le changement de thème ne change que les couleurs et la classe racine du HTML.

Compatibilité et limites

La nouvelle feuille conserve les noms des caractéristiques, des ressources, des compétences fixes de combat de base et de plusieurs champs d'armes. La variante cyberpunk conserve les noms de compétences de l'ancien générateur et les PV/protection/intégrité par localisation. Les sections répétables sont reconstruites à partir du modèle; les lignes déjà stockées sous un autre nom de section ne migrent pas automatiquement. La feuille précédente comportait aussi des macros !crit et des calculs de combat complexes; le nouveau build ne les appelle pas. Les boutons de jet de la nouvelle feuille utilisent un seuil moins un dé et affichent le résultat via un roll template. Les valeurs avancées de combat et les comportements des scripts Mod restent dans les anciennes sources tant qu'ils n'ont pas de modèle D10 vérifié.

Les tests locaux valident les quatre combinaisons variante/thème, les références d'attribut dans les jets, les couleurs, les identifiants et le build reproductible. Ils ne simulent pas le parseur de dés, l'affichage ou la sauvegarde de Roll20. Dans le Custom Sheet Sandbox, charger chaque variante, ajouter une ligne répétable, lancer les jets, sauvegarder et rouvrir deux personnages. La documentation officielle Roll20 décrit l'éditeur et les limitations des feuilles personnalisées.

Présentation des caractéristiques et compétences

La mise en page générée utilise un en-tête de personnage, des cartes de caractéristiques sur deux colonnes et des lignes de compétences alignées (nom, caractéristique, niveau, coût et jet). Les sous-compétences sont en retrait. Le style commun se trouve dans templates/sheet.css; les couleurs restent dans data/themes.yaml. Les noms d'attributs et les formules de jet n'ont pas changé avec cette refonte visuelle. Les fichiers dans build/ doivent être régénérés avant de remplacer le HTML et le CSS dans Roll20.

Onglets

L'en-tête du personnage reste visible. Quatre onglets organisent la feuille : Personnage (caractéristiques et ressources), Compétences, Combat et Autres (sections répétables). Le choix est enregistré dans l'attribut Roll20 d10_tab par un sheet worker, sans changer les valeurs des autres champs. Pour tester localement les actions après avoir généré les deux variantes parchment :

node tests/test_tabs.mjs

Le test simule les clics et les mises à jour d'attribut. Vérifier aussi dans Roll20 que le clic affiche le bon onglet et que celui-ci est conservé après fermeture puis réouverture de la feuille.