State Registry
State Registry gives you an overview of your project's game state in one organized place.
What it is
Use State Registry to review the values that shape the player's experience across your story. This includes long-term progress, chapter state, character stats, unlocks, and other important pieces of game state.
INFO
State Registry is useful when your project has grown beyond a handful of simple flags and you want a clearer picture of how everything fits together.
What it tracks
- Persistent data that should carry across the whole game
- Chapter or route progress markers
- Character stats such as affection, trust, or reputation
- Default values for important state
- Places where state is read and written throughout the project
How to use
- Open State Registry to review the current state map of your project.
- Check that important values start with the defaults you expect.
- Review where each value is changed during the story.
- Look for conflicts, accidental overwrites, or unclear state ownership.
- Confirm shared state still makes sense when multiple routes reuse the same scenes.
Why it matters
- Helps you keep long stories consistent
- Makes it easier to spot overlapping systems or duplicate stats
- Supports cleaner route design when many scenes depend on shared state
- Gives teams a common view of how progress and character data are handled
When to review it
- Before exporting your project
- After major route rewrites
- When balancing affection or stat-based progression
- When debugging story events that trigger at the wrong time
Tips
- Make sure important state is properly initialized before it is used.
- Review values that are changed in many places, since they are easier to break by accident.
- Check reused scenes carefully so they do not overwrite progress in the wrong route.
TIP
A quick State Registry review before export can catch state problems that are hard to notice during scene-by-scene editing.