Migration Checklist

Migrate in small slices. The best first target is one complete chapter with one or two branches.

Migration at a glance

1. Inventory the original SVNE project.
2. Create the VNC project shell.
3. Import assets.
4. Rebuild scenes as node chains.
5. Rebuild choices and conditions.
6. Match the runtime UI.
7. Handle custom logic last.
8. Check and test.

Do not migrate everything at once

Pick one representative scene first. A small scene with a background, sprite, dialog, choice, and save/load checkpoint will reveal most migration issues quickly.

1. Inventory the SVNE project

Record:

• chapter indexes and names,
• scene names and order,
• backgrounds,
• sprite images and poses,
• portraits,
• BGM, SFX, GUI sounds, and scroll sound sets,
• story variables,
• choices and locked-choice rules,
• title cards and visual effects,
• custom code that changes the Roblox world.

Do this before creating nodes. It prevents you from mixing asset cleanup, story redesign, and migration work at the same time.

2. Create the VNC project shell

In VNC:

1. Create a new project.
2. Set the story title.
3. Create chapters matching the SVNE chapter list.
4. Create scenes matching the SVNE scene list.
5. Set the story entry chapter.
6. Set each chapter’s scene order.

Keep names user-facing. VNC stable IDs do not need to match SVNE names.

3. Import assets

Add assets before building node flow:

• backgrounds,
• character sprite assets and poses,
• portraits,
• BGM and SFX,
• menu background and menu music,
• GUI hover/click sounds,
• scroll sound sets.

If a sprite has several expressions in SVNE, model it as one sprite asset with multiple poses where possible.

4. Rebuild scenes as node chains

For each SVNE scene function:

1. Add the first node.
2. Set the scene start node.
3. Add dialog, background, sprite, audio, wait, and effect nodes in order.
4. Connect each node’s next target.
5. Preview the scene before adding complex branches.

Avoid making nodes create missing dependencies automatically. If a sprite or asset is missing, create it explicitly and clear the warning.

5. Rebuild choices and conditions

For each promptChoice:

1. Add a Choice node.
2. Add one option per SVNE choice.
3. Connect each option to the correct branch.
4. If SVNE saved the selected choice, assign a string variable to the choice node.
5. Convert locked choices into option conditions.
6. Merge branches back into a shared continuation when the story does that.

For each scripted if statement based on variables, use a Condition node.

6. Rebuild runtime UI

Match the player-facing feel before modernizing it:

• menu title and optional subtitle,
• menu background image,
• menu music,
• hover/click sounds,
• dialog UI preset,
• dialog colors and text settings,
• sprite slots,
• chapter title-card behavior.

Once parity feels right, make project-specific improvements.

7. Handle custom logic last

Mark custom code as one of these categories:

Use existing nodes

If built-in nodes can express the behavior, prefer them. This keeps the story visible in the editor.

Use runtime extensions

If the behavior is custom presentation or button logic, put it behind a documented extension point.

Wait for function nodes

If the behavior is story-triggered custom code, mark it as a candidate for a future function-node seam.

Keep game logic outside

If the behavior belongs to the Roblox experience rather than the VN runtime, keep it in the game layer.

This keeps the migration from turning into a hidden rewrite.

8. Validate and test

Before calling the migration done:

• Resolve Properties warnings.
• Run preview from the first scene and from later scenes.
• Test each choice path.
• Test save, load, autosave, continue, return to menu, settings, log, and chapter select.
• Install the runtime into a test place.
• Test published-place save persistence if save data matters.

9. Keep the original SVNE project nearby

Use the original SVNE project as a visual and behavioral reference, not as the architecture target. VNC should recreate the player experience while using a cleaner, more maintainable model.