AVG Standard Framework
The canonical AVG visual novel engine template used across Neta Studio — the starting point for visual novel and adventure game projects.
AVG Standard Framework
The canonical visual novel engine template used across Neta Studio. This is the foundation that powers hundreds of visual novel and adventure game projects on the platform — a production-grade React + Vite stack with dialogue panels, character sprites, choice branches, AI story continuation support, and a carefully decoupled architecture that separates engine code from story content.
About This Template
The AVG Standard Framework (v1) represents the moment when Neta Studio's visual novel capabilities matured from "AI can write a story" to "AI can build a playable game." It provides a complete front-end engine for visual novels and text adventures, with:
- Dialogue system — speaker-name display, typewriter effect, click-to-advance pacing, page numbering
- Character sprite layer — background + character sprite compositing with expression switching, tint-fallback when no image is available
- Choice branch system — floating option buttons that branch the narrative
- Free input mode — the platform's differentiator: type your own dialogue and actions, and the AI generates the next story beat in response
- Story configuration — all character data, expressions, backgrounds, meters (trust/suspicion/affection), intent rules, and milestone triggers are driven by a single 'story.js' config file, with zero engine-code changes needed per project
- Archive/load system — saves, checkpoints, chapter progress tracking
- Toolbar — back, save, menu, AI status indicator
The architecture is explicitly designed for reusability: the engine code ('src/engine/') is completely world-agnostic, and all world-specific content lives in 'src/story/story.js'. To make a new visual novel, you copy the template, replace 'story.js' and assets, and everything else remains unchanged.
How It Works
On a technical level, the framework is a React + Vite single-page application. The runtime engine manages dialogue state, choice branching, AI story continuation requests, and save/load serialization. The story configuration drives the rendering — engine code never contains hardcoded character names, scene descriptions, or plot logic.
Who It's For
- Visual novel creators who want to start a new project from a proven, production-grade foundation
- Neta Studio developers looking at the reference implementation of the platform's AVG capabilities
- AI storytelling researchers interested in the interface between config-driven narrative structures and LLM-based story continuation
- Fork-and-remix creators who want to build on top of the framework rather than from scratch
Highlights
Production-Grade, Not Prototype The framework has been iterated through multiple review cycles and powers the Xiapu Chronicles (414+ works) and other major visual novel worlds on Neta Studio. It's not a tech demo — it's a working engine.
Engine/Content Separation The strict decoupling between engine and story content is the framework's architectural thesis. You never need to touch engine code to make a new visual novel — swap the config file and go.
AI-Ready Architecture The free-input mode isn't bolted on — it's a first-class interaction mode designed into the framework from the start, with fallback handling, streaming response support, and state management for AI-driven conversation continuity.
Genre Fit
Game Engine · Visual Novel · Framework Template · Reference Implementation
