View source for Basic Multi-character guide

=== This guide is designed and written to help you create your firs multi-character bot on Crushon AI ===
We will walk through each step to bring your characters to life''', one step at a time''', but first, you need to know that there’s no ''wrong'' way to create and publish a bot!

Every model has its own way of processing info, often in different formats. So keep in mind: a bot might work great on one model and not so well on another, depending on the prompts you've used. That's why it's super important to '''test''' and see what works with your writing and creation style!

That said, this guide is made to help you '''get started creating your first bots''' with a general structure that should work on most models 💡
----

=== COMMON TERMS TO KNOW ===
{| class="wikitable"
|'''TERM'''
|'''DESCRIPTION'''
|-
|'''<nowiki>{{char}}</nowiki>'''
|A macro for the '''characters' names''' as input in bot creation
|-
|'''<nowiki>{{user}}</nowiki>'''
|A macro that will show up as the '''user's persona''' name in chats
|-
|'''Prompt'''
|A prompt is a message or set of '''instructions sent to an LLM''' telling it how to behave. Technically, all botmaking is just "prompting" an LLM to portray a character a certain way
|-
|'''LLM'''
|Large Language Model. Also called a "model" It's '''the "AI" that powers the convo''' you have with bots. Different LLMs will give you different kinds of replies depending on your input
|-
|'''Models'''
|Same as above, just another way to refer to LLMs
|-
|'''Tokens'''
|Tokens are '''used for context and memory''', and the more you write, the more tokens will be used. Keep in mind that the fewer tokens you use, the better, because the more permanent tokens you take up, the less memory the bot will have left to work with during roleplay
1,000 tokens ≈ 750 words on average in English
|-
|'''Permanent Tokens'''
|Permanent tokens are the '''information your bot retains long-term''', as mentioned earlier, '''less is more'''.
The sections that store tokens permanently are: ''Personality'', ''Appearance'', and ''Scenario''. Everything you put in these sections will be remembered by your bot
|}

== THE BASICS - BEGINNER LEVEL CREATION ==
First, you need to go to the dedicated section: click on '''Create''', then choose '''Create Character''', and finally, '''Start from Scratch'''

== Name & Age ==
For the name, It's usually best to put your '''characters' names''' here, or their '''nicknames''', if that's how they're mostly known.

For the age, you need to indicate your '''characters' fictional age'''.

''Note that minor characters are not allowed.''

== Uploading your character's photo ==
You can upload your avatar here!

Avatars can be in various formats including webp, png, gif, and jpeg, with webp working best (gif can be converted to webp and then uploaded). It is recommended to upload a 9:16 or 3:4 image from which a 1:1 (512x512) avatar is captured. The image should be less than 10MB.

''Do not upload images containing underage individuals, as this may result in your bot being banned or restricted from display.''

== Scene card ==
This feature is '''optional''', but it allows you to add a '''background''' that will be visible during your chat, for you and for others

For clarity, it is recommended that you upload a picture of 3072*2048, 1920*1080 size, less than 5MB. It will be a scene when chatting. The rectangular part in the crop is the area you display on the mobile phone

== Introduction ==
This is where you describe your bot and give others an idea of what the bot is about.

'''Whatever you write here will be visible to other users.'''

As mentioned, this section has NO impact on the bot’s behavior in chats. You can include your scenario, who your character is, or anything else relevant.

== Character's Visibility ==
Visibility lets you, as the name suggests, choose your bot's visibility setting. Whatever you pick, you '''can always change it later''', so no stress.

'''Public''' will make your character accessible to everyone, '''Unlisted''' means only people with the link can access it, and '''Private''' means you will be the only one able to access it.

== Rating ==
Your rating will determine whether your character appears among '''unfiltered (+18) bots''' or not.

''Also note:'' If you choose the Filtered rating, no Unfiltered-related sensitive words can appear in your character, otherwise it will be banned for violating community standards.

== Tags ==
Tags will help others users understand the '''key characteristics''' your character is based on

It's better to tag your character with the relevant keywords, at the very least, make sure to include your character's '''POV''' ''(Point of view or what the user is supposed to be)'' '''malpov''', '''fempov''', or '''anypov'''

Note that if you want to view unfiltered and +18 tags, your bot must have the '''Unfiltered Rating'''

== Gender ==
Put your character’s gender here, '''male''', '''female''', or '''non-binary'''

== Character Definition ==
Here, you can choose whether others will be able to see what you've written in your bot's definition.

It's up to you to decide if you want it to be accessible or not

== Greeting ==
The greeting is '''''very''''' important, as it sets the overall tone of the narration for the rest of the roleplay, at least at the beginning. It’s also the first message users will see when they open a convo with your character.

'''Note :'''

Using '''<nowiki>{{user}}</nowiki>''' in your greeting will display the name of the user’s persona.

Using '''<nowiki>{{char}}</nowiki>''' will display the names of your characters, so, '''it's not recommended to use this macro in multi-characters greeting'''; however, it's good to be aware of it.

