ravenous_roll20/README.md

107 lines
4.6 KiB
Markdown

# Ravenous — feuille Roll20
Feuille de personnage Roll20 générée depuis les données du livre
[`ravenous_typst`](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 :
```sh
git submodule update --init --recursive
```
Puis construire avec `uv` (aucun `pip` global n'est utilisé) :
```sh
./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 :
```sh
./scripts/build.sh --check
```
## Mise à jour depuis le livre
```sh
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.
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.