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 VieEndurance_Points / Endurance_Points_maximum: Points de fatiguegeneral_item_weapon1: La valeur de dégats de l'arme 1general_item_weapon1_name: Le nom de l'arme 1general_effective_weapon1: La valeur de dégats de l'arme 1 si elle est activée; 0 sinonbase_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_ourepeating_seront préfixées desheet-. 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.