Lorebooks

A lorebook is world knowledge that injects itself only when the story touches it. Mention the lighthouse, and the model quietly learns what the lighthouse is.

How activation works

Every time you send a message, ScyllaChat scans the recent chat (the scan depth, in messages) against each entry's keywords. Matching entries are injected into the prompt for that generation only. Nothing is permanently added to the chat.

Anatomy of an entry

• Primary keys: any one of them matching activates the entry (OR logic).
• Secondary keys: optional. When set, a primary AND a secondary key must both match.
• Content: the text injected into the prompt. Macros work here.
• Constant: skip the keywords, always inject. For the facts the model must never forget.
• Order: when several entries activate, higher order wins the token budget first.
• Probability: activate only some of the time, for flavor that should not appear every scene.

Timing: sticky, cooldown, delay

Three per-entry timers control pacing across messages:

• Sticky: once activated, stay active for N messages even without a match. Good for scenes that linger.
• Cooldown: after activating, refuse to activate again for N messages. Stops a fact from being hammered in.
• Delay: do not activate at all until the chat is at least N messages long. Late-story reveals.

Recursion

With recursion on, the content of an activated entry is itself scanned for other entries' keywords. A "Meridian" entry that mentions the reef can pull the "reef" entry in with it, chains included, within the book's token budget.

Where entries land

By default entries land at the World Info markers of your preset (before or after the character definition). An entry can instead choose @depth positioning: injected into the chat N messages from the end, like an Author's Note. Use depth for knowledge that must stay in the model's face.

Three scopes

• Global: active in every chat.
• Per character: bound to one card. Cards imported with an embedded book get this automatically.
• Per chat: active only in the current conversation. Pick from Active Lorebooks in the chat's ⋯ menu.