Lorebook

Overview!

Think of a Lorebook as your character’s world memory.

Your character’s description (persona) can only hold a limited information — just the basics about who they are and what they do. A Lorebook is where you can store much more — details about the world they live in, other characters, events, items, or special rules that shape your story.

Instead of cramming everything into the character’s profile, you can keep all that extra information safely inside a Lorebook.

Then, when you chat, the system automatically brings up only the relevant parts at the right time.So your character always remembers what’s important — without getting confused or running out of space.

🧩 How it Works

• A Lorebook is made up of entries (think of them like statements of information).

• Each entry has two main parts:

  1. Keywords — triggers that tell the system to load the entry’s content into the chat context.

  2. Content — the facts or story that should be added to chat context when those keywords appear.

• When any of the keywords show up in the last 4 messages (both {user} and {char}), that entry’s content is added to the chat’s context and used to generate a new response.

• It stays active for about 2 turns (user message and the AI’s next one). If the keyword keeps coming up, it stays active longer.

• The system limits how much lore can load at once so that the whole context memory is not consumed by the lore — about 20% of the total context memory.

  • Around 740 tokens for Free users.

  • Around 1600 tokens for True Supporters.

  • Around 3,080 tokens for I’m All In users.

✏️ Creating a Lorebook

1. Go to the main menu and click Create → Lorebook.

2. You’ll see a new Lorebook page. Fill out these parts:

   • Name: What your Lorebook is called (for you to recognize it).

   • Description: A short summary (this doesn’t affect chat).

   • Cover Image: Pick or generate an image that fits your world.

   • Tags: Add relevant tags.

1. Click Add Entry to start building your Lorebook.

2. You can have up to 5,000 entries in one Lorebook.

(coming soon) You'll also be able to import Lorebooks from other platforms. Just upload them in .JSON format — they’ll appear in the editor and can be edited right away.

📜 Adding Entries

Each entry is one piece of information — such as a character, place, event, or rule.

Here’s what you’ll fill in:

• Name: A label for your entry.

• Keywords:

  • Add words or phrases that will “wake up” this entry.

  • Type one, then press Enter to save it.

  • You can add several keywords for one entry.

  • Keep them specific — like names or key terms.

  • If two entries share a keyword, both will be added when that word appears in chat.

• Content:

  • Write the info that should be added to context.

  • Keep it clear and simple — 2–5 sentences are usually perfect.

  • Maximum: 1,000 characters per entry.

Example:

If You or the Character mention “café” in chat, that bit of information will be added to the chat context, generating a response based on that info.

Keyword Matching

Prefix and Suffix

You can use a * symbol (called a wildcard) to match parts of a word. This helps trigger lore when the keyword appears as part of a bigger word.

Examples:

• *book → will match “storybook,” “notebook,” “logbook”

• home* → will match “homeland,” “homework,” “homemade”

Recursive Entries

Lore entries can’t trigger each other. That means if one entry mentions another keyword, it won’t cause more lore to load. Only the actual chat messages are checked for keyword matches — not the content inside other entries.

Multiple Words

Keywords can include more than one word, but the full phrase has to match exactly.

Example:

• The keyword coffee shop will only match when coffee shop appears together in chat — not if the words are separated.

Shared Keywords

If two or more entries share the same keyword, they’ll all be added to the context when that keyword appears in chat.

Using {{user}} and {{char}}

You can also use {{user}} and {{char}} as keywords. These automatically match whenever the user’s name or the character’s name is mentioned in chat. It’s a handy way to add background information when someone refers to the user or the character directly.

🔗 Attaching a Lorebook to a Character

1. Open your Character Editor.

2. Scroll to the Advanced section.

3. Under Lorebook, click Attach Lorebook.

4. Pick one from your list and hit Save.

Once attached:

• The Lorebook connects to that character’s all chats.

• You can Edit or Remove it anytime.

• Only one Lorebook can be attached to a character.

• Any changes you make to the Lorebook apply to existing chats as well — no need to reattach.

💡 Tips for Better Results

✅ One topic per entry. Each entry should focus on one thing — one character, place, rule, or event.

✅ Be specific with keywords. Use specific names or titles — not general words like “world” or “magic.”

✅ Keep content short and factual. Don’t write full stories in one entry — just what’s needed for the AI to stay accurate.

❓FAQ

Q: Can I use more than one Lorebook per character? A: Not right now — one per character.

Q: Can I add Lorebooks to public characters? A: No, right now Lorebooks are only supported for private characters

Q: Can I share my Lorebook with others? A: Not yet. Public and shared Lorebooks are planned for a future update.