Voyage Schema V36 GameState: Complete Reference

Version: 2.38.0
Purpose: workflow guide and schema reference for creating and editing V36 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.

Current against the beta build. The schema, field notes, and validator here are extracted from and kept in sync with the beta Voyage build.

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 V36 scenarios with a visual interface and live validation, no file editing required.Voyage ForgeAnother community-built visual V36 world editor.Voyage Forge GuideCommunity-written walkthrough covering V36 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.ModsLayered Partial WorldsLayer partial world JSON over an existing world: same editor, same schema, no required sections.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.