Title

This is what the Scenario will be listed as in My Stuff, or in other people’s Search if you Publish it. Be sure to make this a name that is unique and descriptive, so you and others can find it easily later.

Description

More detailed information, the first part of which will be displayed with the listing under the Title. You can use this to keep additional information describing the Scenario, which is especially important if you intend to publish it.

Note that the AI does not see the Description, so the later parts are a good place to give instruction ideas, explanations, notes, and other out-of-game comments to the player.

Tags

You can add tags to Scenarios to help you or others find it in Searches. Type the name of a tag in the entry field, then hit Enter to make it appear in a list below it. You can remove them by clicking the ‘X’ next to them.

The Title, Tags, and the first few lines of the Description will be shown in the Search results when you or someone else is looking for the Scenario, so it’s recommended that you make them something unique and descriptive. New Adventures created with the Scenario will have this Title and Description by default.

Publish

The default state of every new Scenario and Adventure is always an Unpublished Draft. The ‘Publish’ button makes it possible for others to see your Scenario and find it in Search.

Any new changes to a Published scenario must be published again in order for them to become visible.

Even after you’ve published a Scenario, you can continue to edit it as a draft. You can publish this draft immediately to sync any changes you made, or you can quit, and keep editing it until you’re ready.

We recommend that you proofread and test the Scenario before you Publish it, to make sure you haven’t made some mistake or typo.

Before you publish, the Rating Tool will need to rate your scenario, which is explained below.

Rating

Your scenario doesn’t need to be rated if you don’t intend to publish it, and does not affect anything if it stays unpublished.

However, if you do intend to publish, the Rating Tool will automatically determine what age group your Scenario is appropriate for, on a scale of Everyone, Teen, Mature, and Unrated. You are able to set the rating higher than what the tool decided, but not lower.

Not only is a correct rating important for complying with the Community Guidelines, where you can also find more information about what fits in each of those categories, it’s also important so that people can find your content easily.

AI can make mistakes.

AI Dungeon deeply understands that—which is why, at your request, you can ask for a human to review your content if you think the AI tool has gotten it wrong. Ping ata523100 on Discord for a Scenario Review, and we will get back to you as soon as we can.

Unlisted

If this is toggled, you will be able to share your Scenario with people, but only by sending them the direct link. It will not be listed in the Search or visible by others on your profile.

Placeholders / ‘What is your name?’

Prompt

The Prompt is the first message in the Adventure, and is the meat of a Scenario: every Scenario should have a Prompt, and the bigger the better!

Note that the prompt is the first Action in the Adventure, and there’s nothing stopping you from filling it to the maximum size, which is about as far back as the AI can remember. This means whatever you put at the very top of the Prompt will disappear from the Current Context relatively quickly in a long Prompt, meaning you should put anything tone-setting in the Plot Essentials where it will always stay at the top of the Context.

Plot Essentials

Plot Essentials is a great place to put information about the player character, world lore, plot details, and anything else that is always relevant for the AI to know about. Players will be able to edit this (and any other component you add) when they play your Scenario.

Click here to read more about Plot Essentials →

Author’s Note

Author’s Note is a tool that you can use to guide the theme, setting, and writing style of your Scenario. Entries here are usually short, concise, and to the point.

TIP: The Author’s Note is an extremely strong plot component, as it is one of the last things the AI sees. It’s recommended that you leave it blank if you’re not sure what you’re doing with it.

Click here to read more about Author’s Notes →

Story Cards

Story Cards are only used when their Triggers appear in the recent text of the Adventure. When they are triggered, their Entry text is fed to the AI as added context. Some Scenarios are built entirely around having a large Story Card database to describe a setting. This is good if you want to include information that isn’t always relevant enough to include in Plot Essentials.

For example, to add a Story Card for a monster called a “grue”:

Triggers:

grue

Entry:

Grues are fearsome predators that lurk in dark places. They are deadly and remarkably quick, but they have a single weakness: they cannot stand light of any kind. No one has ever seen a grue and lived to provide a reliable description, as they only hunt in pitch darkness. If you hear something moving in the dark, it might be a grue. And if it is... well, you won't be left wondering for long. The classic warning goes: "It is pitch dark. You are likely to be eaten by a grue.”

