Lorebook Editor
The Lorebook editor manages SillyTavern-style World Info entries: text that can activate on keywords (or always, for constants) and inject into the model context during roleplay.
There are two kinds of lorebook:
- On a card. Every character can carry its own lorebook. It is saved inside the card's PNG or JSON, so it travels with the character.
- In the library. The Lorebooks tab holds standalone books. You can reuse them and attach them to characters.
The same editor is used for both:
- Character workspace → Lorebook tab (the lorebook that lives on the card)
- Lorebook vault → open a standalone book (Lorebook Vault)
A few terms: ST is SillyTavern. World Info is SillyTavern's name for lorebooks. Title is what SillyTavern calls the entry memo (or comment).
TIP
Field help icons (?) next to labels summarize SillyTavern World Info behavior. Prefer those for short definitions; this page covers the CharacterVault layout and tools.
Two-panel layout
Content stays in front. Extra controls open from the header so the editor can use the space.
- Left sidebar – Book settings, search, AI context usage, entry list, export, new entry
- Right panel – Entry title, keys, Enabled / Constant, and the content editor
Options and (on a character) Attach sit in the entry header. Click either to open a panel over the editor; click again, Done, or Escape to close. Opening one closes the other.
On a phone, the list and the entry swap: tap a row to edit, Back to return to the list. Attach is also next to book settings on the list so you can reach it without opening an entry.
Book settings
Expand Lorebook at the top of the sidebar:
| Setting | Role |
|---|---|
| Book name | Display name for the book |
| Description | Short description |
| Scan depth | How many recent chat messages ST scans for keys (book-level) |
| Token budget | Max tokens World Info may consume at once (book-level) |
| Recursive scanning | When on, activated entries can unlock others by naming their keys in Content |
| Map | Opens the Recursion map |
| Delete lorebook | Characters only: remove the lorebook from the card (when offered) |
Scan depth, Token budget, and Recursive scanning are saved in the book for compatibility. SillyTavern normally applies its own global World Info settings instead. CharacterVault uses the budget for its AI context bar and the recursion setting for the map warning.
Entry list
Each row shows a title (entry title / memo, or a fallback), key count, the token count of its content, context eye, Duplicate, and delete.
Duplicate asks for confirmation, then creates a copy. The copy gets the lowest free entry ID, which the confirm dialog shows (SillyTavern entry ids are unique integers, not a list index). The list is ordered by ID, so the copy appears at that spot. Title, keys, content, flags, and other fields are copied.
Search
Filter by title, internal notes, content, or primary keys. A result count appears when search is active.
AI context (Character Vault)
A compact AI context block shows how many entries are included and a token usage bar (book token budget when set, otherwise sampler context length).
| Control | Meaning |
|---|---|
| Eye on a row | Include or exclude that entry from Orion / AI toolbar context |
| All / None | Enable or disable context for every entry |
The eye only affects CharacterVault's AI. It is separate from Enabled (SillyTavern activation). An entry is sent to the AI only when it is both Enabled and eye-on. See AI Context → Lorebook.
Sidebar footer
Bottom of the sidebar:
- Export – Download ST-compatible JSON
- New Entry – Append a blank entry and open it
Entry detail
The header title is the ST entry title (memo). It is not sent as content. Next to it: Attach (characters only), Options, Duplicate, and Delete. Options shows a small accent dot when this entry has non-default settings.
Always on screen:
| Field | Description |
|---|---|
| Primary keys | Keywords or /regex/ that can activate the entry |
| Enabled | When off, the entry never activates in SillyTavern |
| Constant | Always-on; no keyword required |
| Content | Text injected when the entry activates (full CodeMirror + AI toolbar) |
Enabled and Constant are pressable chips (accent when on).
Options
Click Options to cover the content editor. Done or Escape closes it. Fields inside:
| Field | Description |
|---|---|
| Secondary keys | Optional filter keys when Selective is on |
| Selective + logic | AND ANY / NOT ALL / NOT ANY / AND ALL (ST selectiveLogic) |
| Insertion order | Higher numbers insert later / closer to the end of context |
| Position | Where content injects (before/after char, before/after example, or at depth) |
| Depth / role | For at depth: chat depth and system / user / assistant role |
| Case sensitive | Exact letter case for keys |
| Match whole words | Whole-word style matching for plain keys |
| Probability % / Use % | Chance the entry is inserted after it would activate |
| Non-recursable | Other entries cannot unlock this one via recursive scanning |
| Prevent further recursion | When this activates, it will not unlock further entries |
| Delay until recursion | Only activates on recursive passes, not the first chat scan |
| Internal notes | Optional notes (stored as the entry name field; not ST memo). Not included in standalone lorebook JSON, so they are lost on re-import. In card exports they fill the title if the entry has no title. |
SillyTavern positions such as Author's Note top/bottom and outlet show here as Before or After Character. They are kept on export unless you change Position.
Sticky, cooldown, delay, group, triggers, character filter, automation ID, outlet name, and per-entry scan depth survive standalone JSON round-trips, but you can't edit them here.
At-a-glance counts: Triggers N · Triggered by M (or “No recursion links”), plus Map.
Recursion map
A full-screen map of how your entries unlock each other. If entry A's content mentions one of entry B's primary keys, there's a path from A to B: when A activates, B can activate right after it (as long as flags allow it).
Open the map
- Entry → Options → Map
- Book settings → Map
Both open the same whole-book map, with the currently selected entry already inspected.
The web view
By default you get a picture of the whole book. Each box is an entry, each arrow is a path: the entry an arrow starts from mentions the other entry's keys in its content. Entries group into clusters so you can see which ones belong to the same chain. Little dots on a box show its flags (see the legend at the bottom).
| Action | How |
|---|---|
| Move around | Drag the background |
| Zoom | Scroll wheel, centered on your cursor |
| Inspect an entry | Click it; click the same box again to clear |
| Select for bulk edits | Ctrl (or Cmd) + click; click again to deselect |
| Reset camera | Reset view |
| Show entries with no links | Show standalone |
Hover an entry to light up just its connections and fade everything else. A legend at the bottom of the map explains the arrows and flag dots.
The list view
Switch to List next to the Web button for a plain table of every entry, with search and All / Linked / Standalone filters. Same actions: click a row to inspect (again to clear), use the checkbox to select. Books with more than 150 entries or more than 400 links open in list mode first, since a wall of boxes is slower to read and slower to draw. On a phone the map is always a list, with no Web toggle.
Inspecting an entry
The right-hand panel shows the clicked entry: its keys, flags, who can unlock it, and what it unlocks. From here you can:
- Edit primary keys as chips under Keys. Click a chip to rename it, X to remove it, or type in the field to add one (Enter or comma). These write to the actual entry and update the map immediately. They are the real trigger keys, not map-only labels.
- On Unlocked by / Unlocks rows, the matched keywords are chips too. Unlocked by edits this entry’s keys (
Mentions these keys in its content). Unlocks edits the other entry’s keys (These keys match in this content). Removing a matched chip on an Unlocks row drops that hop. - Toggle Non-recursable, Prevent further recursion, or Delay until recursion for just this entry. These apply right away.
- Select it to add it to a bulk selection.
Escape while renaming a chip cancels the rename and leaves the map open. Pan and zoom stay put when arrows appear or vanish; use Reset view to recenter.
Clicking another entry in its "Unlocked by" or "Unlocks" lists inspects that one instead, so you can walk a chain step by step. Click the inspected box again, or the inspector X, to close the panel and drop the path highlight.
Bulk flag changes
Selecting one or more entries opens a bar at the bottom. Pick On or Off for any of the three recursion flags, or use Isolate: block both directions (non-recursable plus prevent further). Nothing is applied yet. The bar shows exactly what is staged and for how many entries. Press Apply to commit, or Discard to back out. For big selections (more than 25 entries), Apply asks for a second click so a stray tap cannot rewrite half the book.
Quick-select shortcuts in the bar: All entries, Visible (what search is showing), Linked (entries with at least one path), and Clear.
Small print
Authoring aid, not a full ST simulator
The map reads primary keys in content (including simple /regex/ support, case sensitivity, and whole-word options). Key chips on the map edit those same primary keys. It does not fully simulate selective secondary logic, probability, token budget, multi-step depth, or chat scan. Treat it as a guide for wiring keys and recursion flags.
If Recursive scanning is off on the book, the map still shows potential key hits and warns that SillyTavern will not recurse until scanning is enabled (book or global ST setting).
For a walkthrough with examples, see the Recursion Map Guide.
AI key generation
The sparkle control next to primary keys asks the AI for 2–5 comma-separated trigger keywords from Content, then merges them with existing keys.
- Requires a configured AI provider (AI Setup)
- Uses the Custom / instruct prompt model mapping when set; otherwise the global model
- Click again to abort; requests time out after about 15 seconds
Content editor
Entry Content uses the shared CodeMirror stack: AI toolbar, spellcheck, macros, Markdown image highlighting, font size. See Editor & AI Toolkit.
Import & export
Works for both the lorebook on a character and a library book.
Export
- Open the lorebook editor (character tab or vault book).
- Click Export.
- Save the JSON (SillyTavern-oriented world info).
Import
The editor has no import button. To bring in a lorebook JSON, import it on the vault Lorebooks tab (Lorebook Vault). Then Attach it to the character and accept the copy prompt.
Accepted files:
- SillyTavern World Info JSON
- A bare V2
character_bookobject (anentriesarray)
Full character cards, or wrappers with a top-level character_book key, are not accepted. Books with zero entries fail to import.
Linking a library book (characters)
On a character, Attach in the entry header (or next to book settings on a phone) opens the link panel: Open in vault, Attach / Replace, copy, and Detach. The button label is Attach, the linked book’s name, or Missing.
For how linking, syncing, and card export work, see Lorebook Vault → Linking.