Story Flow

Story Flow is GenPy's visual routing editor for planning branching narratives.

What it is

Use Story Flow to design how your story moves from scene to scene. You create scenes, connect them with routes, add conditions, and let GenPy generate the routing scripts for you.

INFO

Story Flow is especially useful when you want to design the structure of a route before writing every line of dialogue.

Key concepts

• Scenes: The building blocks of your story. Each scene becomes a script label.
• Routes: Connections between scenes that decide where the story goes next.
• Conditions: Rules that control routing based on choices, variables, or story flags.
• Groups: Collections of scenes that help you organize chapters, acts, or route arcs.

How to use

1. Open Story Flow from Design mode.
2. Create scenes for the key moments in your route.
3. Draw routes between scenes to define the possible paths.
4. Add conditions to routes, such as "if affection > 5" or "if the player found the key".
5. Define the variables that control your branching logic.
6. Let GenPy generate the managed routing scripts for you.
7. Return to your scene content and fill in dialogue, choices, and presentation.

What gets generated

• A managed game script with a clean label structure
• Routing files that handle your conditional scene flow
• Variable definitions for the state your routes depend on

When to use it

• When planning a multi-route visual novel
• Before writing content for a complex branching chapter
• When building affection-based, flag-based, or ending-based routes
• When you want a clearer overview of route logic than a text-only script provides

Best for

• Games with multiple endings
• Character route structures
• Mystery or choice-heavy stories with many conditions
• Projects that need a clear chapter or act layout

Tips

• Start with the overall route structure first, then write scene details later.
• Keep scene names clear so route maps stay easy to scan.
• Use the Guide panel when you want help with conditions or setup.

TIP

A simple top-level route map can save a lot of rewriting later, especially when your story has many branches that reconnect.