95 lines
5.2 KiB
Markdown
95 lines
5.2 KiB
Markdown
## Introduction
|
|
Vous trouverez ici la feuille de personnage type pour le système D10. Cette feuille a été crée pour fonctionner avec Roll20.
|
|
|
|
## Macros roll20
|
|
Peuvent etre utile a modifier ou récuperer:
|
|
- ```Life_Points / Life_Points_maximum``` : Points de Vie
|
|
- ```Endurance_Points / Endurance_Points_maximum``` : Points de fatigue
|
|
- ```general_item_weapon1``` : La valeur de dégats de l'arme 1
|
|
- ```general_item_weapon1_name``` : Le nom de l'arme 1
|
|
- ```general_effective_weapon1``` : La valeur de dégats de l'arme 1 si elle est activée; 0 sinon
|
|
- ```base_damage_dices``` : La base de dégats offensif (a priori, rien sauf compétence particulière)
|
|
- ```exal_damage_dices``` : Le modificateur de dégats (Un bonus de charge, un buff de dégats temporaires)
|
|
|
|
Exemple (avec chatSetAttr) [chatSetAttr](https://github.com/Roll20/roll20-api-scripts/blob/master/ChatSetAttr/README.md):
|
|
- ```!setattr --sel --Life_Points|21```
|
|
- ```!setattr --set --mod --Life_Points|-5```
|
|
- ```!setattr --name Basil --general_item_weapon1|55```
|
|
|
|
## HTML
|
|
- Ne pas utiliser d'ID, seulement des classes. Il y a en effet
|
|
plusieurs copies de la feuille lors d'une partie, l'utilisation d'ID
|
|
pourra par conséquent entraîner des comportements inattendus.
|
|
|
|
## CSS
|
|
- La feuille complète est contenue dans une grande div
|
|
```.charsheet```, pour éviter d'appliquer le CSS au reste de roll20.
|
|
Le CSS sera modifié en conséquence lors de l'import.
|
|
- Lors de
|
|
l'import, toutes les classes qui ne sont pas préfixées de
|
|
```shield```, ```roll_``` ou ```repeating_``` seront préfixées de
|
|
```sheet-```. Il faut donc prévoir le CSS en conséquence.
|
|
|
|
##### Ces informations proviennent de la doc Roll20, et plus particulièrement de la page [Building Character Sheet](https://wiki.roll20.net/Building_Character_Sheets).
|
|
|
|
## Générateur YAML (base et cyberpunk)
|
|
|
|
La nouvelle génération utilise uniquement les variantes **base** et **cyberpunk**.
|
|
Les anciennes feuilles à la racine restent comme références pour les attributs
|
|
Roll20 et les règles qui ne sont pas encore modélisées. Le dossier
|
|
`model_ravenous_roll20/` est une référence de méthode, sans contenu Ravenous
|
|
importé dans la feuille D10.
|
|
|
|
Installer PyYAML dans un environnement virtuel puis construire :
|
|
|
|
```sh
|
|
python -m venv .venv
|
|
.venv/bin/python -m pip install -r requirements.txt
|
|
.venv/bin/python tools/build.py --variant base --theme parchment
|
|
.venv/bin/python tools/build.py --variant cyberpunk --theme night
|
|
.venv/bin/python tools/build.py --list-themes
|
|
.venv/bin/python tools/build.py --variant cyberpunk --theme night --check
|
|
.venv/bin/python -m unittest discover -s tests -v
|
|
```
|
|
|
|
Chaque commande produit `sheet.html`, `sheet.css`, `translation.json`,
|
|
`sheet.json` et `build-info.json` dans `build/<variant>/<theme>/`. Le dossier
|
|
peut être changé avec `--output-dir`. Copier HTML, CSS et traduction dans les
|
|
onglets correspondants de l'éditeur de feuille personnalisée Roll20.
|
|
`sheet.json` sert de manifeste pour un dépôt de feuilles; `build-info.json`
|
|
indique la variante, le thème, le nombre de compétences et une empreinte.
|
|
`--check` compare les fichiers existants sans les réécrire.
|
|
|
|
Les compétences fixes sont dans `data/base_skills.yaml` et
|
|
`data/cyberpunk_skills.yaml`. Le premier reprend les compétences de combat
|
|
nommées dans la feuille de base; la feuille de base conserve aussi des lignes
|
|
libres. Le second est issu du catalogue `helpers/cyberpunk2.txt` de
|
|
`origin/cyberpunk-latest` (153 compétences), comparé à `origin/cyberpunk`.
|
|
Les sections, champs et variantes sont définis dans `data/sheet_model.yaml`;
|
|
les palettes sont dans `data/themes.yaml`. Ajouter une compétence ne demande
|
|
pas de modifier le code Python. Les identifiants sont stables et validés avant
|
|
la génération. Le changement de thème ne change que les couleurs et la classe
|
|
racine du HTML.
|
|
|
|
### Compatibilité et limites
|
|
|
|
La nouvelle feuille conserve les noms des caractéristiques, des ressources,
|
|
des compétences fixes de combat de base et de plusieurs champs d'armes. La
|
|
variante cyberpunk conserve les noms de compétences de l'ancien générateur et
|
|
les PV/protection/intégrité par localisation. Les sections répétables sont
|
|
reconstruites à partir du modèle; les lignes déjà stockées sous un autre nom
|
|
de section ne migrent pas automatiquement. La feuille précédente comportait
|
|
aussi des macros `!crit` et des calculs de combat complexes; le nouveau build
|
|
ne les appelle pas. Les boutons de jet de la nouvelle feuille utilisent un
|
|
seuil moins un dé et affichent le résultat via un roll template. Les valeurs
|
|
avancées de combat et les comportements des scripts Mod restent dans les
|
|
anciennes sources tant qu'ils n'ont pas de modèle D10 vérifié.
|
|
|
|
Les tests locaux valident les quatre combinaisons variante/thème, les
|
|
références d'attribut dans les jets, les couleurs, les identifiants et le build
|
|
reproductible. Ils ne simulent pas le parseur de dés, l'affichage ou la
|
|
sauvegarde de Roll20. Dans le Custom Sheet Sandbox, charger chaque variante,
|
|
ajouter une ligne répétable, lancer les jets, sauvegarder et rouvrir deux
|
|
personnages. La [documentation officielle Roll20](https://help.roll20.net/hc/en-us/categories/360003756473-Sheet-Development)
|
|
décrit l'éditeur et les limitations des feuilles personnalisées.
|