Skip to content

Generate a story with Theo

YAHAHA empowers creators with our interactive AI assistant, Theo, who facilitates both game scene generation and game story completion. While still in the beta version, we are dedicated to enhancing and refining this feature. Theo generates game stories based on user prompts. Currently, Theo breaks them down into essential story elements such as non-player characters (NPCs), monsters, items, and quest lines before incorporating them into the gameplay. For more insights into Theo's capabilities, please refer to our guides about AI.

Start a story

  1. Download and install YAHAHA installer.
  2. Log in to YAHAHA Desktop (Desktop) with your YAHAHA account. If you haven't signed up for a YAHAHA account yet, create one first.

Then you can choose to start the story creation either from Desktop or YAHAHA Studio (Studio).

From Desktop

  1. In Desktop click the Build Game with AI button under the Create tab to get started.

    No projects: Center Existing projects: Top-Right
    button location when there's no projects button location when there are projects present
  2. In the pop-up window, choose Generate Story for story generation.

    Generate Story

  3. After clicking Generate Story, you'll see a story generator window. In the window, set the scene, theme, and prompt for your story.

    Story generator window

    • Choose a Scene: Select a scene from scene templates. To replace a chosen template, click Replace.

    • Theme: Enter the game theme. For example, adventure and friendship.

    • Prompt: Describe the game story you want to generate. You can include NPCs, items, monsters, specific tasks, and even storylines here. For example, For more information on prompt tips, see Prompt tips.

    Alternatively, you can click Try Prompt on a story example on the left side to enter its prompt and modify it further. To have an overview of the story description and prompt, click More Details.

    Example story

    When you fill in everything, click Generate to start generating a story.

  4. You will be directed to Studio and prompted to go to Story Mode, an editor in which Theo helps you create quests that comprise storylines.

    Story Mode

From Studio

If you want to try the story generation feature on an existing project, open your project on Desktop and switch to the Story tab in Studio. For more information on project creation, see create a project.

Story tab

Then you are ready to enter Story Mode, an editor in which Theo helps you create quests that comprise storylines. To get started, click OK, let's get started.

Ready to enter Story Mode

A chatbot with Theo pops up. If you have a basic story idea, fill in your story summary. If you need inspiration, ask Theo for some new ideas. Meanwhile, you can preview your story on the left pane.

story chatbot

When Theo has all the game basics, such as the game name, theme, and storyline, the Generate Now button will light up and you can click it to edit the story.

ready to generate

Edit a story

In the story editor, quests are displayed as main or side types for you to edit further. Players can conveniently track their quest progress through the Quest List pane in game.

Quest lines

To view the story prompt, click the Story outline Story outline button in the bottom left corner, or press Option+1 (on Mac) or Alt+1 (on Windows).

To view the quest structure, expand the Hierarchy window by clicking the Hierarchy Hierarchy button in the bottom right corner, or pressing hotkeys (Option+2 or Alt+2). In the window, you can see how quests lead to different storylines based on a narrative structure.

Hierarchy interface

Note: AI-assisted story generation produces unique storylines, much like snowflakes. Even when using the same prompt, each story showcases its individuality, featuring shared elements and styles with distinct touches that set them apart.

Modify a quest

To start modifying a quest, select the quest and click Quest Properties in the top right corner to expand the Properties window.

Quest Properties

Quest Properties window

Here are all the quest properties in the window:

  • Basic info:

    • Name: Name of the task

    • Type: Type of the task, including:

      • Narrative: To complete the task, players need to engage in a conversation with an NPC.

      • Monster Kill: To complete the task, players need to collect a specific number of monsters.

      • Item Collection: To complete the task, players need to collect a specific number of items.

    • NPC: The initial contact to interact with the player and deliver the quest. Click the locate locate button to preview the NPC in Quest Ref.

    • Sketch: Describes the quest briefly

  • Target: Corresponding target of the task

    • For a Monster Kill quest, the target is a monster to kill. Because there is no preset monster, you need to click + Create new one to create a monster.

    • For an Item Collection quest, the target is an item to collect. You can choose an item or click + Create new one to create a new item.

    • For a Narrative quest, the target is at least one pre-set NPC to interact with through dialogue. You can either select an existing NPC or click + Create new one to create a new NPC. You also need to add dialogue in English in the Target pane for the conversation with the designated NPC.

  • Reward: (Optional) The item given to players when they finish tasks.

  • Dialogue: The conversation players have with the NPC that serves as the players's initial contact. We only accept input in English.

Note: For a smooth gameplay experience, each quest, NPC, item, and monster must have a unique name.

