|
Roll20 Sheet Build Successful The Ravenous Roll20 sheet was generated and validated successfully.
Ravenous/ravenous_roll20/pipeline/head This commit looks good
Details
|
||
|---|---|---|
| ravenous_typst@3e1310d2f0 | ||
| scripts | ||
| src | ||
| tests | ||
| tools | ||
| .gitignore | ||
| .gitmodules | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| pyproject.toml | ||
| uv.lock | ||
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.cssettranslation.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 captureravenous.pngdevra 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.