From 3c492467c4d067d6be6fd10b0f8d5d706eea5b47 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sun, 23 Aug 2026 19:44:49 +0200 Subject: [PATCH] Player handbook --- Readme.md | 14 ++++ chapters/origines.typ | 143 +++++++++++++++++++---------------- chapters/schools/schools.typ | 52 ++++++++++--- data/config/build.yaml | 8 ++ player_handbook.typ | 12 ++- setup/build_config.typ | 11 +++ setup/models/origin.typ | 6 +- setup/setup.typ | 1 + 8 files changed, 164 insertions(+), 83 deletions(-) diff --git a/Readme.md b/Readme.md index 187af43..d1106eb 100644 --- a/Readme.md +++ b/Readme.md @@ -38,6 +38,20 @@ typst compile --input preset=player-handbook \ player_handbook.typ player-handbook-classes.pdf ``` +`origin-lore` and `origin-artwork` are content-level switches. They do not +create table-of-contents chapters, but control the lore quotations and images +inside `origins`. The player preset hides `origin-lore` by default. For example: + +```sh +typst compile --input disabled_chapters=origin-artwork \ + player_handbook.typ player-handbook-without-origin-art.pdf +``` + +When using the `chapters` allow-list, include `origin-artwork` alongside +`origins` if images should be retained. `origin-lore` can likewise be selected +in the full book or a custom preset; the standard player preset deliberately +keeps it disabled. + The preset can be combined with independent origin and school selectors: ```sh diff --git a/chapters/origines.typ b/chapters/origines.typ index f4b05d3..f9eba6a 100644 --- a/chapters/origines.typ +++ b/chapters/origines.typ @@ -1,77 +1,86 @@ #import "/setup/models/origin.typ": creature-title, render-creature -#import "/setup/setup.typ": build-config, origin-enabled, theme -//----- DOCUMENT ----- -== Origines +#import "/setup/setup.typ": build-config, chapter-enabled, origin-enabled, theme +#let render-origins( + show-lore: chapter-enabled("origin-lore"), + show-artwork: chapter-enabled("origin-artwork"), +) = [ + //----- DOCUMENT ----- + = Origines -Chaque chasseur porte dans son sang l'empreinte d'une calamité. -Cette ascendance, que l'on nomme son _origine_, ne désigne ni le lieu de sa naissance, ni sa culture, ni l'école de combat dans laquelle il a été formé : -elle révèle la puissance inhumaine qui nourrit sa marque et façonne peu à peu son corps, ses instincts et ses pouvoirs. + Chaque chasseur porte dans son sang l'empreinte d'une calamité. + Cette ascendance, que l'on nomme son _origine_, ne désigne ni le lieu de sa naissance, ni sa culture, ni l'école de combat dans laquelle il a été formé : + elle révèle la puissance inhumaine qui nourrit sa marque et façonne peu à peu son corps, ses instincts et ses pouvoirs. -Une origine définit les limites naturelles du chasseur ainsi que les dons qui s'éveillent aux différents stades d'évolution de sa marque. -Deux descendants d'une même calamité peuvent pourtant manifester cet héritage de façons radicalement différentes. -Certains en reproduisent la majesté, d'autres la cruauté, la faim ou les aspects les plus étranges ; mais aucun n'est condamné à partager la volonté de son géniteur. + Une origine définit les limites naturelles du chasseur ainsi que les dons qui s'éveillent aux différents stades d'évolution de sa marque. + Deux descendants d'une même calamité peuvent pourtant manifester cet héritage de façons radicalement différentes. + Certains en reproduisent la majesté, d'autres la cruauté, la faim ou les aspects les plus étranges ; mais aucun n'est condamné à partager la volonté de son géniteur. -Les pages suivantes présentent les entitée accessibles aux joueurs et joueuses dequels ces dernier pourront incarner des scions. -Choisir l'un d'eux revient à choisir la forme prise par cet héritage : ses caractéristiques maximum à la création, ses aptitudes fondamentales et les transformations qui accompagneront son ascension. -// Ce choix est définitif, mais il ne dicte ni la personnalité du personnage, ni ses alliances, ni ce qu'il décidera de devenir. -#pagebreak() + Les pages suivantes présentent les entitée accessibles aux joueurs et joueuses dequels ces dernier pourront incarner des scions. + Choisir l'un d'eux revient à choisir la forme prise par cet héritage : ses caractéristiques maximum à la création, ses aptitudes fondamentales et les transformations qui accompagneront son ascension. + // Ce choix est définitif, mais il ne dicte ni la personnalité du personnage, ni ses alliances, ni ce qu'il décidera de devenir. + #pagebreak() -// ---- AUTO IMPORT ---- -#let origins = ( - ("Abyssal", "abyssal", 2), - ("Baloth", "baloth", 2), - ("Béhémoth", "behemoth", 2), - ("Céléstial", "celestial", 2), - ("Djieien", "djieien", 2), - ("Dragon", "dragon", 2), - ("Fenrir", "fenrir", 2), - ("Guivre", "guivre", 2), - ("Kraken", "kraken", 2), - ("Léviathan", "leviathan", 2), - ("Roc", "roc", 2), - ("Tréant", "treant", 2), - ("Yénuï", "yenui", 2), -) + // ---- AUTO IMPORT ---- + #let origins = ( + ("Abyssal", "abyssal", 2), + ("Baloth", "baloth", 2), + ("Béhémoth", "behemoth", 2), + ("Céléstial", "celestial", 2), + ("Djieien", "djieien", 2), + ("Dragon", "dragon", 2), + ("Fenrir", "fenrir", 2), + ("Guivre", "guivre", 2), + ("Kraken", "kraken", 2), + ("Léviathan", "leviathan", 2), + ("Roc", "roc", 2), + ("Tréant", "treant", 2), + ("Yénuï", "yenui", 2), + ) -#let origin-ids = origins.fold((), (ids, origin) => { - let slug = origin.at(1) - let count = origin.at(2) - ids + range(1, count + 1).map(i => slug + "_" + str(i)) -}) -#assert( - build-config.origin == "" or build-config.origin in origin-ids, - message: "Unknown origin selector: " + build-config.origin, -) + #let origin-ids = origins.fold((), (ids, origin) => { + let slug = origin.at(1) + let count = origin.at(2) + ids + range(1, count + 1).map(i => slug + "_" + str(i)) + }) + #assert( + build-config.origin == "" or build-config.origin in origin-ids, + message: "Unknown origin selector: " + build-config.origin, + ) -#for (name, slug, count) in origins { - let selected-variants = range(1, count + 1).filter(i => ( - origin-enabled(slug + "_" + str(i)) - )) + #for (name, slug, count) in origins { + let selected-variants = range(1, count + 1).filter(i => ( + origin-enabled(slug + "_" + str(i)) + )) - if selected-variants.len() == 0 { - continue + if selected-variants.len() == 0 { + continue + } + + show heading: it => { + align(center)[#text( + size: creature-title.size, + weight: creature-title.weight, + fill: creature-title.fill, + )[#it.body] + #v(3pt) + #text( + size: creature-title.symbol-size, + fill: creature-title.symbol-fill, + )[ + #theme.section-symbol + ]] + } + heading(level: 2)[#name] + + for i in selected-variants { + render-creature( + yaml("/data/src/origines/" + slug + "_" + str(i) + ".yaml"), + show-fluff: show-lore, + show-artwork: show-artwork, + ) + pagebreak() + } } +] - show heading: it => { - align(center)[#text( - size: creature-title.size, - weight: creature-title.weight, - fill: creature-title.fill, - )[#it.body] - #v(3pt) - #text( - size: creature-title.symbol-size, - fill: creature-title.symbol-fill, - )[ - #theme.section-symbol - ]] - } - heading(level: 2)[#name] - - for i in selected-variants { - render-creature( - yaml("/data/src/origines/" + slug + "_" + str(i) + ".yaml"), - ) - pagebreak() - } -} +#render-origins() diff --git a/chapters/schools/schools.typ b/chapters/schools/schools.typ index 822583a..393d4e3 100644 --- a/chapters/schools/schools.typ +++ b/chapters/schools/schools.typ @@ -1,4 +1,4 @@ -#import "/setup/setup.typ": ddlvl, ravhelp, build-config, school-enabled +#import "/setup/setup.typ": build-config, ddlvl, ravhelp, school-enabled #let school-ids = ( "heavy-weapon-specialist", @@ -99,13 +99,43 @@ Il est à noter que si une technique donne un effet sans préciser une limite de #pagebreak() -#if school-enabled("heavy-weapon-specialist") { include "heavy_weapon_specialist.typ"; pagebreak() } -#if school-enabled("einerjar") { include "einerjar.typ"; pagebreak() } -#if school-enabled("franc-tireur") { include "franc_tireur.typ"; pagebreak() } -#if school-enabled("protecteur") { include "protecteur.typ"; pagebreak() } -#if school-enabled("lancier") { include "lancier.typ"; pagebreak() } -#if school-enabled("maitre-lames") { include "maitre_lames.typ"; pagebreak() } -#if school-enabled("artilleur") { include "artilleur.typ"; pagebreak() } -#if school-enabled("mage-bestial") { include "mage_bestial.typ"; pagebreak() } -#if school-enabled("guerrier-mage") { include "guerrier_mage.typ"; pagebreak() } -#if school-enabled("sangremage") { include "sangremage.typ"; pagebreak() } +#if school-enabled("heavy-weapon-specialist") { + include "heavy_weapon_specialist.typ" + pagebreak() +} +#if school-enabled("einerjar") { + include "einerjar.typ" + pagebreak() +} +#if school-enabled("franc-tireur") { + include "franc_tireur.typ" + pagebreak() +} +#if school-enabled("protecteur") { + include "protecteur.typ" + pagebreak() +} +#if school-enabled("lancier") { + include "lancier.typ" + pagebreak() +} +#if school-enabled("maitre-lames") { + include "maitre_lames.typ" + pagebreak() +} +#if school-enabled("artilleur") { + include "artilleur.typ" + pagebreak() +} +#if school-enabled("mage-bestial") { + include "mage_bestial.typ" + pagebreak() +} +#if school-enabled("guerrier-mage") { + include "guerrier_mage.typ" + pagebreak() +} +#if school-enabled("sangremage") { + include "sangremage.typ" + pagebreak() +} diff --git a/data/config/build.yaml b/data/config/build.yaml index 55b4498..638ccf0 100644 --- a/data/config/build.yaml +++ b/data/config/build.yaml @@ -64,10 +64,18 @@ presets: player-handbook: disabled_chapters: + - presentation + - hunters-and-calamities - acknowledgements - geography - game-master-help - bestiary + - rules + # Content-level switches (they do not create standalone chapters). + - origin-lore + # - origin-artwork + - races + - creation master_only: false player_only: true book_only: false diff --git a/player_handbook.typ b/player_handbook.typ index b9fe6fc..43452e3 100644 --- a/player_handbook.typ +++ b/player_handbook.typ @@ -1,10 +1,13 @@ // Player-facing handbook. The preset is supplied by the build command so the // same chapter-selection machinery remains available to every entry point. #import "/setup/setup.typ": ( - build-config, chapter-enabled, config_main, disable-warnings, theme, + build-config, config_main, disable-warnings, player-chapter-enabled, theme, ) +#import "/chapters/origines.typ": render-origins #show: config_main +#let chapter-enabled = player-chapter-enabled + #if not build-config.warnings { disable-warnings() } // A dedicated cover keeps this artifact distinct from the complete rulebook. @@ -29,7 +32,12 @@ #if chapter-enabled("hunters-and-calamities") { include "chapters/hunters_and_calamities.typ" } -#if chapter-enabled("origins") { include "chapters/origines.typ" } +#if chapter-enabled("origins") { + render-origins( + show-lore: chapter-enabled("origin-lore"), + show-artwork: chapter-enabled("origin-artwork"), + ) +} #if chapter-enabled("schools") { include "chapters/schools/schools.typ" } #if chapter-enabled("crafting") { include "chapters/artisanat.typ" } #if chapter-enabled("races") { include "chapters/races.typ" } diff --git a/setup/build_config.typ b/setup/build_config.typ index a139e38..1589593 100644 --- a/setup/build_config.typ +++ b/setup/build_config.typ @@ -11,6 +11,8 @@ "hunters-and-calamities", "origins", "schools", "crafting", "races", "rules", "creation", "character_sheet", "experience-gains", "game-master-help", "bestiary", + // Content-level switches: validated like chapters without creating headings. + "origin-lore", "origin-artwork", ) #let comma-list(value) = value.split(",").map(item => item.trim()).filter(item => item != "") @@ -35,6 +37,7 @@ #let preset-disabled-chapters = presets.at(selected-preset).disabled_chapters #let preset-master-only = presets.at(selected-preset).at("master_only", default: false) +#let preset-player-only = presets.at(selected-preset).at("player_only", default: false) #let disabled-chapters = ( raw-build-config.disabled_chapters + preset-disabled-chapters + input-disabled-chapters ).dedup() @@ -53,6 +56,7 @@ warnings: raw-build-config.warnings, preset: selected-preset, master-only: preset-master-only, + player-only: preset-player-only, origin: selected-origin, school: selected-school, theme: selected-theme, @@ -69,6 +73,13 @@ id not in disabled-chapters and (selected-chapters.len() == 0 or id in selected-chapters) ) +#let player-disabled-chapters = presets.at("player-handbook").disabled_chapters +#let player-chapter-enabled(id) = ( + chapter-enabled(id) and id not in player-disabled-chapters + // The character sheet currently links directly into the rules chapter. + // Keep the player build valid when that chapter is intentionally omitted. + and (id != "character_sheet" or "rules" not in player-disabled-chapters) +) #let origin-enabled(id) = selected-origin == "" or selected-origin == id #let school-enabled(id) = selected-school == "" or selected-school == id diff --git a/setup/models/origin.typ b/setup/models/origin.typ index 07cd648..6666545 100644 --- a/setup/models/origin.typ +++ b/setup/models/origin.typ @@ -303,7 +303,7 @@ //----- CREATURE ----- -#let render-creature(data) = { +#let render-creature(data, show-fluff: true, show-artwork: true) = { show heading: it => { align(center)[#text( size: creature-title.size, @@ -320,7 +320,7 @@ } heading(level: 3, data.name) v(creature-spacing.section) - if data.fluff != none [ + if show-fluff and data.fluff != none [ #fluff( data.fluff.text, data.fluff.author, @@ -328,7 +328,7 @@ #v(creature-spacing.section) ] - if data.image != none [ + if show-artwork and data.image != none [ #align(center)[ #block( clip: true, diff --git a/setup/setup.typ b/setup/setup.typ index c0366e8..955dd93 100644 --- a/setup/setup.typ +++ b/setup/setup.typ @@ -19,6 +19,7 @@ #let build-config = build_config.build-config #let max-tier-exclusive = build_config.max-tier-exclusive #let chapter-enabled = build_config.chapter-enabled +#let player-chapter-enabled = build_config.player-chapter-enabled #let origin-enabled = build_config.origin-enabled #let school-enabled = build_config.school-enabled #let gls = model.gls