LumiChat AI

Lorebook setup guide

SpicyChat AI Lorebook Guide 2026: Create, Use & Fix It

Build a SpicyChat AI Lorebook with better entries, keywords and tests. Learn current limits, wildcard rules, attachment steps and fixes when lore does not trigger.

Author: LumiChat AI TeamPublished:

12 min read

Quick answer

What this guide explains

A SpicyChat AI Lorebook is a keyword-triggered store for world facts, side characters, places, events and rules. Current official documentation says an entry loads when one of its keywords appears in the last four chat messages, stays active for about two turns and shares a lore budget capped near 20% of the available context. The reliable setup is one topic per entry, two to five factual sentences, specific trigger words and a short test chat. Use a Lorebook for conditional world knowledge, not for the character’s core identity or every fact you want remembered.

  • What a SpicyChat AI Lorebook is
  • How SpicyChat Lorebook matching works now
  • Create a useful SpicyChat AI Lorebook in ten minutes

Featured companions

Three characters refresh on each visit. Cards play a promo video when available and otherwise show the character image.

Zahara Nyx

Savanna huntress

Zahara Nyx

Bold wilderness energy for chase scenes, rivalry, and adventurous roleplay under an open sky.

AdventureRivalryWild
Start chat

Ginza club queen

Sato Akari

An elegant Tokyo Ginza club character with warm, ritual-rich replies for users who want refined emotional companionship.

ElegantRitualCompanion
Start chat

Osaka underground DJ

Takahashi Nozomi

A Techno DJ from Shinsaibashi with direct energy and a strong sense of rhythm, suited to music, nightlife, and lively chat.

DJTechnoNightlife
Start chat
Real LumiChat character catalog for testing SpicyChat AI Lorebook scenes and memory

A SpicyChat AI Lorebook solves a specific roleplay problem: the character profile is too small for every town, faction, object, side character and rule, but pasting the entire world into every prompt wastes context. A Lorebook keeps those details in separate entries and loads only the entries whose keywords appear in the recent conversation.

We checked SpicyChat's current official Lorebook documentation and live creation navigation on August 12, 2026. The feature is now visible in Create and My Creations. The official guide also keeps several boundaries clear: one Lorebook can be attached to a character, the character must currently be private, and JSON import is still described as coming soon. This article focuses on building and testing entries rather than repeating a broad SpicyChat review.

What a SpicyChat AI Lorebook is

A Lorebook is conditional world memory. Each entry contains keywords and content. When a keyword appears in the recent chat, the matching content is inserted into the context used for the next reply. This is different from permanent human-like memory: an entry can exist but remain inactive until a trigger appears.

Put this inBest informationExample
Character personaStable identity and behavior“Mira is a careful archivist who dislikes rushed decisions.”
LorebookConditional world knowledge“The Glass Archive closes when the silver bell rings.”
Chat messageCurrent action and temporary state“We are standing outside the east entrance at midnight.”
Your own notesBackup and source of truthA compact scene recap before major edits

The most common mistake is using a Lorebook as a second giant persona. Keep identity in the character definition, current action in chat and reusable world facts in Lorebook entries.

How SpicyChat Lorebook matching works now

The current official guide says keywords are checked across the last four messages from both user and character. A matched entry stays active for roughly two turns—one user message and the following AI reply—and remains active when the keyword continues to appear. Lore is limited to about 20% of total context so it does not consume the whole conversation.

The documented approximate lore budgets are 740 tokens for Free, 1,600 for True Supporter and 3,080 for I'm All In. Those figures explain why thousands of available entries do not mean thousands can load in one reply. Context, plan details and product behavior can change, so confirm the current account screen before treating a number as permanent.

SpicyChat AI Lorebook editor used to organize entries and keywords

Create a useful SpicyChat AI Lorebook in ten minutes

  1. Open Create and choose Lorebook.
  2. Give the book a recognizable name and a short description; the description is for management and does not drive the chat.
  3. Add one entry for a place, person, faction, object or rule.
  4. Add two or three specific keywords that a real conversation would naturally use.
  5. Write two to five factual sentences and avoid instructing the model to narrate an entire scene.
  6. Save the Lorebook, open the private Character Editor, find Advanced and attach the book.
  7. Run one message without a keyword and one with the keyword, then compare the replies.

SpicyChat documents up to 5,000 entries in one Lorebook and a maximum of 1,000 characters per entry. Treat those as storage ceilings, not writing targets. Ten clean entries are easier to debug than one hundred vague ones.

Use a repeatable Lorebook entry template

Use the same five-part pattern for each entry: subject, identity, relationship, rule and visible consequence. The entry should state facts the model can apply, not a chapter of prose it must summarize.

FieldWeak versionBetter version
NameCity infoGlass Archive
Keywordsworld, city, placeGlass Archive, silver bell, east archive
ContentA long history of the city“The Glass Archive protects forbidden maps. The east entrance closes after the silver bell. Archivists never discuss the lower vault in public.”
Test“Do you know the lore?”Mention the silver bell while choosing an entrance

Write secrets carefully. If an entry says the character knows a hidden fact, the model may reveal it too early. State who knows the fact and under what condition it may be disclosed.

Choose keywords, phrases and wildcards