You can edit the properties by adjusting the values. Or click Modify with AI and describe desired changes to enable Theo to update properties directly. However, remember that new items, NPCs, and monsters cannot be generated this way.

Add a quest or quest branch

You can easily create quests or quest branches using existing quest assets. If you want to add a new quest to kill monsters, make sure to create the monsters first since there is no preset monster model. There are multiple methods to create new quests and initiate quest branches. Among them:

  • To create an independent quest, click + New Quest, then decide how to create it. If you need a specific type of quest, you can request it from Theo, and it will generate it automatically. However, remember that new items, NPCs, and monsters cannot be generated this way. Or you can choose to create a quest manually.

    New Quest

  • To create a quest or quest branch next to an existing one:

    • Right-click the existing quest, then select where and how to insert it.

    Right-click to select

    • Hold your pointer over the quest, click insert quest button the Insert quest button on the left or right of a quest, and choose how to insert it.

    Insert quest

    • Select the quest, click insert quest button the Insert quest button in the top toolbar, then choose where and how to insert it.

    Insert quest button in bar

Copy a quest

Copying a quest copies the quest and all the subsequent quests in the sequence, if any. To copy a quest, do any of the following:

  • Right-click the quest and select Copy quest.

  • Select the quest and click the Copy quest button in bar Copy quest button in the top toolbar.

  • Hold your pointer over the quest and press Cmd+C (on Mac) or CTRL+C (on Windows).

Paste a quest

To paste the copied quest(s) to the right of a quest (target quest), do one of the following:

  • Right-click the target quest and select Paste quest.

  • Select the target quest and click the Paste quest button in bar Paste quest button in the top toolbar.

  • Hold your pointer over the target quest and press Cmd+V (on Mac) or CTRL+V (on Windows).

To paste the copied quest(s) as the independent quest(s): Find an empty spot in the interface, then right-click and select Paste quest, or use the same hotkeys as before (Cmd+V or CTRL+V).

Delete a quest

Deleting a quest removes the quest and all the subsequent quests in the sequence, if any. To delete a quest, do one of the following:

  • Right-click the quest and select Delete quest.

  • Select the quest and click the Delete quest button Delete quest button in the top toolbar.

  • Select the quest and press Backspace.

To delete multiple quests at once, drag a rectangle around them and delete all the quests that fall inside the bounding box.

Manage quest resources

To manage quest resources, including NPCs, monsters, and items for quests, click Quest Ref.

You can also click Create to create more resources. These created quest assets can also be published to Asset Library. For more information on asset publishing, see Publishing an asset to Asst Library.

If you want to delete an asset, click the More More button, then click Delete to remove it.

More functions

Consult gameplay questions

Whenever you need any assistance from Theo on story generation, such as prompting ideas and quest breakdown, click AI Assistant at the bottom and chat with Theo in the chatbot.

AI Assistant chat window

Scale canvas display

To adjust the display size of quest lines, use the zoom button, zoom in button, or adjust the percentage slider.

Canvas scaler

Apply a story

To apply quests to the game, click Apply to Gameplay in the top right corner. Once applied, you enter the scene editor and view everything generated there.

NPCs and monsters are usually generated within a 10 to 30-meter radius from the spawn point. You can freely reposition them and continue to edit the scene and gameplay. To learn more about scene editing and gameplay, see Scene Editor and Gameplay. When making changes to the scene, ensure they align with the existing gameplay. Likewise, when you modify quests in the story editor, they should remain coherent and consistent with the gameplay. Before re-applying quests, remove any resources previously generated from the scene to avoid potential naming conflicts that could affect game functionality.

To see how the game goes, playtest it in Play Mode.

Save a scene

When you apply all quests, the scene with generated quests is automatically saved. If you make any edits or modifications within the scene, save it before exiting Studio.

For a saved scene, you can access, modify, and publish it anytime.

Manage the scene

Access the scene

You can access the scene under the Projects tab in Desktop. It is labeled as AI-Generated.

Access projects

Publish the scene

You can publish the AI-generated scene to Desktop, with mobile support coming soon. For more information about scene publishing, see Publishing your project.

Theo assistance

To rate Theo's service and leave a comment, see Feedback.

For additional assistance, visit the #questions channel on the YAHAHA Discord.

Prompt tips

  • A prompt is a short text description that YAHAHA interprets to produce game scenes and stories. Whether it's a single word, phrase, sentence, or even a more elaborate description in complete sentences, the prompt should not exceed 500 characters.

  • Be clear and specific about the desired game story. You can use punctuation, but don't worry too much about grammar and capitalization. The main focus should be to effectively convey your ideas.