Script Validation
Script Validation helps you catch problems before you export your game.
What it is
Validation is GenPy's automated checking system for your scripts. Run it regularly to find errors, warnings, and helpful suggestions before they turn into broken scenes or failed exports.
INFO
Validation works best as part of your normal writing routine, not just at the end of a project.
What it checks
- Syntax errors in game scripts
- Undefined labels when a jump or call points to a scene that does not exist
- Dead-end labels that leave the player with nowhere to go
- Undefined variables used in conditions or story logic
- Missing character definitions
- Save compatibility issues, including pickle safety problems
- Unreachable code and scenes that can never be entered
How to use
- Open Validation from Publish mode or from Tools.
- Run validation for the current project.
- Review the issue list, grouped by category and severity.
- Click any issue to jump to the related line or scene.
- Fix the problem and run validation again.
- Repeat until the remaining issues are understood and acceptable.
Severity levels
- Errors: Must-fix problems that can stop the story from working correctly
- Warnings: Problems you should review because they may confuse players or break routes
- Info: Suggestions that improve script quality and consistency
When to use it
- Before every export
- After major story edits or route rewrites
- During QA and playtest prep
- When importing or reorganizing older scripts
Why it helps
- Catches broken links between scenes
- Finds story logic that no longer matches your current structure
- Reduces the risk of save or route progression issues
- Gives you a focused checklist for cleanup before release
Tips
- Validate early and often instead of waiting until the end.
- Fix Errors first, then work through Warnings.
- Re-run validation after large changes to menus, labels, or variables.
TIP
Validation is most effective when used together with Story Graph, Branch View, and the Variables panel.