dndwright 0.2.0__py3-none-any.whl

dndwright/__init__.py

@@ -0,0 +1,69 @@
+"""dndwright — a domain-neutral D&D 5e (2024) rules & character-computation engine.
+
+A character sheet is modelled as a **directed acyclic computation graph**: nodes
+are values, edges are dependencies, and formulas are *data* (a JSON-serialisable
+DSL), not code. The engine is pure (pydantic + stdlib) — no application or
+framework coupling — so any tool can map its own character data in and read
+computed stats out.
+
+Quickstart (one call — dict in, computed sheet out):
+
+    from dndwright import evaluate_character
+    sheet = evaluate_character({
+        "ability_scores": {"strength": 8, "dexterity": 14, "constitution": 14,
+                            "intelligence": 18, "wisdom": 12, "charisma": 10},
+        "class_data": {"class_name": "wizard"},
+        "species_data": {"name": "Human", "speed": 30},
+        "level": 5,
+    })
+    sheet["proficiency_bonus"]   # 3
+    sheet["ability_modifiers"]   # {"intelligence": 4, ...}
+
+Lower level (assemble typed inputs, evaluate against the ruleset):
+
+    from dndwright import (DND_5E_2024_RULESET, assemble_character_inputs,
+                           evaluate, apply_modifiers)
+    from dndwright.rules.components import ClassMechanics
+    inputs = assemble_character_inputs(class_mechanics=..., ability_scores={...}, level=5)
+    computed = apply_modifiers(evaluate(DND_5E_2024_RULESET, inputs), inputs)
+
+The rules tables (hit dice, spell slots, armour AC, save proficiencies) encode
+game mechanics derived from the **D&D SRD 5.2 (CC-BY-4.0)** — see NOTICE.
+"""
+
+from .content import categories, generate_library, load_content
+from .ontology import Ontology, load_ontology
+from .rules.adapters import character_data_to_inputs, computed_values_to_sheet
+from .rules.assembler import apply_modifiers, assemble_character_inputs
+from .rules.character_evaluator import compute_key_stats, evaluate_character
+from .rules.dnd_5e_2024 import DND_5E_2024_RULESET
+from .rules.evaluator import evaluate
+from .rules.schema import ComputationNode, FormulaSpec, NodeType, Ruleset
+
+__version__ = "0.3.0"
+
+__all__ = [
+    # high-level (dict in -> computed sheet out)
+    "evaluate_character",
+    "compute_key_stats",
+    # ruleset + low-level evaluation
+    "DND_5E_2024_RULESET",
+    "evaluate",
+    "assemble_character_inputs",
+    "apply_modifiers",
+    # neutral adapters
+    "character_data_to_inputs",
+    "computed_values_to_sheet",
+    # schema types
+    "Ruleset",
+    "ComputationNode",
+    "FormulaSpec",
+    "NodeType",
+    # component ontology (graph schema)
+    "load_ontology",
+    "Ontology",
+    # content (bundled starter + generator)
+    "load_content",
+    "categories",
+    "generate_library",
+]

dndwright/content/__init__.py

