Interactive Story Creator Tutorial

⚠ See Important Disclaimers

Important disclaimers:

  • All content and tools on HacksForEducators.com are provided as-is and are currently in beta. Features may change, break, or disappear without notice. These utilities are meant to help teachers experiment and save time—not to replace institutional systems or mission-critical workflows. Use at your own risk!
  • Disclaimer: This site is an independent project and is not affiliated with, endorsed by, or sponsored by Instructure, Inc. or Canvas LMS. “Canvas” is a registered trademark of Instructure, Inc.

Creating a branching story is a fun way to engage students. To build your story using the Interactive Story Creator, you don't need to learn complicated coding. Instead, you'll use a very simple plain text format to describe each scene in your story and tell the system how the scenes connect.

Each scene in your story needs just three basic ingredients:


Format of Each Scene

Below is the exact format you will use for writing each scene in your story. NOTE: it is very important to skip a line between each scene!


s: label_for_current_scene | Optional Title for Current Scene
t: Type the story description or scenario text here for the students to read.
- Text for Choice 1 | label_for_scene_where_choice_1_takes_them
- Text for Choice 2 | label_for_scene_where_choice_2_takes_them
- Text for Choice 3 | label_for_scene_where_choice_3_takes_them

Let's See a Real Example!

Don't worry if the format above looks a bit abstract. It will make sense when you see an example! Let’s look at a classic, short story with a single decision: choosing between the Blue Pill or the Red Pill.

Here is exactly how you would type out this 3-scene story using the above format:


s: start | The Ultimate Choice
t: You are offered two pills: a blue pill and a red pill. You can only take one. Which do you choose?
- Take the blue pill | blue_path
- Take the red pill | red_path

s: blue_path
t: You took the blue pill and lived a perfectly safe, comfortable... and completely ordinary life. Nice going!
- Restart the story | start

s: red_path
t: You took the red pill and stepped into a life full of wild adventures and incredible stories!
- Restart the story | start

How this looks to your students:

When students start, they will only see the text: "You are offered two pills..." and two clickable buttons labeled Take the blue pill and Take the red pill. The labels blue_path and red_path are completely invisible to them; they just act as the digital glue holding your story together!

If you would like to see the above sample story in action, copy the code above and paste it into the large text box on the Interactive Story Creator page and click "Preview.""


Some Rules/Guidelines to Keep in Mind

That is all there is to it! You're ready to start building your interactive adventure! If you have any questions, don't hesitate to reach out.

Contact Me