with one click
Schema and rules for creating regions
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill regionsCopy and paste this command into Claude Code to install the skill
Schema and rules for creating regions
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill regionsCopy and paste this command into Claude Code to install the skill
Schema and rules for creating abilities
Schema and rules for editing AI instructions
Check character counts and limits for Voyage World config files. Use when checking how much space is used, before adding large content, or when approaching size limits.
Schema and rules for creating locations
Schema and rules for creating NPCs
Schema and rules for editing settings
| name | regions |
| description | Schema and rules for creating regions |
| context | fork |
| agent | regions |
Edit tabs/regions.json.
| Field | Requirement |
|---|---|
name | Must match object key exactly |
basicInfo | One paragraph describing geography, climate, and atmosphere |
x | Integer grid coordinate - must be adjacent to other regions in the same realm |
y | Integer grid coordinate - must be adjacent to other regions in the same realm |
realm | Which realm this region belongs to |
imageUrl | URL for the region's map image |
| Field | When to Include |
|---|---|
known | Set to false to hide from map at game start. Omit or set true for visible by default |
factions | Only when region has dominant faction presence affecting the entire area |
npcLevelRange | { min, max } band for NPCs generated anywhere in this region whose level you don't set explicitly. A location's own band overrides it. Use it to set a baseline difficulty for the whole region |
| Field | Reason |
|---|---|
hiddenInfo | Unused field — region secrets belong in location or NPC entries instead |
One paragraph covering three aspects:
Format: "[Terrain description]. [Climate and atmospheric details]. [Brief mention of inhabitants or dangers]."
Regions use integer grid coordinates. Within a realm, regions must be adjacent (differ by 1 in x or y, not diagonal).
(0,0) (1,0) (2,0)
(0,1) (1,1) (2,1)
(0,2) (1,2) (2,2)
Rules:
tabs/regions.json before assigning coordinatesDesign guidance:
Regions are large geographic areas containing multiple locations. Think:
Each region typically contains various locations.
interface Region {
name: string
basicInfo: string
x: number
y: number
realm?: string
known?: boolean
hiddenInfo?: string
factions?: string[]
npcLevelRange?: { min: number; max: number }
}
For detailed documentation, see regions-reference.md.