Voyage Heroes - World Config JSON: Complete Reference

Version: V33 / heroesVersion 33
Purpose: Workflow guide and authoritative schema reference for creating and editing V33 scenarios - covers both the raw JSON structure and the corresponding web editor UI for each section

Community tool

If you would rather build worlds visually instead of editing JSON by hand, Voyage Forge is a community-built editor and companion guide for V33.

Voyage Forge Interactive V33 world editor. Build scenarios with a visual interface, inline validation, no file editing required. Voyage Forge Guide Community-written walkthrough covering V33 world creation step-by-step.

Start here

World Story, Lore, NPCs, Locations Build the people and places. Story overview, world lore, NPCs, items, factions, locations, regions, quests. Mechanics Skills, Traits, Abilities How characters act and grow. Attributes, resources, skills, traits, abilities, triggers, combat settings. AI Narrator Instructions All fifteen narrator tasks. Story, Initial Start, NPC Details, NPC Intents, and more. Appendix Scripting and Validation Trigger scripts, worked recipes, validator gotchas, editorial review checklist.

For AI agents

Every section is exposed as a self-contained API endpoint with the schema fragment, prose explanation, field notes, and authoring tips. World JSON can also be validated via POST /api/validate. See /tools/api for the full list of endpoints, examples, and an agent prompt snippet.