Remember that the Title of a Story Card is for the player only—the AI only ever sees the description! Always be sure to mention the name of the title in your entry, so the AI knows what or who you are talking about.

Click here to read more about Story Cards →

Scripts

You can add Javascript code to a Scenario which will change things about how the interface handles the text. People have used this in ways ranging from quality-of-life features like setting up Memory or giving reminders, to creating entirely new experiences which drastically change the way the game operates.

Note that you cannot access this on mobile.

Click Here to read more about Scripting →

There are more Scenario Types than just ‘Story’, though these can be more advanced and may need some practice to learn how to use.

To see and use these options, click the Gear ⚙️ icon on the top right of the Opening component when editing a Scenario.

• The default Scenario type is Story, which is the one that has been discussed up until now. It starts with a simple story prompt, which the AI follows after. For an example for a Story Scenario, check out Halfway Magical.
• Character Creator lets the user pick from your created Story Cards to make a character that fits in the world. For an example of a Character Creator Scenario, check out Faerûn.
• Multiple Choice allows you to give the player select-able options at the beginning of the Scenario. For an example of a Multiple Choice scenario, check out Quick Start.

When a Scenario is Multiple Choice, it will give the user a menu from which to select from a set of options, which are Sub-Scenarios with their own Prompts, Plot Essentials, Story Cards, etc.

When you change your Scenario to a Multiple Choice, you will see that you enter a page that has two options. You can add more options by clicking + Add Choice. Each of these choices is completely configurable.

Clicking on one of them will bring you to what is effectively a new Scenario page, pre-populated with some of the traits of its parent Scenario. In these choices, you can even add more choices, creating a branching list of Scenarios, all differing based on which one the Player chooses to play.

Multiple Choice Scenarios are good for providing alternative options to one scenario that placeholders alone can’t solve, such as a Scenario where you can play as a vampire or the vampire hunter, but the uses of these kinds of Scenarios are broad and can be used in many, many different situations.

Click here to read more about Multiple Choice, including a more detailed explanation of how to use them →

When a Scenario is a Character Creator, it means that you select any number of Story Cards to let the player choose to have as part of their character. For example, you can make a story card for Orcs, which the player can pick as their race.

A Character Creator Scenario doesn’t have an opening Prompt like other scenarios—instead, the opening is AI-generated based on whatever the player picks for their character. If they pick an Orc bard from the desert, a Character Creator Scenario may start them off by playing their lute at an Orc-only tavern in the badlands. If they pick an Elven rogue from the Black Hand Assassin Faction, their story might start them with receiving an order to assassinate the Elven king. The combinations are infinite and endless!

Character Creator scenarios are ideal for large-scale worlds with endless possibility and infinite combinations of choice, where no one start will fit every player.

• The main point of a Scenario is to present an idea for play, and save the user time in setting it up. A good Scenario has a unique and interesting idea, and has well-functioning, well-made Plot Components that further enhance the idea.
• When writing your initial Prompt for a Scenario, go long. You aren’t just bringing in the player, you’re setting up the AI for the first few actions worth of play. Start by giving some flavor text to set the mood, give at least a paragraph of background about the setting, take at least a paragraph to set up whatever is happening in the scenario, use ${Placeholders} (explained in Basics) to build some customization, and leave it open-ended so the player can take the story in whatever direction they want.
• Remember: the first thing that happens after your prompt, unless you use scripting to change it, is an AI-generated action.
• Your Plot Components need to be general to the entire scenario, and you should write them with the understanding that the player may want to add their own details to it, or they might not want to change it at all. Expecting players to always do one or the other can lead to disappointment for both parties.
• You should aim to keep all components as short as possible, typically under 400 characters, especially if you want players with less context space to be comfortable playing it.
• Before you publish your Scenario, be sure to start it a few times to see how it plays for the first few actions. There may be something the AI isn’t understanding that you can improve, or you may find a typo, or that a tweak to your prompt gives you better output. Just go through and make sure that it’s running the way you like before you publish it.
• Bring your Scenarios on the Discord: we have places for you to talk about them, get advice on them, and share links to them with other players. If you’re unsure about anything, there are plenty of friendly people willing to help!

Click here to read more about our Discord Server →