Roll20 character sheet & macros
Go to file
Dandaedre 5ad0c75233
Roll20 Sheet Build Successful The Ravenous Roll20 sheet was generated and validated successfully.
Ravenous/ravenous_roll20/pipeline/head This commit looks good Details
docs: streamline README and usage guides
2026-10-04 03:58:12 +02:00
assets Adds a mascot 2026-09-19 07:25:58 +02:00
craft_web ci: publish Ravenous assets under assets mount 2026-10-04 03:37:07 +02:00
docs docs: streamline README and usage guides 2026-10-04 03:58:12 +02:00
effects_web feat: add static effects library helper 2026-09-20 04:37:13 +02:00
ravenous_typst@c47e56d8f8 feat: add craft imports and skill subtabs 2026-09-19 06:37:29 +02:00
roll20_mod feat: add effects exchange controls 2026-09-20 04:44:12 +02:00
scripts ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
src feat: add effects exchange controls 2026-09-20 04:44:12 +02:00
tests ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
tools feat: render Ravenous references in exports 2026-09-19 21:24:44 +02:00
.coveragerc ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
.gitignore ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
.gitmodules Update sm 2026-08-27 20:41:02 +02:00
AGENTS.md ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
ARCHITECTURE.md ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
FEATURES.md ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
Jenkinsfile ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
LICENSE Initial commit 2026-08-26 22:08:01 +02:00
README.md docs: streamline README and usage guides 2026-10-04 03:58:12 +02:00
TASKS.md docs: streamline README and usage guides 2026-10-04 03:58:12 +02:00
pyproject.toml ci: add Python coverage badges 2026-10-04 03:47:37 +02:00
uv.lock ci: add Python coverage badges 2026-10-04 03:47:37 +02:00

README.md

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.