Roll20 character sheet & macros
Go to file
Dandaedre a0402183f5
Roll20 Sheet Build Successful The Ravenous Roll20 sheet was generated and validated successfully.
Ravenous/ravenous_roll20/pipeline/head This commit looks good Details
Added macro & fixed most appearance
2026-09-01 19:30:56 +02:00
build Added macro & fixed most appearance 2026-09-01 19:30:56 +02:00
ravenous_typst@3b6d2f746b Bouilde 2026-08-27 20:37:21 +02:00
scripts Made things 2026-08-27 20:39:13 +02:00
src Added macro & fixed most appearance 2026-09-01 19:30:56 +02:00
tests Added macro & fixed most appearance 2026-09-01 19:30:56 +02:00
tools Added macro & fixed most appearance 2026-09-01 19:30:56 +02:00
.gitignore Made things 2026-08-27 20:39:13 +02:00
.gitmodules Update sm 2026-08-27 20:41:02 +02:00
Jenkinsfile Made things 2026-08-27 20:39:13 +02:00
LICENSE Initial commit 2026-08-26 22:08:01 +02:00
README.md Added macro & fixed most appearance 2026-09-01 19:30:56 +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 défenses sous forme de sections répétables et de jets 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/. 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.