From AI Dungeon Wiki
Jump to navigation Jump to search

A Scenario is a user-created adventure template, which includes a prompt, memory, quests, world Info, and/or scripting to create a specific story/experience.

See also... Tutorial:Scenarios

The Scenario Editing Menu


This will be the title of your scenario, and it is displayed in bold letters at the top of your scenario's entry in the Explore or My Stuff pages. This entry is limited to 70 characters.


The description box is where you'll provide a brief description to help others get an idea of what to expect when playing your scenario. It'll be displayed below the title on the Explore and My Stuff pages, and can be used to describe your setting, scripts, world info, or any other information you feel is necessary to convey to the player. This entry is limited to 400 characters.


Main article: Prompt

The prompt is where you'll really start to design the nature of your scenario. In this box, you'll write out the initial entry point for your player, and it can be used in an outstanding variety of ways. You have the option to declare the player's location, characters they will be dropped next to, or even aspects about the player themselves. This entry is limited to 2000 characters.

Within the prompt, players can provide their own input in your prompts if you enable them to do so with special placeholders. For example: "You are ${}, a knight in the kingdom of ${Enter a country...}" This will give the player two entries. "Enter your character's name..." and "Enter a country..."

${} is unique in that it will prompt the user with, "Enter your character's name..." All other variants will display the text within the {} directly to the player, as is the case with ${Enter a country...}

These input placeholders are capable of being carried over to memory, although they are case sensitive. For example, if the prompt contains "${What is your brother's name?} is your brother" and the memory contains "${What is your brother's name?} is a soldier" then a player input of "Marco" will result in the prompt stating "Marco is your brother" while the memory states "Marco is a soldier". However, should the memory contain ""${what is your brother's name?} is a soldier" (with a lowercase W) then the user will instead face two input prompts at the start, one being "What is your brother's name?" and the other being "what is your brother's name?" This example also serves to demonstrate that the input syntax can be used in the memory independently of the prompt.


Main article: Memory

Memory is used to provide the AI with information that it is to remember throughout the course of the adventure. Players can access and change this information by clicking the memory pin or using the /remember command. This entry is limited to 1000 characters. Using memory, you can remind the AI of the existence of specific characters, objects, or locations and nothing special will need to be done for the AI to recall this information during an adventure. You will generally want to provide full sentences with as much context as possible so the AI can properly understand what you're conveying. Memory including the word "Rein" when trying to store your villain's name will mean very little to the AI, and it is just as likely to name a brand of cereal "Rein" as it is to apply the name to a character in their adventure. Memory including the sentence, "Rein is a corrupted sorcerer who terrorizes the Kingdom of Larion!" is much more information for the AI to work with, and your players will likely encounter rumors of Rein's evil machinations.


Main article: Quests

Quests provide goals in short, simple sentences to give your players a sense of direction. This entry is limited to 1000 characters. During an active adventure, quests can be found by opening the side-bar and selecting the "Quests" option.

discover the source of the attacks against Larion
>locate Rein's hideout
defeat Rein

The entry with the arrow will become the active Quest.

Scenario Options

Scenario Options are used to create new sub-scenario entries within your scenario that your players will choose from. You can create an option by clicking the + next to the text to Add a new scenario option. By creating and opening a new option, you'll be greeted with a clone of your scenario, titled, "Untitled option for [your scenario title]" to work with. The option will inherit the description, prompt, memory, scripts, and world info from the parent scenario upon creation, and from there you can modify it into a unique sub-scenario. With multiple options, you can allow players to play your scenario with multiple different prompts, scripts, world entries, and so on.

On the player's end, scenario options are seen as a numbered list of options to select from, just like the options available to you when you activate a new game. The options are formatted like this:

[The parent scenario's prompt appears here]
1) Option 1
2) Option 2
3) Option 3

Scenario options are essentially scenarios, and therefore have their own Scripting, World Info, etc.


Music allows you to select from three tracks to play in the background of your scenario if the player has music enabled. The options are FANTASY, CREEPY, and SCI-FI, and is defaulted to NONE.


Main article: Tags

Tags are used to allow players using the Explore page to filter through stories that appeal to their interests, as well as to filter out stories that don't. You can create multiple tags to describe your adventure to give players more insight into what qualities your scenario will have for them. You can use this to tell players if your scenario has #scripts, #romance, or even #nickwalton.


Main article: NSFW

The NSFW toggle will flag your story as having NSFW (Not Safe for Work) content, and will automatically apply the #nsfw tag to your scenario. Scenarios with this toggled on will not be shown to users who have "Filter NSFW Content" activated in their settings.


The Published toggle will post your story to the Explore page for other users to experience.

3rd Person

AI Dungeon will usually process your actions in 2nd Person. "You are thirsty, so you grab a much and knock it back for a refreshing swig of ale!"

The 3rd Person toggle will force the AI to filter that out, allowing you to take actions with your character in 3rd Person instead! "Devon is thirsty, so he grabs his mug and knocks it back for a refreshing swig of ale!"

This perspective works best for multiplayer scenarios where multiple players will be interacting, but it can be toggled on for single player scenarios as well.


Main article: Game Mode

AI Dungeon can be played in three different modes from your scenarios. CREATIVE, ADVENTURE, and HARDCORE.

CREATIVE mode is the standard AI Dungeon experience, where you have full access to Undo, Redo, Alter, Memory, Story and Retry.

ADVENTURE mode adds a level of difficulty to the experience, where you lose access to Alter and Story, but retain access to Undo, Redo, Memory, and Retry. In addition, dying in this mode will end an adventure!

HARDCORE mode takes the difficulty of Adventure mode one step further by denying access to Undo, Redo, Alter, Memory, Story and Retry completely. This mode will also end a player's run if their character dies! Not for the faint of heart!

Copy/Duplicate function

The Copy/Duplicate function is a button that basically copies the scenario and makes it as a copy, you also may notice that it has the word "Copy" when you duplicate/copy one of your scenarios. You also be in the copied version of the scenario, it'll have all the WI and memory stored in, just like the original scenario. The only difference with the copy/duplicate function, is that. It'll have it as a unpublished copy of the original scenario. Also, you may wonder, where you can find this kind of button.

  • My Stuff
  • Click on the Scenario section
  • Click the scenario or the clicking the book icon which, leads to the same page.
  • You should see a two outline paper icon, the front paper and the back paper is the the copy/duplicate function.

Save function

The Save function is a way of saving your scenarios/adventures, this function was added in order to prevent a weird bug that caused the index of the scenario being completely erased all together. Although if you exit of the menu, the updated date will change none the less, even if you didn't touch anything. note: it does auto-save everything, although with the save function (The task drive looking icon) is a safer way of saving your stuff.


Main article: Scripting

Scripts allow modding AI Dungeon with JavaScript that can control the text of your story, World Info, context, and more.

World Info

Main article: World Info

World Info allows players to add extra information to the worlds of their scenarios that will only be used when certain keys are activated. This can be used to provide definitions for anything from character and place descriptions, to explaining objects and verbs.

Tips for creating Scenarios

The site is full of scenarios which are only a few lines of prompt, but don't actually do anything. If someone could just type something into the custom-prompt menu, it's not really worth it.

A good scenario has one or more of the following...

  • A unique and interesting idea which one can't just have happen on its own.
  • A very long prompt, which really explains the world and sets the tone.
  • A default memory block which the player can use and make changes to throughout the adventure.
  • Enough well-crafted World Info entries that the AI will be kept on track with what's going on in the world.
  • Scripting which actively does things to make the game more interesting.

Also, don't forget to describe your scenario well, so people see what it is, and explain what's in it.