@@ -0,0 +1,56 @@
+"""Bundled starter content + a generator for original homebrew.
+
+    from dndwright.content import load_content, categories
+    load_content("creatures")   # list of creature dicts (bundled samples)
+    categories()                # ["classes", "creatures", "magic_items", "species"]
+
+The bundled ``classes`` / ``species`` / ``creatures`` are original homebrew (no
+official content); ``magic_items`` are SRD 5.2 (CC-BY) — see NOTICE. Grow the
+library with :func:`generate_library` (you supply the LLM).
+"""
+
+from __future__ import annotations
+
+import importlib.resources
+import json
+
+from .generate import (
+    JsonLLM,
+    generate_classes,
+    generate_creatures,
+    generate_library,
+    generate_species,
+)
+
+# category -> (filename, top-level array key)
+_CONTENT = {
+    "classes": ("classes.json", "classes"),
+    "species": ("species.json", "species"),
+    "creatures": ("creatures.json", "creatures"),
+    "magic_items": ("magic_items.json", "magic_items"),
+}
+
+
+def categories() -> list[str]:
+    """The bundled content categories."""
+    return sorted(_CONTENT)
+
+
+def load_content(category: str) -> list[dict]:
+    """Load the bundled starter content for ``category`` as a list of dicts."""
+    if category not in _CONTENT:
+        raise ValueError(f"unknown category {category!r}; choose from {categories()}")
+    filename, key = _CONTENT[category]
+    text = (importlib.resources.files("dndwright.content") / filename).read_text(encoding="utf-8")
+    return json.loads(text).get(key, [])
+
+
+__all__ = [
+    "load_content",
+    "categories",
+    "generate_library",
+    "generate_classes",
+    "generate_species",
+    "generate_creatures",
+    "JsonLLM",
+]

dndwright/content/classes.json

@@ -0,0 +1,147 @@
+{
+  "metadata": {
+    "source": "dndwright original homebrew",
+    "license": "Original content — not derived from any copyrighted RPG product.",
+    "note": "Sample starter content; generate more with dndwright.content.generate."
+  },
+  "classes": [
+    {
+      "name": "Echo-Binder",
+      "mechanics": {
+        "hit_die": "d8",
+        "primary_ability": "CHA",
+        "saving_throws": [
+          "CHA",
+          "INT"
+        ],
+        "spellcasting_type": "full",
+        "key_features": [
+          "Resonant Tether",
+          "Harmonic Mimicry",
+          "Sonic Feedback",
+          "Shatter-Point Focus"
+        ]
+      },
+      "narrative": {
+        "description": "Echo-Binders capture the lingering vibrations of historical events and reality itself to weave them into offensive spells. They manipulate the soundscapes of combat to disrupt enemies and amplify their own presence.",
+        "role": "Controller/Support",
+        "flavor": "Every silence has a story, and I am the one who makes it scream."
+      }
+    },
+    {
+      "name": "Kinetics-Smith",
+      "mechanics": {
+        "hit_die": "d10",
+        "primary_ability": "STR",
+        "saving_throws": [
+          "STR",
+          "CON"
+        ],
+        "spellcasting_type": "none",
+        "key_features": [
+          "Momentum Storage",
+          "Inertia Plating",
+          "Impact Discharge",
+          "Velocity Strike"
+        ]
+      },
+      "narrative": {
+        "description": "These warriors wear heavy, specialized armor designed to absorb and store the kinetic energy of incoming blows. They release this stored force in devastating, explosive counter-attacks that can shatter stone.",
+        "role": "Frontline Tank",
+        "flavor": "Hit me harder; you are only fueling my next strike."
+      }
+    },
+    {
+      "name": "Vellum-Weaver",
+      "mechanics": {
+        "hit_die": "d6",
+        "primary_ability": "INT",
+        "saving_throws": [
+          "INT",
+          "WIS"
+        ],
+        "spellcasting_type": "full",
+        "key_features": [
+          "Ink-Skin Calligraphy",
+          "Living Manuscript",
+          "Paper-Slide Mobility",
+          "Scripted Reality"
+        ]
+      },
+      "narrative": {
+        "description": "Vellum-Weavers treat the fabric of the world as a blank page, using enchanted inks to inscribe reality-altering runes directly onto the air or their own skin. They command shifting geometries and constructs birthed from written logic.",
+        "role": "Utility/Blaster",
+        "flavor": "History is not written by the victors, it is written by those who know how to edit."
+      }
+    },
+    {
+      "name": "Soul-Sifter",
+      "mechanics": {
+        "hit_die": "d8",
+        "primary_ability": "WIS",
+        "saving_throws": [
+          "WIS",
+          "CHA"
+        ],
+        "spellcasting_type": "half",
+        "key_features": [
+          "Ethereal Sieve",
+          "Spirit-Dust Extraction",
+          "Vestige Manifestation",
+          "Ancestral Tether"
+        ]
+      },
+      "narrative": {
+        "description": "Soul-Sifters act as conduits for the residual spiritual energy left behind by the departed. By filtering this energy through a spectral tool, they can briefly manifest the skills or memories of those long gone.",
+        "role": "Utility/Support",
+        "flavor": "The dead have so much to say if you simply know how to filter the noise."
+      }
+    },
+    {
+      "name": "Cinder-Gardener",
+      "mechanics": {
+        "hit_die": "d10",
+        "primary_ability": "CON",
+        "saving_throws": [
+          "CON",
+          "DEX"
+        ],
+        "spellcasting_type": "none",
+        "key_features": [
+          "Ash-Bloom Cultivation",
+          "Emberskin Growth",
+          "Root-Fire Entanglement",
+          "Coal-Heart Resilience"
+        ]
+      },
+      "narrative": {
+        "description": "These survivalists cultivate symbiotic relationships with magical, fire-consuming flora that thrives in arid or destroyed landscapes. They heal themselves and trap foes using blackened thorns and smoldering pollen.",
+        "role": "Defender/Controller",
+        "flavor": "From the ashes of the world, I grow the beauty that will consume you."
+      }
+    },
+    {
+      "name": "Void-Strider",
+      "mechanics": {
+        "hit_die": "d8",
+        "primary_ability": "DEX",
+        "saving_throws": [
+          "DEX",
+          "CHA"
+        ],
+        "spellcasting_type": "pact",
+        "key_features": [
+          "Phase-Shift Step",
+          "Vacuum Edge",
+          "Null-Space Pocket",
+          "Shadow-Stutter"
+        ]
+      },
+      "narrative": {
+        "description": "Void-Striders navigate the thin, freezing gaps between dimensions, using these shortcuts to teleport and reposition instantly. They wield weapons forged from the absolute cold and silence of the void.",
+        "role": "Striker/Skirmisher",
+        "flavor": "I am not moving; I am simply deciding where the world should keep me."
+      }
+    }
+  ]
+}

