---

name: dialogue-quest-system description: "Complete dialogue and quest system with branching conversations, quest stages, and event triggers." version: 1.0.0 tags: ["gameplay", "dialogue", "quests", "NPCs", "narrative"] argument-hint: "action='create_quest' name='Kill10Rats' stages='Accept,InProgress,Complete'" disable-model-invocation: false user-invocable: true allowed-tools:

• run_command
• list_dir
• write_to_file

---

Dialogue Quest System

Overview

Complete dialogue and quest system with branching conversations, multiple quest stages, objectives, rewards, and event-driven progression.

When to Use

• Use when implementing NPC conversations
• Use when creating branching dialogue
• Use when tracking quest progress
• Use when implementing objectives (kill X, collect Y)
• Use when rewarding quest completion

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    DialogueSO                               │
├─────────────────────────────────────────────────────────────┤
│  DialogueNode[] (Speaker, Text, Choices)                    │
│  Conditions (RequiredQuest, MinLevel)                       │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                     QuestSO                                 │
├─────────────────────────────────────────────────────────────┤
│  Stages: NotStarted → InProgress → Completed                │
│  Objectives: [{Type, Target, Count}]                        │
│  Rewards: [Item, XP, Gold]                                  │
└─────────────────────────────────────────────────────────────┘

Quest States

• NotStarted: Quest available but not accepted
• InProgress: Quest active, tracking objectives
• Completed: All objectives done, rewards pending
• TurnedIn: Rewards collected, quest finished
• Failed: Quest failed (optional)

Objective Types

• Kill: Kill X enemies of type Y
• Collect: Obtain X items
• Interact: Talk to NPC, use object
• Reach: Arrive at location
• Escort: Keep NPC alive to destination

Best Practices

• ✅ Use ScriptableObjects for dialogue/quest data
• ✅ Implement ISaveable for quest progress
• ✅ Use events for objective updates
• ✅ Support quest prerequisites
• ❌ NEVER hardcode dialogue text
• ❌ NEVER forget to save quest state

Few-Shot Examples

Example 1: Kill Quest

User: "Quest to kill 10 wolves."

Agent:

// QuestSO asset with objective:
// Type: Kill, TargetId: "wolf", RequiredCount: 10
// Reward: 100 gold, 50 XP

Example 2: Dialogue Choice

User: "NPC offers two quest paths."

Agent:

DialogueNode choice = new()
{
    Speaker = "Elder",
    Text = "Which path will you take?",
    Choices = new[] 
    {
        { Text = "The Mountains", NextNode = mountainQuestNode },
        { Text = "The Forest", NextNode = forestQuestNode }
    }
};

Related Skills

• @save-load-serialization - Persist quest progress
• @inventory-crafting-logic - Quest rewards
• @scriptableobject-architecture - Data patterns

Template Files

Available in templates/ folder.