Roll20 character sheet & macros
Go to file
Dandaedre 1f56c02995
Roll20 Sheet Build Successful The Ravenous Roll20 sheet was generated and validated successfully.
Ravenous/ravenous_roll20/pipeline/head This commit looks good Details
Update Ravenous YAML and generate nested skill specializations
2026-09-14 21:38:22 +02:00
ravenous_typst@3e1310d2f0 Update Ravenous YAML and generate nested skill specializations 2026-09-14 21:38:22 +02:00
scripts Made things 2026-08-27 20:39:13 +02:00
src Adds most features 2026-09-01 21:16:56 +02:00
tests Update Ravenous YAML and generate nested skill specializations 2026-09-14 21:38:22 +02:00
tools Update Ravenous YAML and generate nested skill specializations 2026-09-14 21:38:22 +02:00
.gitignore Removes build from git 2026-09-01 21:18:52 +02:00
.gitmodules Update sm 2026-08-27 20:41:02 +02:00
Jenkinsfile Removes build from git 2026-09-01 21:18:52 +02:00
LICENSE Initial commit 2026-08-26 22:08:01 +02:00
README.md Update Ravenous YAML and generate nested skill specializations 2026-09-14 21:38:22 +02:00
pyproject.toml Made things 2026-08-27 20:39:13 +02:00
uv.lock Made things 2026-08-27 20:39:13 +02:00

README.md

Ravenous — feuille Roll20

Feuille de personnage Roll20 générée depuis les données du livre ravenous_typst. Le résultat reprend la palette parchemin, or et sang du livre et fournit :

  • les caractéristiques et statistiques dérivées de Ravenous ;
  • toutes les compétences générales officielles, les compétences maison et leurs modificateurs ;
  • les attaques et protections sous forme de sections répétables, avec jets de défense et calcul des dégâts dans Roll20 ;
  • une page de santé détaillée par localisation (PV, protection et armure), ainsi que toutes les résistances physiques et élémentaires ;
  • les potions, nourritures et effets temporaires en texte libre, publiables dans le chat ;
  • l'ajout individuel des techniques d'école depuis les TSV du livre, avec traduction du balisage Typst et bouton d'activation dans le chat.

Construction locale

Initialiser le sous-module une première fois :

git submodule update --init --recursive

Puis construire avec uv (aucun pip global n'est utilisé) :

./scripts/build.sh

Le script crée .venv/ et produit dans build/ :

  • ravenous.html, ravenous.css et translation.json, à charger dans l'éditeur de feuille personnalisée Roll20 ;
  • sheet.json, comme base pour une future soumission au dépôt communautaire Roll20 (une capture ravenous.png devra alors être ajoutée) ;
  • build-info.json, qui indique le nombre d'écoles, techniques et compétences importées ainsi que l'empreinte du contenu.

La limite des tiers d'école vient directement de ravenous_typst/data/config/build.yaml : seuls les tiers strictement inférieurs à build.max_tier_exclusive sont proposés par la feuille.

Pour vérifier qu'un build versionné correspond aux sources :

./scripts/build.sh --check

Mise à jour depuis le livre

git submodule update --remote ravenous_typst
./scripts/build.sh

Les compétences proviennent de ravenous_typst/data/src/character_sheet.yaml et les techniques de ravenous_typst/data/src/schools/*.tsv. Les transformations sont dans tools/build.py; le HTML et le CSS maintenus à la main restent dans src/. Les spécialités imbriquées (subskills) sont également importées ; leur nom et leur identifiant incluent la compétence parente pour éviter les ambiguïtés. Il n'est donc pas nécessaire de recopier les données lors d'une mise à jour du livre.

CI et publication

Le Jenkinsfile, inspiré de celui de ravenous_typst, initialise les sous-modules, installe uv via Cargo si nécessaire, reconstruit la feuille, exécute les tests et vérifie que build/ est à jour. Jenkins archive ensuite le dossier complet avec empreintes.

Les branches main et master sont publiées dans /mnt/books/ravenous_sheet, correspondant à https://books.dandaedre.com/ravenous_sheet/. Les branches candlelight et lighthouse utilisent respectivement les dossiers suffixés _candlelight et _lighthouse. Les autres branches sont construites et archivées sans être déployées.

Notes Roll20

Dans une partie utilisant une feuille personnalisée, copiez le contenu des trois fichiers HTML, CSS et traduction dans les panneaux correspondants. La feuille cible le mode CSE actuel : laissez Legacy Sanitization désactivé. La police Google distante est facultative ; sans accès réseau, les polices de secours Georgia/serif sont utilisées et toute la mise en page reste active. La prévisualisation intégrée de Roll20 ne simule pas complètement les sheet workers ni les sections répétables : validez les imports et les jets dans le bac à sable de feuille ou dans une partie de test.

Pour utiliser Défendre depuis la carte d'une attaque, sélectionnez d'abord le token du défenseur. La macro utilise alors sa compétence d'Esquive ou de Parade et son modificateur temporaire, sans ajouter la caractéristique associée. Le bouton Jets secrets dans l'en-tête envoie les jets du personnage uniquement au maître de jeu. Les actions Défendre et Subir suivent le réglage du token défenseur sélectionné.

Avant d'utiliser Subir depuis une attaque, cochez dans l'onglet Santé les résistances applicables et, dans l'onglet Combat, les protections couvrant la localisation. Les résistances cochées se cumulent et retirent chacune deux DMG par point. Une protection cochée ne compte que si son intégrité est supérieure à zéro ; le calcul retire alors sa Protection ainsi que la Force finale du défenseur sélectionné.

Le menu Protection de Subir permet d'utiliser les protections cochées ou la protection d'une localisation fixe/personnalisée. Pour l'AB, les résistances retirent un point par point et seule la première protection valide de la liste Combat s'applique, sans la Force ; ordonnez donc les protections de haut en bas selon leur ordre d'impact.