Attachments
Attachments are add-ons you can put onto your chatbot of choice. They can make help roleplay and chats more immersive by giving them more information to work with.

How to Add Existing Attachments to Your Chat
Desktop
If you'd like to add an attachment to an existing chat, you want to scroll down on the right side of the hot bar until you see the two options highlighted in red in the bottom right corner. You should see Lorebooks (lorebooks are also an attachment, they just get their separate tab) and Attachments.

Mobile
If you want to assign attachments on mobile, you have to click on your character's icon in the top left of the chat to open the menu. See below.


Selecting Attachments of Your Choice
Upon selecting "Assign Attachments" you should be greeted by this screen (or something similar on mobile). From here, you should be able to see all of the community's creations, ranging from: System Prompts, Scenarios, and Always Active System Prompts.

Clicking on the icon or title of people's attachments will show you the content that they embedded into their entry. Often times, they will also create creator memos at the bottom of the page. It should look like this:

From here you can see the content which tell you exactly how and what the attachment will do to affect your roleplay. In this case, pelele_laylay's Unadulterated Rage will make your {{char}} super angry! Make sure to read the creator notes beneath the content box, often times creators will include important notices as to what the attachment is intended for!
Once you've finished reading an attachment of your interest, and you've decided you want to add it, make sure to check the box at the top right corner to select it.


Finally selected all the attachments you want to add your chat? Make sure to save at the very bottom by clicking "Assign Attachments."

Creating an Attachment

You can create an Attachment by going to the Attachment page from the sidebar, and then clicking on the tab of the Attachment you want to make. From there, click the bottom + sign (in red). Alternatively, you can click the top + sign (top right corner) and choose what you'd like to create from a menu.
Lorebooks

All Lorebooks must have the Lorebook Name, Entry Name, at least 1 Trigger, and the Description filled out for each entry. The maximum number of entries you can have is 200. Up to 25 entries can be triggered at once per message!
Entry Name
This is the name of your entry, most helpful for seeing what entry is triggered and finding it again to edit later. The LLM does take this field into account when pulling from the lorebook.
Entry Type
This is the category, basically, for this entry. This is set to Character as default, but can be changed to Location, PlotEvent, Item, or Other. The LLM does take this into account when pulling from the lorebook, but the affect is minimal so don't worry about it too much.
Triggers
These are the keywords that the LLM is using to decide to pull from the Lorebook. These are not case sensitive, plural/singular sensitive, or possessive sensitive. You want these to be words that, when they appear in chat, they call upon this entry for context. The contents of user's last message and char's message before that are used for these triggers to determine char's next response. Try not to use the same keywords for more than a handful of entries.
Trigger Condition
The Trigger Condition field is currently a WIP, though you can fill it out for when it eventually goes live. "When {{char}} does [THIS], [THIS] will happen." "When {{user}} is at home." Stuff like that.
Description
This is the meat of the entry. Generally, you want to keep this concise. Character limit is 1500 for each entry, but it's recommended to keep it around 500, especially because so many entries can be pulled at one time. Some examples of entries can be: character sheets for NPCs, rules of the universe, setting, creatures/monsters, food/drink, etc. Remember to save when you're done messing with your Lorebook!

Scenarios
This is a way to force a change in a setting, plot, etc.! You can make the world be zombies, or in outer space, or go to Disney! You can also include macros such as {{char}} and {{user}}, give instructions on the first randomly generated message ({{char}} should begin the scene fitting the scenario, by telling {{user}} that they're going to Disney.
System Prompts
This field is for things you want the AI specifically to do, such as types of narration. At the moment there is no Attachment style for things to go into the Description/Personality fields, so here you will also find stuff such as forcing {{char}} as a demi-human, into the omegaverse, etc.
Always Active System Prompts
This is most useful for Utility things such as not speaking for {{user}}, translations, and meters.
Last updated