=== This is where your ''personal writing style'' comes in, however, there are a few key recommendations to keep in mind : ===
'''The narrative perspective matters'''

* '''❌ First person''' (I/my): Don't use this POV. Most models struggle with it and may start confusing the bot with the user or make the bot speak for the user, especially with multi-character bot
* '''Second person''' (you/your): This can work with some models and break others. It’s not the most stable choice
* '''✅ Third person''' (he/she/they): This is the most reliable perspective. It gives the model clear structure and minimizes errors
'''To keep in mind while writing'''

'''⚠️ Length matters''': If your intro is very short, your bot will likely give short replies at the start too. It’s better to aim for at ''very'' least 100 words in your greeting so the character has enough material to work with.

'''❌ Avoid describing the user''' behaviorally, or through dialogue. If your intro makes the bot talk ''for'' the user, it will likely keep doing it, and most users ''hate'' that. You can mention the user or describe who they, but don’t write their lines or actions.

'''Include a line of dialogue''' from each of your characters in the greeting, it helps anchor their way of speaking.

'''Give context''': Include a setting, what’s happening, and a situation that sets the scene (time, place, etc.)

'''✅ End with a hook''' that leaves space for the user to respond or react.

Example:
 [Name1] leaned back in his chair, hands resting behind his head, completely relaxed as the deep bass of the studio filled the room with the latest track he and [Name2] had just finished writing and composing. The two idols turned to <nowiki>{{user}}</nowiki>, their manager, eyes locked on her, waiting expectantly as the song came to an end.
 
 [Name2] was the first to pull off his headphones as the final notes faded, a soft blush creeping across his cheeks, one that even the dim studio lights couldn't hide. "'''So, <nowiki>{{user}}</nowiki>, what do you think? L-Like it?'''" He asked, nervously brushing a blond strand from his forehead without quite meeting <nowiki>{{user}}</nowiki>'s gaze.
 
 [Name1] snorted beside him, tossing his own headphones onto the mixing board before shaking his perpetually messy black hair. "'''Obviously. She'd better. This fuckin' song's about her.'''" He shot a pointed look at her.
 
 "'''How about that line Manager,'<nowiki/>''Trapped between our hearts so true, kissed from every side by me and you''<nowiki/>'?'''" A sly grin played on his lips.
'''Writing format:'''

Use <code>*</code> around your text to make it ''italic'' ➤ use this to frame your entire text or just some ''words''

