Voyage Heroes V34 - World Config JSON: Complete Reference

Version: V34 / heroesVersion 34
Purpose: workflow guide and schema reference for creating and editing V34 scenarios - the raw JSON structure and the editor UI for each section, as a structured flow of information.

Community resource, not official documentation. This wiki is independently maintained. Sources include hands-on testing and schema extraction from the Voyage bundle. Most of what is here has been verified directly, but treat it as a best-effort reference rather than ground truth, especially for fields that change between versions. When in doubt, test it yourself or check with the devs.

Build a world

Edit the JSON by hand with this reference open, or build visually in an editor with inline validation.

BuilderThe companion editor for this reference. Build V34 scenarios with a visual interface and live validation, no file editing required.Voyage ForgeAnother community-built visual V34 world editor.Voyage Forge GuideCommunity-written walkthrough covering V34 world creation step-by-step.

Start here

WorldStory, Lore, NPCs, LocationsBuild the people and places. Story overview, world lore, NPCs, items, factions, locations, regions, quests.MechanicsSkills, Traits, AbilitiesHow characters act and grow. Attributes, resources, skills, traits, abilities, triggers, combat settings.AINarrator InstructionsEvery narrator task. Story, Initial Start, NPC Details, NPC Intents, encounters, and more.OtherModes, Music, SettingsGame modes, narrator style, name filters, archetypes, and the remaining world settings.AppendixScripting and ValidationTrigger scripts, worked recipes, size limits, the voice catalog, and validator gotchas.Community GuidesTutorials and How-tosCommunity-written walkthroughs that complement the schema reference.ToolsValidator, Workbench, Field indexValidate a world, audit triggers in plain language, browse every field, read the machine API.

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 /validate. See /tools/api for the full list of endpoints, examples, and an agent prompt snippet.