src/content.py

"""Page copy: how-to, article sections, example, methodology, FAQs. One H1 lives in the hero."""

HOW_TO_HTML = """
<p>This free <strong>DnD monster builder</strong> creates a complete custom creature
for D&amp;D 5e and the 2024 (5.5e) rules — not just numbers, but a monster with an
identity, a full stat block, named traits and actions, and tactics that tell you how
to actually run it. Describe a concept in a sentence, or pick nothing at all and let
it surprise you. Everything runs right on this page, free, with no signup.</p>
<ol>
<li><strong>Describe the concept.</strong> One evocative sentence is enough — "a
lantern-lit crab that collects drowned sailors' memories" gives the builder more to
work with than three paragraphs of stats ever could. Every field is optional.</li>
<li><strong>Set the frame.</strong> Pick a challenge rating target, size, creature
type, and combat role if you have opinions; leave blanks where you don't. The Surprise
Me button rolls a buildable combination for you.</li>
<li><strong>Build.</strong> You get a classic stat-block layout: lore, AC, hit points,
speed, ability scores, defenses, traits, actions — plus a tactics section and loot.</li>
<li><strong>Refine or regenerate.</strong> Adjust any field and run it again, then
copy or download the result as Markdown for your prep notes or VTT.</li>
</ol>
"""

INCLUDES_HTML = """
<p>A stat block alone doesn't make a monster runnable. Every build here returns the
pieces you need at the table, and each one earns its place:</p>
<ul>
<li><strong>Name and identity line</strong> — size, type, and alignment in the
official stat-block format, ready to drop into your notes.</li>
<li><strong>Lore</strong> — one to two paragraphs of description and ecology, so you
can narrate the monster before initiative is rolled and answer "what do we know about
these things?" when the ranger asks.</li>
<li><strong>Armor Class, Hit Points, and Speed</strong> — the survival math. Hit
points come with the dice formula so you can roll or average them.</li>
<li><strong>Ability scores</strong> — with modifiers precomputed, because every
grapple check and ability contest at the table starts here.</li>
<li><strong>Saves, skills, and defenses</strong> — resistances, immunities, and
vulnerabilities spelled out, so you're not deciding mid-round whether fire works.</li>
<li><strong>Senses and languages</strong> — including passive Perception, which
decides whether your ambush plan survives contact with the party's rogue.</li>
<li><strong>Challenge line</strong> — CR, XP value, and proficiency bonus together,
for encounter budgeting.</li>
<li><strong>Traits and actions</strong> — one to four named traits and two to five
actions written in rules language, with attack bonuses and save DCs that follow from
the ability scores.</li>
<li><strong>Tactics</strong> — the section most generators skip: how the monster
opens, who it targets, what it does when bloodied, and when it runs. You can run the
creature on sight instead of reverse-engineering its design mid-combat.</li>
<li><strong>Loot</strong> — what the party actually finds on the corpse or in the
lair, so the fight ends with a discovery instead of a shrug.</li>
</ul>
"""

EXAMPLE_INTRO_HTML = """
<p>Here is a complete, unedited output from this builder. The inputs were: concept
"a lantern-lit crab that collects drowned sailors' memories", CR 3, Large,
Monstrosity, Lurker — everything else left blank.</p>
"""

