spawn_populated_location
Generate complete RPG locations with rooms, inhabitants, and loot in a single API call to streamline world-building and reduce token usage.
Instructions
Create a complete location with POI, optional room network, and inhabitants in one call.
REPLACES: create_poi + create_network + N×create_room + N×spawn_character + N×(create_item + place_item) TOKEN SAVINGS: ~90%
Example - Goblin Cave: { "worldId": "world-123", "name": "Shadowfang Cave", "category": "dungeon", "icon": "cave", "position": "50,30", "description": "A dark cave system rumored to house goblin raiders", "level": 3, "tags": ["goblin", "cave", "treasure"], "rooms": [ { "name": "Cave Entrance", "description": "A shadowy opening in the hillside...", "biome": "cavern" }, { "name": "Guard Chamber", "description": "A small alcove where guards keep watch...", "biome": "cavern", "exits": ["north"] } ], "inhabitants": [ { "template": "goblin:warrior", "room": 0, "count": 2 }, { "template": "goblin:archer", "room": 1 }, { "template": "hobgoblin:captain", "name": "Skullcrusher", "room": 1 } ], "loot": [ { "preset": "longsword", "room": 1 }, { "preset": "potion_healing", "room": 0, "count": 2 } ] }
Example - Village Inn: { "worldId": "world-123", "name": "The Prancing Pony", "category": "commercial", "icon": "inn", "position": "100,75", "population": 15, "discoveryState": "discovered", "rooms": [ { "name": "Common Room", "description": "A warm tavern with crackling fireplace...", "biome": "urban" }, { "name": "Kitchen", "description": "The busy kitchen smells of fresh bread...", "biome": "urban", "exits": ["west"] } ], "inhabitants": [ { "name": "Barliman Butterbur", "race": "Human", "characterType": "npc", "room": 0 }, { "template": "bandit", "name": "Suspicious Stranger", "characterType": "neutral", "room": 0 } ] }
Categories: settlement, fortification, dungeon, landmark, religious, commercial, natural, hidden Icons: city, town, village, castle, fort, tower, dungeon, cave, ruins, temple, shrine, inn, market, mine, farm, camp Biomes: forest, mountain, urban, dungeon, coastal, cavern, divine, arcane
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| worldId | Yes | World ID to create the location in | |
| name | Yes | Location name | |
| category | Yes | POI category | |
| icon | Yes | Map icon | |
| position | Yes | World map position | |
| description | No | Brief description for map tooltip | |
| population | No | Population for settlements | |
| level | No | Suggested character level for dungeons | |
| tags | No | Searchable tags | |
| discoveryState | No | unknown | |
| discoveryDC | No | DC to discover if hidden | |
| rooms | No | Rooms to create (first room is entrance) | |
| inhabitants | No | NPCs/creatures to populate the location | |
| loot | No | Items to place in the location | |
| sessionId | No |