Story Cards & Memory Cards

On FictionLab, story cards and memory cards are powerful tools to help the AI remember things even as your chat goes on and on.

Story Cards

Story cards function as lorebooks for FictionLab, helping the AI understand specific words and elements in your scenario. Story cards are optional, but they add more depth to your scenario.

A key difference of story cards from other scenario sections is that story cards are inactive until they are triggered.

A story card consists of:

• Card Name – Name of the card. Not readable by the AI. Its purpose is to inform User of the story card's contents.

• Card Type – Defines the type of the story card such as Location, Class, Race, Faction or Custom. Not readable by the AI. Its purpose is to categorize the story card's contents for User.

• Card Triggers – Words or phrases that activate the story card. Not case-sensitive. Readable by the AI. Both the User reply and AI reply will be searched for trigger words.

• Card Entry – Contents of the story card which becomes available to and readable by the AI when the trigger words appear in chat.

Example: If your scenario includes a mysterious book called Weiss, the AI won’t recognize its significance unless you create a story card explaining its lore. The trigger word for this story card could be "weiss" and the content would explain the backstory of it.

Other things to note:

• Story cards help the AI adapt to the roleplay naturally by integrating world-building details when relevant.

• Only three (3) story cards can be active at the same time. If a new story card is triggered, the oldest active card is made inactive.

• Trigger words can come from the User Reply or the AI Reply. A commonly-used trigger is Location that is put in Headers via the Custom Scenario Instructions. For example, the header [City - 10:00AM] which will appear in each reply will keep a story card that is triggered by the word "city" active.

• Free users are limited to 10 story cards per scenario and FictionLab+ have access to 30 story cards.

Memory Cards

Memory cards help the AI remember important events that have already occurred during the roleplay. Think of them as sticky notes—small reminders that are presented to the AI throughout the session.

Memory cards significantly extend the AI's memory and, in the best-case scenario, allow it to recall events from thousands of messages ago!

Unlike story cards, memory cards are always active and don’t require trigger words to be used.

Important Guidelines:

• Use memory cards only to summarize past events.

• Do not use them to introduce new lore, plan future events, or give the AI instructions. Story Cards and Custom LLM instructions are made for that purpose.

• Misusing memory cards can negatively affect the quality of the roleplay.

Memory cards are automatically generated every 50 chat messages— a total of the User reply and AI reply.

For manual memory card generation, use the slash command /memory-cards N where N is a number from 10 to 50.

Free users are limited to 50 memory cards, while FictionLab+ users have access to 200 memory cards.

You can pin important memory cards to ensure they don't get deleted when the limit for memory cards is reached. Unpinned memory cards are deleted in order of creation to make space for new ones.

Make sure to click Pin then click Save to pin a memory.

Things to Note:

• Pinning too many memory cards will hurt the memory because there will be no space for new cards. Always leave some space for new memory cards.

• Memory cards are generated by a different AI model with a separate provider. They are not generated by the FictionLab chat models (LLMs) such as Ophelia or Oracle. Therefore, memory card generation may sometimes experience heavy traffic or errors separately from what the LLMs are exhibiting. Please report bugs on the official Discord server!