# Ravenous Typst ## Building the master screen Build the four-panel portrait reference screen with: ```sh typst compile master_screen.typ master_screen.pdf ``` Its summaries are declared beside the rules they describe and imported by both the standalone PDF and the `master-screen` chapter of the complete book. Disable that book chapter through the normal `disabled_chapters` configuration. The player-handbook preset excludes it by default. CI encrypts and publishes the standalone screen under the same policy as the other master-facing artifacts. ## Building the master handbook Build the complete master handbook: ```sh typst compile master_handbook.typ master_handbook.pdf ``` To work on one creature without rendering every other bestiary entry, pass its database ID through `creature_id`: ```sh typst compile --input creature_id=3 master_handbook.typ creature-3.pdf ``` The master handbook automatically enables its master-only glossary entries, so no preset argument is required. An unknown ID, or an ID not visible to the master, produces an explicit error. For a persistent local selection, set `build.creature_id` in `data/config/build.yaml`. Keep it as an empty string to render every master-visible creature: ```yaml build: creature_id: "3" ``` To test trusted database markup and glossary evaluation one creature at a time: ```sh tools/check_creature_eval.sh ``` Pass an ID to check only one entry: ```sh tools/check_creature_eval.sh 3 ``` ## Building the master creature balance report Build the standalone creature analysis report with: ```sh typst compile balance_report_master.typ balance_report_master.pdf ``` Its sections are enabled in `data/config/balance_report_master.yaml`. The initial report covers common creature profiles, rewards, and regional difficulty; later creature-specific analyses can be added independently. In CI, this report is handled like the master handbook: Jenkins compiles a temporary plaintext PDF, protects it with `qpdf` and `MASTER_PASSWORD`, deletes the plaintext intermediate, then archives and publishes only `Report/Ravenous_master_balance_report_build.pdf`. The stable deployed path is `Report/Ravenous_master_balance_report.pdf`. The advanced creature-by-creature section reproduces the combat model from `rust_base/monsters` directly in Typst. Configure it in `data/config/balance_report_master.yaml`: ```yaml advanced_balance: creature_ids: [] # Every master-visible creature show_extra: true # Include alternate player stances show_balanced: true # Keep rows already matching their targets ``` `creature_ids` is only a narrowing filter over the master-visible collection. It never overrides `show_to_master`: requesting a hidden or unknown ID cannot make that creature appear in the report. Advanced tables use Typst's natural page flow and repeat their headers automatically; only creature boundaries force a new page. The calculations and presentation are kept in separate modules, so later metrics can reuse the same normalized defense and attack records without changing the report tables. The advanced section also includes an independent heuristic attack diagnosis. It compares success depth and defensive thresholds within each Difficulty, measures one- and two-success damage, estimates the chance of producing enough defensive successes to survive, checks every player stance against an unmitigated hit, and proposes archetypes such as Thrashing, Defense Check, Tank Buster, or Nuke. These inferred labels are shown beside—not substituted for—the attack type declared in the database.