Skip to main content

Testing Your Story

Ensuring your story plays correctly is a crucial part of the development process. There are two primary ways to test your content in the Interactive Story App:

  1. Full Playthrough: Using InitScene.scene to test the game flow from the very beginning.
  2. Specific Chapter Testing: Using StageScene.scene to jump directly into a specific story or chapter.

1. Init Scene (Full Playthrough)

Playing from the InitScene simulates a fresh launch of the game. It will start the application from the splash screen or main menu, ignoring any debug overrides. This is ideal for testing the full user experience exactly as a player would see it.

Steps to Play:

  1. In the Project panel, navigate to the Assets/_Main/Scenes folder.
  2. Double-click InitScene.scene to open it.
  3. You should see the initial entry point in your Scene view: Init Scene
  4. Click the Play Button at the top of the Unity Editor. Play Button
  5. The game will launch in the Game window.

2. Stage Scene (Debug Testing)

Playing from the StageScene allows you to bypass the main menu and load a specific Story and Chapter immediately. This is the most efficient way to iterate on specific scenes or debug new content without playing through the entire game from the start.

Steps to Configure and Play:

  1. In the Project panel, navigate to the Assets/_Main/Scenes folder.
  2. Double-click StageScene.scene to open it. Stage Scene
  3. Navigate to the Assets/_Main/Stage Debug folder in the Project panel.
  4. Locate the ScriptableObject named Debug Stage Data. Click it to view its settings in the Inspector panel. Debug Stage Data
  5. Configure the settings in the Inspector to choose which part of the story to test (see parameters below). Select Story

Debug Configuration Parameters

PropertyTypeDescription
StoryDropdownSelect the specific story title you wish to test.
ChapterNumberThe specific chapter number you want to load.
Example: Enter 1 to play chapter_1, or 10 to play chapter_10.
Reset ProgressCheckboxEnabled: Simulates a fresh start (clears save data for this story).
Disabled: Continues from where you left off (loads existing save variables).
Check Your Files

You must ensure that the Chapter number you enter actually exists within the selected Story.

If you enter 10 but only 5 chapters exist, the system will look for a file that is not there, causing errors in the Unity Editor.

Launching the Test:

  1. Once you have modified the Debug Stage Data, click the Play Button at the top of the Unity Editor. Play Button
  2. The game will immediately launch your selected story and chapter in the Game window.