expand-settlement

name	expand-settlement
description	Deep-dive into a settlement, generating NPCs, shops, taverns, districts, local issues, rumors, and daily life details. Use when user wants to "flesh out a city", "populate a town", or "add NPCs to a settlement".
argument-hint	[settlement name or path]

Expand Settlement

Expand this settlement: $ARGUMENTS

Overview

Takes an existing settlement (Village, Town, City, or Stronghold) and populates it with:

1. Named NPCs with roles and personalities
2. Notable establishments (taverns, shops, temples)
3. District/neighborhood definitions (for cities)
4. Local issues, rumors, and plot hooks
5. Daily life and atmosphere details

Instructions

Step 1: Locate and Analyze the Settlement

1. Parse $ARGUMENTS for settlement name or path

2. Search in Worlds/ directories if name provided

3. Read the settlement file and extract:

   • Settlement type (Village/Town/City/Stronghold)
   • Population size
   • Government/leadership
   • Primary industries/purpose
   • Existing NPCs mentioned
   • Cultural flavor
   • Parent region and world

4. Determine expansion scope based on settlement type:

Type	NPCs	Establishments	Districts	Rumors
Village	5-8	2-3	N/A	3-4
Town	10-15	5-8	2-3 informal	5-6
City	15-25	10-15	4-6 formal	8-10
Stronghold	8-12	3-5	N/A (sections)	4-5

Step 2: Present Expansion Plan

Show the user what will be generated:

=== SETTLEMENT EXPANSION: [Settlement Name] ===

Current State:
- Type: [City/Town/Village/Stronghold]
- Population: [X]
- Existing NPCs: [count]
- Existing Establishments: [count]

Proposed Expansion:

1. LEADERSHIP & AUTHORITY ([X] NPCs)
   - [Role 1]: [Brief concept]
   - [Role 2]: [Brief concept]

2. COMMERCE & SERVICES ([X] establishments + NPCs)
   - [Shop type]: [Concept]
   - [Tavern]: [Concept]

3. FAITH & CULTURE ([X] entities)
   - [Temple]: [Deity]
   - [Cultural site]: [Concept]

4. COMMON FOLK ([X] NPCs)
   - [Role]: [Concept]

5. UNDERWORLD ([X] NPCs, if appropriate)
   - [Criminal element]: [Concept]

6. DISTRICTS (if City)
   - [District 1]: [Character]
   - [District 2]: [Character]

7. LOCAL ISSUES & RUMORS ([X] hooks)
   - [Hook 1]
   - [Hook 2]

Proceed with expansion? (yes/customize/skip sections)

Step 3: Generate Leadership & Authority

Based on settlement's government type, create:

For Hereditary Rule:

• Lord/Lady of the settlement (Support Character)
• Steward/Seneschal (Background Character)
• Captain of the Guard (Support Character)
• Court Advisor or Spymaster (Support or Antagonist)

For Elected/Council:

• Mayor/Burgomeister (Support Character)
• Council Members (2-3 Background Characters)
• Town Sheriff (Support Character)

For Theocratic:

• High Priest/Priestess (Support Character)
• Temple Hierarchy (Background Characters)
• Temple Guard Captain (Background Character)

For Military (Stronghold):

• Commander (Support Character)
• Lieutenant(s) (Background Characters)
• Quartermaster (Background Character)
• Scout/Intelligence Officer (Support Character)

For each leader NPC:

1. Read appropriate character template
2. Generate with connections to:
   • The settlement
   • Parent government/organization
   • Other local NPCs (rivals, allies)
   • At least one secret or plot hook
3. Include personality quirks and mannerisms
4. Save to Worlds/[World]/Characters/

Step 4: Generate Commerce & Services

Taverns (1 per village, 2-3 per town, 4-6 per city):

For each tavern:

1. Read Templates/Settlements/Tavern.md
2. Generate with:
   • Unique name reflecting local culture
   • Distinctive atmosphere (rowdy, refined, mysterious, cozy)
   • Proprietor NPC (Support Character)
   • 2-3 regular patrons (Background Characters)
   • Signature food/drink
   • One rumor or plot hook
3. Save to Worlds/[World]/Settlements/
4. Create proprietor NPC, save to Characters/

Shops (scale by settlement size):

Shop Type	Village	Town	City
General Store	1	1	1-2
Blacksmith	0-1	1	2-3
Apothecary	0	1	1-2
Specialty (jeweler, etc.)	0	0-1	2-4
Magic Shop	0	0-1	1-2

For each shop:

1. Read Templates/Settlements/Shop.md
2. Generate with:
   • Unique name
   • Specialty inventory hook
   • Proprietor NPC
   • One interesting customer or supplier connection
3. Save shop and proprietor

Temples (1 per town, 2-4 per city):

1. Read Templates/Settlements/Temple.md
2. Connect to established world deities
3. Generate head priest NPC
4. Include temple services and local significance

Step 5: Generate Common Folk

Create NPCs that give the settlement flavor:

Essential Roles:

• Town crier or gossip
• Street vendor or market regular
• Local drunk or storyteller
• Craftsperson (not shopkeeper)
• Farmer/fisher/miner (based on local industry)

For each:

1. Read Templates/Characters/Background Character.md
2. Generate with:
   • Simple but memorable personality trait
   • One piece of local knowledge
   • Connection to at least one other NPC
   • Potential minor quest hook

