ravenous_roll20/README.md

3.7 KiB

Ravenous — feuille Roll20

Version actuelle Tests CI Couverture Python

Feuille de personnage française pour jouer à Ravenous dans Roll20. Le dépôt génère la feuille depuis les données épinglées du livre ravenous_typst, ainsi que deux outils web statiques pour l'artisanat et les effets. La génération et les tests locaux sont automatisés ; les comportements qui nécessitent encore une validation dans Roll20 sont suivis dans TASKS.md.

Prérequis

  • Git, Python 3.11 ou plus récent et uv ;
  • une partie Roll20 acceptant une feuille personnalisée ;
  • Node.js uniquement pour les simulations locales des workers et scripts Mod ;
  • un abonnement Roll20 donnant accès aux scripts Mod pour les imports et exports facultatifs.

Installation rapide

Depuis la racine du dépôt :

git submodule update --init --recursive
./scripts/build.sh

Dans l'éditeur de feuille personnalisée Roll20, choisissez le mode CSE actuel, laissez Legacy Sanitization désactivé, puis copiez :

  • build/ravenous.html dans le panneau HTML ;
  • build/ravenous.css dans le panneau CSS ;
  • build/translation.json dans le panneau Traductions.

Ouvrez une fiche dans le Custom Sheet Sandbox. Le résultat attendu est une feuille Ravenous à huit onglets avec caractéristiques calculées, compétences, combat, santé, consommables, écoles, pouvoirs et suivi des effets.

Utilisation

La fiche conserve ses valeurs dans les attributs Roll20. Les jets utilisent la carte de chat Ravenous ; les actions Défendre et Subir demandent le token du défenseur. Les dépenses, PV, intégrité d'armure et effets mécaniques restent manuels.

Les compagnons statiques publiés sont :

Documentation

  • FEATURES.md : comportement attendu et critères d'acceptation ;
  • ARCHITECTURE.md : attributs persistants, formats, flux et frontières entre composants ;
  • docs/development.md : thèmes, tests, couverture, mise à jour du livre et publication ;
  • TASKS.md : validations Roll20 effectuées et travail restant ;
  • AGENTS.md : règles de contribution et matrice complète de vérification.

Développement

Les commandes courantes sont :

./scripts/build.sh
uv run python -m unittest discover -s tests -v
node tests/test_worker.mjs
./scripts/run-python-coverage.sh
./scripts/build.sh --check

La couverture des générateurs Python doit rester au-dessus du seuil de 85 % défini dans .coveragerc. Consultez le guide de développement pour les suites des sites compagnons, les autres tests Node et les contrôles déterministes.

Licence et état du projet

Le code de ce dépôt est distribué sous licence MIT. La feuille reste une version de travail : les tests structuraux et les simulations locales ne remplacent pas une validation dans une vraie partie Roll20. Les limites connues et la procédure de signalement par reproduction sont consignées dans TASKS.md.