JVN has two primary authoring languages: VNS for visual-novel flow and JES for interactive 2D scenes. This section also covers timelines and data-driven UI configuration.
| Need | Start Here |
|---|---|
| Dialogue, choices, story flow, and character staging | VNS Overview |
| Entities, components, physics, input, and gameplay scenes | JES Overview |
| Animation timelines and story maps | Timeline Scripting |
| Menus, dialogue layout, and composable reactive UI | JVN Facets |
The JVN Scripting Language Contract is the normative entrypoint for portable VNS and JES syntax, compatibility, deprecation, and diagnostics. Guides teach usage; parser-internals pages explain implementation; neither overrides the contract.
Language Contract 1 is currently provisional while parser, runtime, editor, and VS Code behavior are reconciled through shared fixtures. See the Contract 1 status.
vns/— VNS language, presentation, flow, runtime, integration, and guidesjes/— JES scenes, components, systems, gameplay, timelines, and integrationtimeline/— animation and story timeline APIs and authoringui/— Facets, menus, layout, styling, screens, and editor-tooling DSLsspec/— versioned language contracts and compatibility policy