METHODOLOGY_HTML = """
<p>When you set a challenge rating target, the builder designs inside that CR's
expected band rather than inventing numbers freely. The bands come from the Dungeon
Master's Guide monster-building guidance, cross-referenced against how published
monsters actually land: each CR implies a range for armor class, hit points, attack
bonus, save DCs, and damage per round. A CR 3 creature, for example, is built toward
roughly AC 13-14, hit points in the 50s to 70s as published CR 3 monsters typically
show, an attack bonus around +4 to +5, save DCs near 13, and 700 XP — which is
exactly the shape of the example above.</p>
<p>The builder also keeps the numbers internally consistent: the hit-point dice
formula averages to the stated total, attack bonuses and DCs are derived from the
ability scores plus the proficiency bonus in the challenge line, and the XP value
matches the CR. Traits that make a monster effectively tougher or deadlier — like an
incapacitating aura on a lurker — are paid for elsewhere in the block.</p>
<p>Two honest caveats. First, CR has always been an estimate, even in official books:
a monster's real difficulty depends on party composition, terrain, and how you play
it. Second, this is an AI builder — the output is tuned to your target CR, but you
should sanity-check it at the table. Cross-check anything that will anchor a whole
session against the DMG's table of monster statistics by CR, and adjust hit points or
damage up or down after the first round or two of play. That is exactly how
professional designers tune monsters too.</p>
"""

FAQS = [
    (
        "How do you make a custom monster in D&D 5e?",
        "Start with a concept and a role, not with numbers: what the creature is, "
        "what it wants, and how it fights. Then pick a challenge rating and use the "
        "DMG's monster statistics table to set AC, hit points, attack bonus, and "
        "save DCs inside that CR's band. Add one to four traits that express the "
        "concept mechanically, write its actions, and decide its tactics before the "
        "session. This builder runs that whole process in one pass — describe the "
        "concept, set the frame, and it produces the identity, stat block, and "
        "tactics together.",
    ),
    (
        "How do I pick a challenge rating?",
        "For a single monster fighting a whole party, a CR near the party's level "
        "is a solid fight and CR at level-plus-two-or-three is dangerous. For "
        "groups of monsters, budget with the encounter-building rules rather than "
        "adding CRs together — four CR 1 creatures are far deadlier than one CR 4. "
        "When in doubt, build one CR lower than you think you want; it is much "
        "easier to add hit points mid-fight than to un-kill a character.",
    ),
    (
        "Can I use homebrew monsters in official adventures?",
        "Yes — DMs swap and reskin monsters in published adventures constantly. "
        "The cleanest method is to build your custom creature at the same CR as the "
        "monster it replaces, so the adventure's encounter math still holds. Keep "
        "the original's narrative function (guard, ambusher, boss) and let your "
        "creature's flavor and tactics change the scene.",
    ),
    (
        "How is this different from a stat block generator?",
        "A stat block generator formats an existing concept — you bring the "
        "monster, it arranges the numbers. This builder creates the whole thing: "
        "the concept and lore, the mechanics, and the tactics for running it. You "
        "can hand it nothing but a one-line idea (or nothing at all) and get back a "
        "creature with an identity, a consistent stat block, and instructions for "
        "how it fights.",
    ),
    (
        "Can it make legendary monsters?",
        "Ask for it: set a high CR target and put \"legendary boss with legendary "
        "actions and legendary resistance\" in the extra notes. The builder will "
        "include legendary mechanics in the traits and actions. For a boss "
        "fighting an entire party alone, that request matters — action economy, "
        "not raw numbers, is what makes solo monsters survive round one.",
    ),
    (
        "Can I edit the result?",
        "You should. Copy the Markdown or download the .md file and adjust "
        "anything — most DMs tune hit points and damage after seeing the first "
        "round of a fight, which is normal monster design, not a failure. You can "
        "also change one input field and regenerate for a fresh take on the same "
        "concept.",
    ),
    (
        "Does it work for the 2024 (5.5e) rules?",
        "Yes. The stat-block format here — identity line, AC, hit points with dice "
        "formula, ability scores, traits, and actions — reads correctly under both "
        "D&D 5e (2014) and the 2024 revision, and monsters are broadly compatible "
        "across the two. If your table uses the 2024 rules, note that its official "
        "monsters trend slightly stronger at a given CR, so err toward the tougher "
        "end when you sanity-check the numbers.",
    ),
    (
        "Do I need an account or payment to use this?",
        "No. The builder is free, runs directly on this page, and requires no "
        "signup. There is a fair-use hourly limit per visitor so the tool stays "
        "available for everyone.",
    ),
]