Use <code>**</code> around your text to make it '''bold''' ➤ use this for your character's '''dialogue'''

'''Example:'''

<nowiki>*</nowiki>The crowd roared, fans shouting, a chaotic symphony over the thunderous applause.*

<nowiki>**</nowiki>"Thanks to all of you, we wouldn't be here without your support!"**

== Personality ==
'''This is where all the most important info about your characters goes.''' It's what gives them a background, specific behaviors, a look, a vibe, etc... This also makes up most of your permanent tokens, basically, what your bot will remember throughout the RP, no matter how long it goes. This is the ''heart'' of your bot.

Again, there is no '''wrong''' or '''right''' way to create a bot. Generally, it’s just a matter of '''personal preference''' and, most importantly, '''tokens memory'''. There are several different styles to fill this part of a bot, for now, we’ll focus on just one, but don’t hesitate to experiment and try various styles and see which one you like best!

=== IMPORTANT - THE MEMORY ===
'''⚠️''' Multi-character bots are particularly challenging with this, but you should definitely not exceed 2,000 '''tokens''' in your personality section. Most Models (LLMs) has low context limit, '''going beyond 2,000 tokens will result in poor memory performance''' and may even cause the bot to break entirely.

Keep in mind that '''less is more'''.

'''2,000 permanent tokens is an absolute maximum,''' It is best to stay between '''500 and 1,500 tokens''', especially if it’s your first bot.

=== TEMPLATE STYLE | MULTI CHARACTERS ===
You can choose how to write the information in each category, whether in '''bullet points''' or '''full sentences.''' It’s up to you and depends mainly on what you’re most comfortable with, but keep in mind the tokens you use

➤ You just need to fill it out point by point based on the characters you have in mind
 '''[SETTING: <nowiki>{{char}}</nowiki> consists of two characters, [name1], and [name2].]'''
 
 ['''Character 1 Details''':
 '''Name''': (nicknames, titles, alias, etc.) 
 '''Gender''': (male, female, both, whatever etc.) 
 '''Species''': (human, vampire, werewolf, etc.) 
 '''Occupation''': (student, CEO, unemployed etc.)
 '''PHYSICAL DESCRIPTION:''' (size, build, skin tone, general appearance, any details)
 '''PERSONALITY:''' (Traits, behavior etc.)
 '''BACKSTORY:''' You can write it out in '''narrative style''' or keep it short and snappy with bullet points.]
 
 ['''Character 2 Details''':
 '''Name''': (nicknames, titles, alias, etc.) 
 '''Gender''': (male, female, both, whatever etc.) 
 '''Species''': (human, vampire, werewolf, etc.) 
 '''Occupation''': (student, CEO, unemployed etc.) 
 '''PHYSICAL DESCRIPTION:'''(size, build, skin tone, general appearance, any details)
 '''PERSONALITY:''' (Traits, behavior etc.)
 '''BACKSTORY:''' You can write it out in '''narrative style''' or keep it short and snappy with bullet points.]
 
 '''[Groupe Dynamics:'''
 
 ''Example'': 
 - [name1] and [name2] are best friend. They’re both idols and fight for <nowiki>{{user}}</nowiki>'s attention. 
 - <nowiki>{{user}}</nowiki> is [name1] and [name2] manager.]
 
 '''[Additional Information:''' Anything you find relevant, it can be lore details, context, or whatever else fits.''']'''
You can add as many characters as you want, but the more you add, the easier it is for the model to mix them up and to stay consistent. You'll also have less room to describe them properly, since you need to keep your total tokens low (under 1500, or 2000 max).

If you really want to include lots of characters, '''consider switching your bot to an "RPG" model'''. It might be easier for the model to handle.
----

=== TEMPLATE STYLE | RPG WORLD ===
RPG bots are built differently from classic bots, instead of focusing on one or a few characters, they focus on a full world or setting.

Here's an example:
 '''''[SETTING:'''''
 
 E.g:
 ''- Medieval fantasy world.''
 ''- <nowiki>{{user}}</nowiki> has just arrived in Velmora, a bustling city where mercenaries, thieves, nobles, witches, and monsters walk the same streets.''
 ''- They've joined the Guild of the Red Serpent, infamous for accepting any kind of job—no matter how dirty, dangerous, or depraved.''
 ''- <nowiki>{{char}}</nowiki> will adapt naturally to <nowiki>{{user}}</nowiki>'s choices and guide them through the world.]''
 
 '''''[UNIVERSE:'''''
 
 E.g:
 '''''-''''' ''The story takes place in the Kingdom of Valen, a dark, medieval realm filled with humans and mythical creatures like elves, trolls, dwarves, beastkin, demons, and more.''
 ''- A royal family rules from the capital, but in the shadows, power often belongs to the guilds.''
 ''- Magic exists, but it is rare, dangerous, and controlled. Only those born with it or trained in the arcane arts (e.g., mages, necromancers etc.) can wield it safely.]''
 
 '''''[RULES:'''''
 
 E.g:
 ''- No modern tech or weapons.''
 ''- No overpowered characters.''
 
 '''''[ABOUT <nowiki>{{user}}</nowiki>:'''''
 
 Example:
 ''At the start, <nowiki>{{user}}</nowiki> must choose:''
 '''''Race''': Human, Elf, Orc, Beastkin, Demon, etc.''
 '''''Class''': Assassin, Mage, Healer, Spy, Warrior, etc.''
 '''''First Mission''''' ''from the guild board or guild receptionist.''
 ''- Missions vary in tone and difficulty: assassinations, monster hunts, escorts, investigations, cursed relic retrievals, bounty captures, absurd requests from nobles, and more.''
 ''- Based on <nowiki>{{user}}</nowiki>'s choices, <nowiki>{{char}}</nowiki> will introduce a detailed cast of NPCs allies and enemies (Appearance and race should be mentioned smoothly each time a new NPC is introduced.)]''
 
 '''''[NOTABLE CHARACTERS:''' (Completely optional)''
 
 Example:
 '''''King Alden''''' ''- Ruler of Valen. Old, strategic, feared.''
 '''''Madam Thorne''''' ''- Guildmistress of the Red Serpent. Seductive, cold, calculating.''
 '''''Selene''''' ''- Receptionist at the guild. A flirtatious rogue elf.''
 '''''The Shadow''''' ''- Leader of a rival guild. Identity unknown, motives unclear.''
 '''''Drex''''' ''- Orc berserker often assigned as a teammate. Brutal but loyal.]''
 
 '''''[ADDITIONAL INFORMATION:''' Anything you find relevant, it can be lore details, context, or whatever else fits.''']'''''

== Appearance ==
Since we don't have just one character, filling out this section can be a bit tricky. 

For an RPG bot, it's better to leave it empty. For a multi-character bot, you can either list physical details here, or keep everything in the personality and leave this section blank, or write a short summary here, whichever you prefer.

'''TEMPLATE STYLE | MULTI CHARACTERS'''
 '''[CHARACTER 1 PHYSICAL DESCRIPTION:'''
 '''Hair''': (color, style, length) 
 '''Eyes''': (color, any special qualities or detail) 
 '''Body''': (size, build, skin tone, general appearance, any details such as scars, tattoos etc... or any important features) 
 '''Clothing''': (Either a specific outfit like a "red cape" or general fashion vibe like "medieval style", you can also make a mix of both)''']'''
 
 '''[CHARACTER 2 PHYSICAL DESCRIPTION:'''
 '''Hair''': (color, style, length) 
 '''Eyes''': (color, any special qualities or detail) 
 '''Body''': (size, build, skin tone, general appearance, any details such as scars, tattoos etc... or any important features) 
 '''Clothing''': (Either a specific outfit like a "red cape" or general fashion vibe like "medieval style", you can also make a mix of both)''']'''

== Scenario ==
The scenario is an additional category like personality and appearance. All the information you put here will be '''stored in the bot's memory'''.

These three sections, ''Personality'', ''Appearance'', and ''Scenario'', are “'''permanent tokens'''”.

The only difference is that the scenario is recalled more ''frequently'' than the other two. To explain it simply, this is because of how memory is prioritized, ''imagine a ladder the bot climbs to find info: the scenario is placed at the very bottom, it accesses it faster and more often.''

This section should contain the '''key''' '''information''' you want the bot to '''absolutely remember'''. Personally, I recommend adding elements like rules/lore/world context/setting or "relationship with <nowiki>{{user}}</nowiki>".

'''You can think of your scenario as a command for your bot, that tells them which key topics and context it should always remember.'''
'''Example scenario | MULTI CHARACTERS''':
 [Name1] and [Name2] are rising idols and childhood friends. They make life hard for <nowiki>{{user}}</nowiki>, their manager, with constant fights, excessive flirting, and competing for <nowiki>{{user}}</nowiki>'s attention.
'''Example scenario | RPG''':
 This is a dark medieval RPG with mature themes, where death, romance, betrayal, and unexpected twists are all part of the roleplay. <nowiki>{{user}}</nowiki> is part of the Red Serpent guild in the city of Velmora.
'''IMPORTANT:'''

Keep your scenario '''short and concise''', just the essentials. Avoid overloading it with details, also, '''avoid including temporary or one-time actions''' (like "''the character is burning a village''"), or the bot may bring it back later in the roleplay even after it's over.

== Example Conversation ==
This section tells the bot how your character is supposed to speak.

It's '''optional''', but useful if your character has a specific dialect (stutter, accent, slang, etc...)

'''For RPG bots, it's better to leave this section empty'''. For multi-character bots, it's useful to fill it in to help distinguish them if their personalities are very different.

'''Example :'''
 User: "So, you can sing?"

 [Name1]: "Sing? Babe, Beyoncé's my spirit animal."

 User: "What about you, you can sing?"

 [Name2]: "Hmm... yeah, a little. Nothing wild, though, b-but fans swear I sound like an angel... Wanna judge for yourself?"

== Recommended chat setting for users ==
This part is '''optional''' too, but some users might appreciate it if you recommend a model for the bot you've created. If you're not sure which model to suggest, you can leave this blank for now and try out a few yourself to find the one that fits best, then add it later

'''Everything you put in your bot can be edited later''', so don't worry if something's missing or needs adjusting. I recommend saving your bot as unlisted and testing it a bit before publishing it officially.

=== ➤ Thanks for reading, can't wait to see what you create! ===