| name | augment-world |
| description | Add new content to an existing world pack. Batch add monsters, NPCs, items, locations, and encounters. |
| argument-hint | <world-pack-id> (optional) |
| allowed-tools | ["Task","AskUserQuestion","Glob","Read","Write","mcp__rpg__list_world_packs","mcp__rpg__load_world_summary","mcp__rpg__start_augmentation","mcp__rpg__merge_augmentation","mcp__rpg__get_archetype","mcp__rpg__get_location","mcp__rpg__get_npc","mcp__rpg__get_monster","mcp__rpg__get_item","mcp__rpg__get_encounter"] |
World Augmentation Flow
Guide users through adding new content to existing world packs.
Phase 1: Select World Pack
If no pack ID provided as argument:
- Call
mcp__rpg__list_world_packs() to get available packs
- Use
AskUserQuestion to let user pick:
header: "World Pack"
question: "Which world do you want to add content to?"
options:
- label: "<pack.name>"
description: "<pack.tagline> - <counts summary>"
... for each pack
If pack ID provided, load it directly.
Phase 2: Load World Context
- Call
mcp__rpg__load_world_summary({ packId }) to get current state
- Display current content counts:
Current Content in <world name>:
- Archetypes: X
- Monsters: X
- Items: X
- NPCs: X
- Locations: X
- Encounters: X
Phase 3: Gather Requirements
Use AskUserQuestion to understand what user wants:
Step 1: Content Types
header: "Content Types"
question: "What do you want to add? (select all that apply)"
multiSelect: true
options:
- label: "Monsters"
description: "Enemies, creatures, threats"
- label: "Items"
description: "Weapons, armor, consumables, special items"
- label: "NPCs"
description: "Named characters, merchants, allies, villains"
- label: "Locations"
description: "New places to explore"
- label: "Encounters"
description: "Combat, social, or event encounters"
- label: "Archetypes"
description: "New playable character classes"
Step 2: Quantities
For each selected type, ask:
header: "Monsters"
question: "How many monsters do you want to add?"
options:
- label: "1-2"
description: "A specific threat or pair"
- label: "3-5"
description: "A small faction or group"
- label: "6-10"
description: "A full bestiary expansion"
Step 3: Theme (Optional)
header: "Theme"
question: "Is there a theme or focus for this content?"
options:
- label: "No specific theme"
description: "General content fitting the world"
- label: "Location-based"
description: "Content for a specific area"
- label: "Faction-based"
description: "Content tied to a group or organization"
- label: "Custom theme"
description: "Describe your own focus"
If location-based, show existing locations to choose from.
If custom, prompt for description.
Phase 4: Generate Content
- Call
mcp__rpg__start_augmentation with the gathered request:
mcp__rpg__start_augmentation({
packId: "<id>",
request: {
monsters: 3,
items: 5,
npcs: 2,
encounters: 2
},
theme: "ice-themed dungeon",
locationContext: "location:frozen-caverns"
})
-
The tool returns prompts for each content type.
-
For each prompt, launch a content-generator agent in PARALLEL:
Task(subagent_type: "rpg:content-generator",
prompt: "Generate augmentation content. Pack: <packId>. Type: monsters.
SYSTEM:
<prompt.system>
USER:
<prompt.user>
Output the JSON directly. Do not wrap in markdown.",
run_in_background: false)
IMPORTANT: Launch ALL generators in a SINGLE message to run in parallel.
- Collect results from all generators.
Phase 5: Review Content
Present generated content for review:
Generated Content:
MONSTERS (3):
- Frost Wraith (elite) - Spectral ice elemental
- Ice Spider (standard) - Giant crystalline arachnid
- Snow Stalker (minion) - Pack hunting predator
ITEMS (5):
- Frostbite Blade (weapon) - Deals cold damage
- Glacier Shield (armor) - +2 armor, cold resistance
- ...
NPCs (2):
- Eira the Ice Witch - Exiled mage seeking redemption
- Jorik Coldblood - Barbarian guide who knows the caves
ENCOUNTERS (2):
- Ambush at the Ice Bridge - Combat with Snow Stalkers
- The Frozen Bargain - Social with Eira
Ask for confirmation:
header: "Confirm"
question: "Add this content to the world pack?"
options:
- label: "Yes, add all"
description: "Merge everything into the world"
- label: "Regenerate"
description: "Try again with different results"
- label: "Cancel"
description: "Don't add anything"
Phase 6: Merge Content
- Call
mcp__rpg__merge_augmentation with all generated content:
mcp__rpg__merge_augmentation({
packId: "<id>",
content: {
monsters: [...],
items: [...],
npcs: [...],
encounters: [...]
},
autoLink: true
})
- Report results:
Added to <world name>:
- 3 monsters
- 5 items
- 2 NPCs
- 2 encounters
New totals:
- Monsters: 12 → 15
- Items: 20 → 25
- NPCs: 8 → 10
- Encounters: 10 → 12
NPCs auto-linked to locations.
Encounters auto-linked to locations.
Phase 7: Continue or Done
header: "Continue"
question: "What would you like to do next?"
options:
- label: "Add more content"
description: "Continue augmenting this world"
- label: "View content"
description: "Look at what was added"
- label: "Done"
description: "Finish augmentation"
If "Add more content", return to Phase 3.
If "View content", use get_* tools to show details.
Content Integration
When autoLink: true:
- NPCs with
locations array → added to those locations' NPC lists
- Encounters with
locationId → added to that location's encounter list
- New monsters referenced in encounters → validated against existing + new monsters
This creates a cohesive expansion where content is properly connected.
Error Handling
- If pack not found: "World pack '' not found. Use /augment-world to see available packs."
- If generation fails: Offer to retry that specific content type
- If merge fails due to ID collision: Report which IDs conflict, offer to regenerate
Tips for Good Augmentation
- Themed batches work best - "Ice dungeon content" produces more coherent results than random additions
- Include encounters with monsters - Monsters without encounters are less useful
- NPCs need locations - Always specify where NPCs can be found
- Build on existing content - Reference existing factions, locations, NPCs in themes