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:
- A Label for the Scene: A hidden word or short phrase used to identify your scenes (students will not see this).
- The Story Text: What your students will read when they land on this scene.
- The Choices: The options your students can click to branch to other scenes.
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
- Separate scenes with a blank line: Always leave a completely blank line between your scenes. This blank line is how the story creator knows one scene has ended and a new one is beginning.
- Keep labels short and sweet: For your scene labels (like
startorblue_path), stick to simple, single words or short phrases. IMPORTANT: Avoid punctuation inside the label itself: use only letters, numbers, and the underscore (_) character. - Scene titles are optional: I personally like to use a title for the opening scene, but that's all. Scene titles are always optional. Only the label is required.
- Leave yourself notes: If you want to type a note to yourself that students will never see, start the line with a
#symbol. The story creator ignores all lines that begin with#.
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.