Story Builder Documentation

A guide to using the story token replacer application.

1. Overview

The Story Builder is a simple application that lets you create dynamic stories by using tokens as placeholders. You can define your own tokens and their corresponding values. When the story is generated, the tokens are automatically replaced, allowing for creative and personalized narratives.


2. Using Tokens

Defining a Token

You can create a new token in one of two ways:

Using a Token in Your Story

To use a token in your story, simply type the token name inside square brackets, like so: [token_name]. For example, [character_name] will be replaced with the value you assigned to it.


3. Special Token Types

Tokens support special syntax for more dynamic content.

Random Values from a List

To have the app randomly select a value from a list, simply provide a comma-separated list of values. For example, a token named character_name with the value Alice, Bob, Carol will be replaced with one of those three names randomly.

Random Numbers

To generate a random integer within a specific range, use the format [random low-high] directly in your story. For example, [random 1-100] will be replaced with a random number between 1 and 100. This special token does not need to be added to the token list.

Colors

To change the text color, specify it like [color red] or [color #FB99C5] directly in your story. This special token does not need to be added to the token list.

Also supported: [effect throb][effect bold] and [effect none]


4. Application Features