107 lines
4.6 KiB
Markdown
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.
|