Specific proper nouns are safer than broad words. A trigger such as “magic” can activate in many unrelated replies and fill the lore budget, while “Ashen Treaty” activates only when that part of the world matters. Multi-word keywords require the phrase to appear together.

SpicyChat supports a wildcard at the beginning or end. The keyword *book can match notebook or storybook, while home* can match homeland or homework. Wildcards are useful for word forms but risky on short roots. Two entries can share a keyword, and both will load; Lorebook content itself does not recursively trigger another entry.

Attach the Lorebook and understand current limits

The current workflow is Character Editor → Advanced → Attach Lorebook → choose a book → Save. Changes to the attached book apply to existing chats, so you do not need to detach and attach after every edit.

Current boundaryPractical meaning
One Lorebook per characterMerge related world material before attaching
Private characters onlyPublic-character users cannot add a personal book today
Up to 5,000 entriesLarge capacity does not increase per-reply lore budget
1,000 characters per entryShorter factual entries usually retrieve more cleanly
JSON import marked coming soonDo not promise current cross-platform import

Check the live editor before planning a migration. A button announced for later is not the same as a working import path.

Test a Lorebook with an A/B conversation

Create a harmless test entry about the Glass Archive. First ask the character to choose a building without using any trigger. Save that reply. Then mention “silver bell” and ask which entrance remains open. The second reply should use the attached fact without dumping the whole entry.

Repeat with a correction: change east to north in the Lorebook, save, begin a fresh short test and use the trigger again. This separates cached scene momentum from the edited source. The role play chat guide provides a seven-turn scoring method for voice, initiative and continuity.

Why a SpicyChat Lorebook does not trigger

SymptomLikely causeFix
Entry never appearsKeyword was not in the recent four messagesUse the exact phrase naturally in a new message
Wrong entries loadKeyword is too broad or sharedReplace it with a proper noun or longer phrase
Facts are incompleteSeveral entries exceed the lore budgetReduce active entries and shorten content
Old fact persistsCurrent chat context still contains itCorrect once, then test in a fresh short chat
Nothing changesBook was not saved or attachedReopen Character Editor and verify the attachment

Do not test by asking “Did you read my Lorebook?” A model can agree without retrieving the entry. Ask a decision whose correct answer depends on one exact fact.

Prevent keyword collisions and context overload

Use a namespace-like naming pattern for crowded worlds: “Rhea captain,” “Rhea treaty” and “Rhea harbor” are easier to isolate than three entries triggered by “Rhea.” Keep one topic per entry, and do not repeat the same rule in persona, Lorebook and chat unless repetition is intentional.

When several people enter one scene, activate them over more than one turn. A single message containing ten names can load many entries at once and squeeze the actual conversation. The goal is relevant recall, not maximum token usage.

Lorebook versus persona and chat memory

Persona answers “who is this character?” Lorebook answers “what conditional fact should be available when this subject appears?” Recent chat context answers “what is happening now?” Semantic or editable memory can preserve user-specific facts, depending on the product and plan.

A Lorebook cannot prove long-term memory by itself because its trigger can reinsert a fact every time. To test continuity, include a separate invented detail that is not stored in the book and follow the return-session method in the AI companion memory guide.

When a simpler character platform is a better fit

Lorebooks reward users who enjoy authoring, naming triggers and debugging context. If you mainly want to choose a finished character and start talking, a curated directory reduces setup. Browse real LumiChat characters, run the same short scene on two personalities and compare behavior rather than editor depth.

The SpicyChat alternative guide compares platform-level choices. This page has a narrower job: make one SpicyChat Lorebook reliable. Keep the two search intents separate so a tutorial does not turn into another generic ranking.

Final checklist

Start with five to ten entries, not five hundred. Give each entry one subject, two or three specific triggers and two to five factual sentences. Attach the book to a private character, run a no-trigger/trigger comparison and repair broad keywords before adding more lore.

The three real LumiChat character cards below refresh randomly on each visit. They offer a fast baseline: test the same world fact on a ready-made character, then decide whether Lorebook authoring adds enough control for your story.

FAQ

What is a SpicyChat AI Lorebook?

A Lorebook is a collection of keyword-triggered entries that adds relevant world, character, event, item or rule information to the chat context.

How many Lorebooks can one SpicyChat character use?

Current official documentation says one Lorebook can be attached to one character at a time.

Can I attach a Lorebook to a public character?

Not currently. The documented feature is for private characters, so verify the live editor before relying on a public-character workflow.

How many entries can a SpicyChat Lorebook contain?

The current guide documents up to 5,000 entries, with a maximum of 1,000 characters per entry. Only a limited lore budget can load in one response.

Why is my SpicyChat Lorebook not working?

The keyword may be missing from the recent four messages, too broad, competing with other entries or outside the active lore budget. Verify attachment and test one exact trigger.

Can SpicyChat import Lorebooks from JSON?

The current official guide labels JSON import as coming soon. Do not plan a migration until the live editor exposes and completes the import flow.

Is a Lorebook the same as long-term memory?

No. Lorebooks reinsert conditional facts when keywords match. Long-term memory concerns what a character retains across turns or sessions without relying on the same trigger.

LumiChat AI Team

LumiChat AI Team

Editorial Team

LumiChat AI 产品与编辑团队,负责核验产品现状、角色路径与可复用测试方法。