From dm-game
Quest structure, branching narrative architecture, environmental storytelling, dialogue design, and narrative pacing. Use when designing quest systems, writing branching dialogue, structuring story arcs, when narrative feels disconnected from gameplay, when players skip cutscenes, when story contradicts mechanics, or when quests feel like checklists instead of journeys. Treats narrative as a GAME SYSTEM that interacts with other systems — not a layer painted on top. Deepens experience-design's brief Narrative Integration section into full quest architecture, branching patterns, player agency, and narrative health evaluation.
npx claudepluginhub rbergman/dark-matter-marketplace --plugin dm-gameThis skill uses the workspace's default tool permissions.
**Purpose:** Tools for designing narrative as a functioning game system — quests, branching stories, dialogue, and environmental storytelling that interact with mechanics rather than sitting alongside them. Narrative is how mechanics acquire meaning. This skill treats it with the same structural rigor as combat or economy.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Purpose: Tools for designing narrative as a functioning game system — quests, branching stories, dialogue, and environmental storytelling that interact with mechanics rather than sitting alongside them. Narrative is how mechanics acquire meaning. This skill treats it with the same structural rigor as combat or economy.
Position in workflow: Narrative design interacts with nearly every other system. Use game-vision to establish core fantasy and pillars first. Then use this skill to design quests, story structure, and dialogue that serve those pillars. Fan out to encounter-design for spatial narrative, economy-design for reward flow, and motivation-design for retention psychology.
Use this skill when:
Narrative is not a layer on top of mechanics. It is a system that interacts with other systems.
Quests and story interact with every major game system:
| System | Interaction | Example |
|---|---|---|
| Economy | Quest rewards flow through currency/item systems | Quest reward is crafting materials, not a unique item that bypasses the economy |
| Progression | Quests grant XP, unlock abilities, gate content | Story progression unlocks gameplay progression (new area = new abilities) |
| Encounter design | Quests create encounter context | "Defend the village" reframes the same combat encounter with stakes |
| Social systems | Quests build NPC relationships, faction standing | Choosing a faction in a quest closes doors with the opposing faction |
| Exploration | Quests motivate traversal, reward discovery | Investigation quests turn exploration from wandering into purpose |
Story creates CONTEXT that makes mechanical actions meaningful.
Context is the cheapest way to increase perceived value of existing mechanics. Before adding new systems, ask: can narrative context make what we already have feel more meaningful?
If the story says one thing and the mechanics reward another, players follow the mechanics and resent the story. This is non-negotiable.
| Story Says | Mechanics Reward | Result |
|---|---|---|
| "Peace is the answer" | Combat XP is the fastest progression | Players kill everything and mock the pacifist theme |
| "Time is running out" | No actual time pressure | Players explore leisurely and lose immersion |
| "This choice matters" | Both paths lead to identical outcomes | Players feel deceived and disengage from future choices |
| "You are a lone wanderer" | Optimal play requires a full party | Fantasy is broken by mechanical requirement |
Rule: When story and mechanics conflict, either change the story or change the mechanics. Never leave the conflict and hope players won't notice. They will.
Narrative is the bridge between Fiction and Mechanics in the Experience Triangle (see experience-design). When that bridge is broken, the triangle collapses.
Common quest types, their strengths, and how to subvert their weaknesses:
| Type | Structure | Strength | Weakness | Subversion Technique |
|---|---|---|---|---|
| Fetch/Gather | Go to X, collect Y, return | Simple, teaches exploration | Repetitive, no decisions | Destination is dangerous, or the item has a moral cost |
| Escort | Protect NPC from A to B | Creates tension, attachment | Frustrating AI, pacing loss | Give the NPC agency — they help you, not just follow |
| Investigation | Gather clues, reach conclusion | Engages reasoning, rewards attention | Can stall if clues are missed | Multiple valid conclusions from the same evidence |
| Combat Challenge | Defeat X enemies/boss | Tests core combat skills | Can feel arbitrary | Combat with constraints — protect something, time limit, limited resources |
| Puzzle | Solve environmental/logical challenge | Mental engagement, "aha" moments | Can block progress permanently | Escalating hint system, multiple solution paths |
| Social/Dialogue | Navigate conversation, build relationships | Character depth, emotional engagement | Can feel passive | Dialogue as mechanic — what you say has gameplay consequences |
The best quests combine 2-3 types. A pure fetch quest is boring. A fetch quest that requires investigation to find the item and combat to retrieve it is a journey.
Design rule: When a quest uses only one type, it is a task. When it layers types, it becomes a story. Aim for at least two types per non-trivial quest.
A quest chain should vary its types across entries:
Quest 1: Investigation (low intensity, learn the stakes)
Quest 2: Fetch + Combat (rising action, resource gathering under pressure)
Quest 3: Social/Dialogue (emotional beat, key NPC relationship)
Quest 4: Escort + Combat (climax, protect what you've built)
Quest 5: Choice (resolution, player decides outcome)
Repeating the same type across a chain is the fastest way to make players lose interest.
Quests should stress multiple game systems to create depth and meaningful decisions.
For every quest, ask: which systems does this quest touch?
| Systems Touched | Assessment | Example |
|---|---|---|
| 1 system | Shallow — task, not quest | "Kill 10 wolves" (combat only) |
| 2 systems | Adequate — functional quest | "Kill wolves threatening the farm, choose reward" (combat + economy) |
| 3+ systems | Rich — memorable quest | "Track wolves to their den (exploration), fight the alpha (combat), discover they were fleeing something worse (narrative hook), choose whether to report to the farmer or the ranger (faction + economy)" |
Quest rewards should flow THROUGH the economy system, not bypass it.
Principle: If quest rewards are the best way to get everything, the economy system is dead. Rewards should supplement the economy, not replace it.
How to structure player choice in story at a sustainable scale.
| Architecture | Structure | Complexity | Replayability | Best For |
|---|---|---|---|---|
| Linear | A then B then C | Minimal | None | Tightly authored emotional arcs |
| Branching | Tree — choices split into separate paths | Exponential (unsustainable at scale) | High but very expensive | Short-form or critical moments |
| Hub/Diamond | Choices diverge then converge at key nodes | Manageable | Moderate — different paths to same destination | Most games, most of the time |
| Parallel | Multiple independent storylines running simultaneously | Moderate per line | Mix and match across playthroughs | Open-world, faction-based |
| Reactive | Single path but world reacts to choices | Moderate | World feels different, events feel similar | Best ROI for most games |
Full branching at every decision point doubles content production at each branch. Three binary choices create 8 endpoints. Five create 32. This is unsustainable for any team.
Hub/diamond is the most sustainable architecture for most games. Paths diverge after choices but converge at key story nodes, keeping total content manageable while preserving the feeling of consequence.
Reactive narrative provides the best return on investment. The story follows one path, but the world reacts — NPCs comment on your choices, environments change, minor characters appear or disappear. The player feels their choices matter without requiring exponentially branching content.
Before designing branching content, establish a budget:
Total narrative content units available: [N]
Critical path content: [C] (must ship)
Branch content budget: [N - C]
Maximum branch depth per decision: [usually 2-3]
Convergence frequency: [every 2-3 decisions]
If the branch budget is tight, invest in reactive details (NPC barks, environmental changes, dialogue acknowledgments) rather than full alternate paths. Small acknowledgments of player choices have outsized impact on perceived agency.
The tension between authored story and player freedom.
| End | Gives | Sacrifices |
|---|---|---|
| Full authorship | Emotional craft — controlled pacing, reveals, climaxes | Player ownership — the story is delivered, not co-created |
| Full agency | Player ownership — "my story, my choices" | Emotional craft — pacing and impact are unpredictable |
Most games live somewhere in the middle. The design question is WHERE on this spectrum to sit, not which end to choose.
| Technique | How It Works | When to Use |
|---|---|---|
| Constrained agency | Player chooses HOW, designer controls WHAT | The problem is scripted, but the solution is player-driven |
| Consequential agency | Choices feel significant even when outcomes converge | Limited branch budget, but player needs to feel ownership |
| Character agency | Player shapes WHO they are, not just WHAT happens | RPGs, relationship-driven games, alignment systems |
| Expressive agency | Player's choices reflect personality without changing plot | Dialogue tone, visual customization, play style |
The key question: does the player feel like they are telling their own story?
If yes, agency is working — regardless of actual branch complexity. A reactive narrative with strong acknowledgment can feel more agentive than a fully branched tree where the player doesn't see the consequences.
Anti-pattern: Giving players choices and then ignoring them. If you present a choice, the game must react. Even a single line of NPC dialogue acknowledging the choice is better than silence.
Deeper treatment complementing encounter-design's spatial narrative coverage.
| Technique | Method | Example |
|---|---|---|
| Space-as-narrative | The journey through an environment tells a story through its direction and progression | Ascending = hope, descending = dread, returning to a transformed space = growth |
| Found storytelling | Objects in context imply events without words | A broken sword next to a skeleton. A child's toy in an abandoned fortress. |
| Layered time | Evidence of past events in the present environment | Craters, ruins, overgrown paths, repaired walls, fresh flowers on an old grave |
| Contrast storytelling | Something that doesn't belong draws attention and implies a story | A pristine room in a ruined building. A weapon in a nursery. |
| Player-constructed narrative | Environment provides fragments; the player assembles meaning | Journals, environmental clues, NPC rumors that connect into a picture the game never explicitly states |
Reward attention, never require it. Environmental storytelling should enrich the experience for observant players without blocking progress for inattentive ones. If a player must find the hidden journal to understand the plot, the in-game storytelling has failed.
Discovered stories feel owned. When a player pieces together a story from environmental clues, they feel like a detective, not an audience. This creates investment because the narrative feels discovered rather than delivered.
Layer density with player path. Main paths should have lighter environmental storytelling (a few clear signals). Optional paths should be denser (full stories told through objects and space). This rewards exploration without overwhelming the critical path.
How story pacing interacts with gameplay pacing.
Story beats should align with gameplay intensity curves. The narrative rhythm and the mechanical rhythm should breathe together.
Intensity
| /\ /\ /\
| / \ /\ / \/ \ ← gameplay intensity
| / \/ \/ \___
| /
| /
+---------------------------→ Time
Setup Rising Climax Rest
↑ ↑ ↑ ↑
Lore Stakes Payoff Reflect ← narrative beats
| Rule | Guideline | Why |
|---|---|---|
| Cutscene length budget | Players tolerate ~30 seconds of non-interactive content without restlessness | Longer requires strong emotional investment already established |
| The earned cutscene | Cinematic moments feel rewarding AFTER a challenge, patronizing BEFORE one | Post-challenge cutscenes feel like payoff; pre-challenge ones feel like interruption |
| Dialogue frequency | Too much = players skip; too little = world feels empty | Calibrate to gameplay rhythm — more in valleys, less in peaks |
| Narrative density | Story-heavy zones should alternate with mechanics-heavy zones | Constant narrative is exhausting; constant mechanics is meaningless |
| Encoding time | After a major story revelation, give the player mechanical space to process | Don't stack revelations — let each one land before the next |
Brevity. Every line must earn its space. If it can be cut without losing meaning, cut it. Dialogue that respects the player's time earns their attention for the moments that matter.
Character voice. Distinct characters should sound different even without name labels. Vocabulary, sentence length, rhythm, formality, and what they choose NOT to say all contribute.
Subtext over text. Characters who say exactly what they mean are flat. Characters who say one thing while meaning another are interesting. Let the player read between the lines.
| Approach | Player Experience | Best For |
|---|---|---|
| Silent protagonist | Player projects their own personality onto the character | Immersive sims, exploration games, games where the player IS the character |
| Voiced protagonist | Authored character with personality — player guides, doesn't define | Narrative-driven games with a specific story to tell |
| Choice-voiced | Player shapes personality through dialogue selection | RPGs, relationship-driven games, games about identity |
When what you say has gameplay consequences, dialogue becomes a system rather than flavor:
Dialogue-as-mechanic turns conversations into encounters with stakes, preparation, and outcomes. This transforms dialogue from something players click through into something they engage with.
| Guideline | Rule |
|---|---|
| Length | Keep under 5 seconds of audio / 10 words of text |
| Variety | Minimum 5 variations per trigger condition |
| Context | Lines should reflect current game state (health, threat level, environment) |
| Repetition | Never repeat the same bark within 60 seconds |
| Personality | Even short lines should reflect character voice |
Run before shipping or at milestone reviews.
| Anti-Pattern | Description | Fix |
|---|---|---|
| Ludonarrative dissonance | Story says peace, gameplay rewards violence; story says urgency, mechanics allow leisure | Align story themes with mechanical incentives — or change one |
| The info dump | Front-loaded exposition before the player has context to care | Distribute lore across gameplay; reveal information when the player needs it |
| Unskippable cutscenes | Player loses control without opting in | Players should always be able to skip or fast-forward; never punish them for it |
| Quest log as story | If the player needs to read a journal to understand the plot, in-game storytelling has failed | The story should be comprehensible from gameplay alone; logs supplement, not replace |
| Branch explosion | Full branching at every choice point — unsustainable content production | Use hub/diamond architecture; invest in reactive details over full alternate paths |
| Dead-end dialogue | Conversation trees where most options lead to the same response | Every dialogue option should produce a meaningfully different response, even if outcomes converge |
| The invisible choice | Player makes a decision without realizing it was a decision | Telegraph choices clearly — ambiguity about whether agency is present destroys trust |
| Narrative tourism | Story exists in a separate layer that gameplay never touches | Narrative must interact with mechanics — use quest-as-system-interaction patterns |