1010 B
Agent guide: Ravenous Effects Library
This folder builds a dependency-free static helper for browsing Ravenous
alterations, assembling reusable effect libraries, and exporting them for the
Roll20 sheet. The pinned ravenous_typst/data/src/glossaries/alterations.yaml
file is authoritative. Do not hand-edit generated files in build/.
The site is generated with Python 3.11+, uses no runtime services or CDN, and
stores private sets and custom effects only in browser local storage. Render
imported/user text with DOM text APIs. Keep the ravenous-roll20-effects v1
contract backward compatible and target repeating_sharedeffects, not active
repeating_modifiers rows.
Build and verify with:
uv run python effects_web/tools/build.py
uv run python -m unittest discover -s effects_web/tests -v
uv run python effects_web/tools/build.py --check
Reuse the sheet's theme parser, Typst translator, and conservative reminder inference. Unknown durations remain manual; never invent a game rule.