Roll20 character sheet & macros
Go to file
Dandaedre ec78f6dee5
Bouilde
2026-08-27 20:37:21 +02:00
ravenous_typst@3b6d2f746b Bouilde 2026-08-27 20:37:21 +02:00
.gitmodules Bouilde 2026-08-27 20:37:21 +02:00
LICENSE Initial commit 2026-08-26 22:08:01 +02:00
README.md Bouilde 2026-08-27 20:37:21 +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 ;
  • 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

GitHub Actions reconstruit la feuille, exécute les tests, vérifie que build/ est à jour, puis publie le dossier comme artefact ravenous-roll20-sheet. Le dossier peut être servi tel quel sous https://books.dandaedre.com/ravenous_sheet/; les fichiers de la feuille n'exigent actuellement aucun asset externe au site.

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.