Step 6: Generate Underworld (if appropriate)

For Towns and Cities with sufficient population:

Criminal Elements:

• Thieves' Guild contact or fence
• Black market dealer
• Corrupt official
• Gang leader (for larger cities)
• Smuggler (for ports/border towns)

For each:

1. Use Antagonist or Support Character template
2. Connect to any established Criminal Organizations
3. Include their racket/operation
4. Add conflict with law enforcement NPCs

Step 7: Define Districts (Cities Only)

Create 4-6 named districts with distinct character:

Standard District Types:

1. Noble/Palace District - Wealth, guards, exclusive
2. Market/Merchant District - Commerce, crowds, diversity
3. Temple District - Religious, peaceful, pilgrims
4. Docks/Harbor (if coastal) - Rough, foreign, smuggling
5. Craftsmen's Quarter - Industry, guilds, pride
6. Slums/Lower Ward - Poverty, crime, desperation
7. Foreign Quarter - Exotic, cultural, isolated

For each district:

1. Write a section in the settlement file describing:
   • General atmosphere and architecture
   • Dominant population
   • Key establishments located there
   • Typical sights, sounds, smells
   • Common encounters
2. Assign previously created establishments to districts
3. Note district boundaries and transitions

Step 8: Generate Local Issues & Rumors

Create a "Rumors & Hooks" section in the settlement file:

Rumor Types to Include:

1. True Rumor - Leads to actual adventure
2. Partially True - Contains truth but misleading
3. False Rumor - Red herring or gossip
4. Local Politics - About settlement leadership
5. Regional Threat - Connects to wider world
6. Historical Secret - About the settlement's past

Format each as:

### Rumors & Plot Hooks

| # | Rumor | Truth Level | Hook |
|---|-------|-------------|------|
| 1 | "The baker's son..." | True | Missing person quest |
| 2 | "Gold in the old mine..." | Partial | Actually monster lair |
| 3 | "The mayor takes bribes..." | False | Political rival spreading lies |

Local Issues to Address:

• Resource shortage or trade problem
• Criminal activity or corruption
• External threat (monsters, bandits, rival settlement)
• Internal conflict (factions, guilds, families)
• Mystery or haunting
• Festival or upcoming event

Step 9: Add Daily Life Details

Enhance the settlement's Description section with:

Morning:

• What sounds wake residents
• Who's up earliest and why
• Morning markets or routines

Midday:

• Peak activity description
• Common sights in streets
• Where people eat

Evening:

• Tavern atmosphere
• Guard patrol patterns
• Entertainment options

Night:

• Who's out after dark
• Dangers and patrols
• Secret activities

Seasonal Variations:

• Festival days
• Harvest/planting times
• Winter hardships
• Trade season peaks

Step 10: Update Connections

1. Update the settlement file with links to all new entities
2. Update each new NPC with connection to settlement
3. Update each establishment with:
   • Parent settlement link
   • District location (if city)
   • Connected NPCs
4. Update World Overview if settlement is significant
5. Cross-reference new NPCs with existing organizations

Step 11: Summary Report

=== SETTLEMENT EXPANSION COMPLETE: [Name] ===

New Entities Created:

CHARACTERS ([X] total):
Leadership:
- [[NPC 1]] - [Role]
- [[NPC 2]] - [Role]

Commerce:
- [[NPC 3]] - Proprietor of [[Tavern]]
- [[NPC 4]] - Owner of [[Shop]]

Common Folk:
- [[NPC 5]] - [Role]
- [[NPC 6]] - [Role]

Underworld:
- [[NPC 7]] - [Role]

ESTABLISHMENTS ([X] total):
Taverns:
- [[Tavern Name]]

Shops:
- [[Shop 1]]
- [[Shop 2]]

Temples:
- [[Temple Name]]

DISTRICTS DEFINED: [X]
- [District 1] - [brief character]
- [District 2] - [brief character]

RUMORS & HOOKS: [X]
- [Hook 1 summary]
- [Hook 2 summary]

Connection Density:
- Settlement now has [X] outgoing wikilinks
- [X] new entities link back to settlement

Suggested Next Steps:
- Generate images for key NPCs
- Create encounter at [[Location]]
- Expand nearby [[Settlement]] for comparison
- Develop [[NPC]]'s secret plot

Step 12: Offer Follow-up

"Would you like me to:

1. Generate portraits for key NPCs (/generate-image)
2. Create a random encounter set for this settlement
3. Expand a connected settlement
4. Develop a specific NPC's storyline
5. Create a local dungeon or adventure site"

Quality Guidelines

1. Cultural Consistency - Names, customs, and attitudes match the region
2. Economic Logic - Shops and services match population needs
3. Social Stratification - Clear class distinctions where appropriate
4. Internal Conflicts - NPCs have relationships and tensions
5. Adventure Potential - Every section has hooks for gameplay
6. Sensory Details - Include sights, sounds, smells throughout
7. Memorable NPCs - Each has at least one distinctive trait

Examples

# Expand a city with full detail
/expand-settlement Ironhold

# Expand with path
/expand-settlement Worlds/Eldermyr/Settlements/Thornhaven.md

# Expand focusing on specific aspect
/expand-settlement "Riverside" --focus commerce