dndwright/content/creatures.json

@@ -0,0 +1,334 @@
+{
+  "metadata": {
+    "source": "dndwright original homebrew",
+    "license": "Original content — not derived from any copyrighted RPG product.",
+    "note": "Sample starter content; generate more with dndwright.content.generate."
+  },
+  "creatures": [
+    {
+      "name": "Gliss-Tick",
+      "size": "Tiny",
+      "creature_type": "beast",
+      "alignment": "unaligned",
+      "cr": "1/8",
+      "hp": 4,
+      "ac": 13,
+      "speed": "10 ft., climb 20 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 2,
+          "dex": 17,
+          "con": 10,
+          "int": 2,
+          "wis": 12,
+          "cha": 4
+        },
+        "actions": [
+          "Bite: +5 to hit, 1 piercing damage",
+          "Adhesive Secretion: Target must succeed on a DC 10 Strength save or have speed reduced by 10 feet"
+        ],
+        "traits": [
+          "Spider Climb: The creature can climb difficult surfaces"
+        ]
+      }
+    },
+    {
+      "name": "Vellocite Swarmer",
+      "size": "Small",
+      "creature_type": "monstrosity",
+      "alignment": "neutral evil",
+      "cr": "1/2",
+      "hp": 22,
+      "ac": 14,
+      "speed": "30 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 10,
+          "dex": 16,
+          "con": 12,
+          "int": 6,
+          "wis": 11,
+          "cha": 8
+        },
+        "actions": [
+          "Razor Claw: +5 to hit, 6 slashing damage",
+          "Pack Tactics: Advantage on attack rolls if an ally is within 5 feet"
+        ],
+        "traits": [
+          "Frenzy Reflexes: Can take the Disengage action as a bonus action"
+        ]
+      }
+    },
+    {
+      "name": "Amber-Wisp",
+      "size": "Medium",
+      "creature_type": "elemental",
+      "alignment": "neutral",
+      "cr": "1",
+      "hp": 30,
+      "ac": 15,
+      "speed": "0 ft., fly 40 ft. (hover)",
+      "stat_block": {
+        "abilities": {
+          "str": 6,
+          "dex": 18,
+          "con": 12,
+          "int": 10,
+          "wis": 14,
+          "cha": 12
+        },
+        "actions": [
+          "Sear: +6 to hit, 9 fire damage",
+          "Flashblind: Creatures within 10 feet must succeed on a DC 12 Constitution save or be blinded until the end of their next turn"
+        ],
+        "traits": [
+          "Illumination: Sheds bright light in a 20-foot radius"
+        ]
+      }
+    },
+    {
+      "name": "Thrum-Carapace",
+      "size": "Large",
+      "creature_type": "construct",
+      "alignment": "lawful neutral",
+      "cr": "3",
+      "hp": 65,
+      "ac": 17,
+      "speed": "20 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 18,
+          "dex": 8,
+          "con": 16,
+          "int": 5,
+          "wis": 10,
+          "cha": 6
+        },
+        "actions": [
+          "Slam: +6 to hit, 13 bludgeoning damage",
+          "Resonating Pulse: Creatures within 15 feet must succeed on a DC 13 Constitution save or take 7 thunder damage"
+        ],
+        "traits": [
+          "Immutable Form: Immune to any spell or effect that would alter its form"
+        ]
+      }
+    },
+    {
+      "name": "Mycelian Weaver",
+      "size": "Large",
+      "creature_type": "plant",
+      "alignment": "chaotic neutral",
+      "cr": "5",
+      "hp": 90,
+      "ac": 14,
+      "speed": "30 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 16,
+          "dex": 14,
+          "con": 18,
+          "int": 12,
+          "wis": 15,
+          "cha": 10
+        },
+        "actions": [
+          "Spore Lash: +6 to hit, 14 slashing damage plus 7 poison damage",
+          "Entangling Growth: Targets within 20 feet must succeed on a DC 14 Strength save or be restrained"
+        ],
+        "traits": [
+          "Regeneration: Regains 5 hit points at the start of its turn if it is in contact with soil"
+        ]
+      }
+    },
+    {
+      "name": "Void-Stalker Maw",
+      "size": "Huge",
+      "creature_type": "aberration",
+      "alignment": "chaotic evil",
+      "cr": "8",
+      "hp": 125,
+      "ac": 16,
+      "speed": "40 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 20,
+          "dex": 12,
+          "con": 18,
+          "int": 8,
+          "wis": 14,
+          "cha": 16
+        },
+        "actions": [
+          "Bite: +8 to hit, 18 piercing damage",
+          "Gravity Well: Targeted creature must succeed on a DC 15 Strength save or be pulled 30 feet toward the Maw"
+        ],
+        "traits": [
+          "Magic Resistance: Advantage on saving throws against spells and other magical effects"
+        ]
+      }
+    },
+    {
+      "name": "Kril-Sliver",
+      "size": "Tiny",
+      "creature_type": "monstrosity",
+      "alignment": "unaligned",
+      "cr": "1/8",
+      "hp": 7,
+      "ac": 14,
+      "speed": "20 ft., climb 20 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 4,
+          "dex": 18,
+          "con": 10,
+          "int": 3,
+          "wis": 12,
+          "cha": 6
+        },
+        "actions": [
+          "Bite: +6 to hit, reach 5 ft., 1 piercing damage.",
+          "Phase Shift: The creature turns invisible until the end of its next turn."
+        ],
+        "traits": [
+          "Evasion: Takes no damage on successful Dexterity saves."
+        ]
+      }
+    },
+    {
+      "name": "Vex-Bloom",
+      "size": "Small",
+      "creature_type": "plant",
+      "alignment": "neutral",
+      "cr": "1/2",
+      "hp": 22,
+      "ac": 12,
+      "speed": "5 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 10,
+          "dex": 14,
+          "con": 14,
+          "int": 6,
+          "wis": 15,
+          "cha": 10
+        },
+        "actions": [
+          "Pollen Burst: Each creature within 10 ft. must succeed on a DC 12 Constitution saving throw or be poisoned for 1 minute.",
+          "Root Lash: +4 to hit, reach 10 ft., 5 bludgeoning damage."
+        ],
+        "traits": [
+          "False Appearance: While motionless, it looks like a normal flowering shrub."
+        ]
+      }
+    },
+    {
+      "name": "Cinder-Husk",
+      "size": "Medium",
+      "creature_type": "elemental",
+      "alignment": "chaotic neutral",
+      "cr": "1",
+      "hp": 30,
+      "ac": 13,
+      "speed": "30 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 14,
+          "dex": 16,
+          "con": 12,
+          "int": 8,
+          "wis": 10,
+          "cha": 10
+        },
+        "actions": [
+          "Searing Touch: +5 to hit, reach 5 ft., 7 fire damage.",
+          "Ignite: The Cinder-Husk targets one flammable object and sets it on fire."
+        ],
+        "traits": [
+          "Death Burst: When the husk dies, it explodes in a 5 ft. radius for 2d6 fire damage."
+        ]
+      }
+    },
+    {
+      "name": "Gloom-Strider",
+      "size": "Large",
+      "creature_type": "aberration",
+      "alignment": "neutral evil",
+      "cr": "3",
+      "hp": 45,
+      "ac": 15,
+      "speed": "40 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 16,
+          "dex": 14,
+          "con": 15,
+          "int": 10,
+          "wis": 12,
+          "cha": 8
+        },
+        "actions": [
+          "Shadow Claw: +5 to hit, reach 10 ft., 12 slashing damage.",
+          "Terrifying Gaze: Target must succeed on a DC 13 Wisdom saving throw or be frightened for 1 minute."
+        ],
+        "traits": [
+          "Shadow Stealth: Can hide as a bonus action in dim light or darkness."
+        ]
+      }
+    },
+    {
+      "name": "Ion-Shell Sentinel",
+      "size": "Large",
+      "creature_type": "construct",
+      "alignment": "lawful neutral",
+      "cr": "5",
+      "hp": 68,
+      "ac": 18,
+      "speed": "20 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 20,
+          "dex": 8,
+          "con": 18,
+          "int": 4,
+          "wis": 10,
+          "cha": 5
+        },
+        "actions": [
+          "Slam: +8 to hit, reach 5 ft., 18 bludgeoning damage.",
+          "Lightning Discharge: Recharge 5-6, 30 ft. line, 24 lightning damage (DC 15 Dex save for half)."
+        ],
+        "traits": [
+          "Magic Resistance: Advantage on saving throws against spells."
+        ]
+      }
+    },
+    {
+      "name": "Skyshard Weaver",
+      "size": "Huge",
+      "creature_type": "fey",
+      "alignment": "chaotic good",
+      "cr": "8",
+      "hp": 110,
+      "ac": 16,
+      "speed": "10 ft., fly 50 ft.",
+      "stat_block": {
+        "abilities": {
+          "str": 18,
+          "dex": 20,
+          "con": 16,
+          "int": 14,
+          "wis": 16,
+          "cha": 18
+        },
+        "actions": [
+          "Multiattack: Makes two crystalline claw attacks.",
+          "Crystalline Claw: +8 to hit, reach 10 ft., 16 slashing damage.",
+          "Prism Pulse: Each creature in 20 ft. radius must succeed on DC 15 Con save or be blinded until end of next turn."
+        ],
+        "traits": [
+          "Reflective Carapace: Any spell targeting the weaver has a 25% chance to reflect back at the caster."
+        ]
+      }
+    }
+  ]
+}