Lorebook Workshop

Part of Aster at Dreamjourney AI
Lorebook Merger
Combine two lorebooks into one file. The first lorebook keeps its name and settings — the second lorebook's entries are added to the end of it.
How to use
  1. Export your lorebook from DreamJourney. Open the lorebook, click the menu (usually ⋮ or a settings icon), and choose Export. This downloads a .json file. Open that file in Notepad (or any text editor), select all the text, and copy it.
  2. Paste the first lorebook into the Primary box. This lorebook's name and settings will be used for the final result.
  3. Paste the second lorebook into the Secondary box. Its entries will be added to the end of the first lorebook.
  4. Click Merge lorebooks.
  5. Click Copy output, then go to DreamJourney, create a new lorebook, and use the Import option to paste it in.
  6. Important: check the merged lorebook for entries with the same name — this tool does not remove duplicates automatically.
Primary lorebook (preserved)
Secondary lorebook (appended)
Merged output
Wrap All Triggers (Cascade Destroyer)
Fixes cascade across your whole lorebook at once. Cascade is when one lorebook entry accidentally pulls in another entry because it mentions that entry's trigger word — even when you don't want it to. This tool hides those trigger words inside entry descriptions so the AI can still read them, but the lorebook stops treating them as triggers.
How to use
  1. Export your lorebook from DreamJourney. Open the lorebook, click the menu (⋮ or settings icon), and choose Export. Open the downloaded .json file in Notepad, select all, and copy it.
  2. Paste the lorebook text into the box below.
  3. (Optional) If you have any entries that should pull in other entries on purpose (like a hub entry that's meant to cascade), type those entry names in the Exempt box — one name per line. Spelling must match exactly (upper or lower case is fine).
  4. Click Wrap all triggers. Every trigger word found inside entry descriptions gets wrapped with underscores — like _word_, or _two_words_ for multi-word triggers.
  5. Click Copy output, then import the result into DreamJourney as your updated lorebook.
  6. To check it worked: open any entry on DreamJourney and look at its References list — it should be empty (except for your exempt entries).
Lorebook JSON
Exempt entry names (one per line)
Names must match exactly (case-insensitive). Exempt entries keep their references.
Output JSON
Wrap a Snippet (Cascade Buster)
Use this to fix cascade in just one entry, without touching the rest of your lorebook. You paste in the text from a single entry's description, and this tool wraps any trigger words it finds in that text.
How to use
  1. Export your lorebook from DreamJourney. Open the lorebook, click the menu (⋮ or settings icon), choose Export, open the downloaded .json file in Notepad, select all, and copy it.
  2. Paste the lorebook text into the first box, then click Extract triggers. This reads your lorebook and builds a list of all the trigger words. Check the list in the audit box — it should show every trigger from every entry.
  3. Go back to DreamJourney and open the specific entry you want to fix. Copy all the text from its Description field.
  4. Paste that description text into the Text to process box.
  5. Click Wrap triggers. Any trigger words found in that text will be wrapped — like _word_, or _two_words_ for multi-word triggers.
  6. Click Copy output, then go back to that entry on DreamJourney and paste the result into its Description field, replacing what was there.
Lorebook JSON
Extracted triggers (audit)
Text to process
Output
Remove Wrapping (Recascadanator)
The undo button for wrapping. If you've already used Wrap All Triggers or Wrap a Snippet and want to start over, use this to strip all the underscore wrapping out and restore your descriptions back to normal.
How to use
  1. Export your wrapped lorebook from DreamJourney. Open the lorebook, click the menu (⋮ or settings icon), choose Export, open the .json file in Notepad, select all, and copy it.
  2. Paste it into the box below.
  3. Click Remove wrapping. The tool removes all underscore wrapping from every entry's description. Underscores between words (like _this_phrase_) become normal spaces. Any leftover standalone underscores are removed.
  4. Only the description text is changed. Your trigger words, entry weights, pinned and hidden settings, and everything else stay exactly as they were.
  5. Click Copy output, then import it back into DreamJourney.
Wrapped lorebook JSON
Output JSON
Format Checker
Use this if your lorebook is failing to import into DreamJourney, or if you built or edited one by hand and want to check it before trying. It looks for small mistakes — missing fields, an entry with no trigger words, a stray comma — that can silently break an import without any useful error message.
How to use
  1. Paste your lorebook JSON into the box below. (If you're not sure how to get the JSON: open the lorebook in DreamJourney, click the menu — ⋮ or settings icon — and choose Export. Open the downloaded file in Notepad, select all, and copy.)
  2. Click Check format.
  3. Green result = your lorebook looks valid and should import correctly.
  4. Red result = something is wrong. Each problem is listed with the entry name so you know exactly where to look. Fix those issues, then click Check format again. Repeat until it passes.
What a valid lorebook needs
  1. The lorebook as a whole needs: a name, a thumbnail field, a public/private setting, and a list of entries.
  2. Each entry needs: a name, a description, a type, a weight, a pinned setting, a hidden setting, and at least one trigger word (called a key).
  3. Every entry must have at least one trigger. An entry with no trigger words will always fail — DreamJourney has no way to know when to use it.
Lorebook JSON
Result
Results will appear here.
Frequently Asked Questions
New to lorebooks or just not sure where to start? This page covers the basics.
Where is the Export button? I can't find it.
Open your lorebook in DreamJourney. In the top-right area of the lorebook editor, you'll see an Export button and an Import button — they're right next to each other. Export downloads your lorebook as a .json file. Import lets you upload one.
Screenshot showing the Export and Import buttons in the DreamJourney lorebook editor
The Export and Import buttons in DreamJourney's lorebook editor.
What is a lorebook JSON? What am I even pasting?
A .json file is just a text file that stores your lorebook's data in a structured format — all the entry names, descriptions, trigger words, weights, and settings in one place. When you click Export in DreamJourney, it downloads this file. To use it here, open the file in Notepad (or any text editor), press Ctrl + A to select all, then Ctrl + C to copy. Then paste it into whichever box this tool asks for.
What is cascade, and why is it a problem?
Cascade happens when one lorebook entry accidentally pulls in another entry during a chat — because its description text contains a trigger word from a different entry. For example, if you have an entry for "Hideo" and another entry whose description mentions the word "Hideo", that second entry might trigger the first one every single time it's active. This can flood the AI's context with entries you didn't intend to activate, causing odd or repetitive responses. The Wrap tools fix this by disguising trigger words inside descriptions so the lorebook system ignores them — but the AI can still read and understand them.

For a deeper explanation of how lorebooks work (including cascade, entry weights, pinned entries and more), see Sunny's full Lorebook Guide ↗.
Which tool should I use?
Merge — You have two lorebooks and want to combine them into one file.

Wrap All Triggers — Your lorebook has cascade problems and you want to fix the whole thing at once. Best starting point for most people.

Wrap a Snippet — You only want to fix one specific entry, not the whole lorebook.

Remove Wrapping — You've already wrapped a lorebook and want to undo it and start over.

Format Checker — Your lorebook isn't importing and you're not sure why, or you built one by hand and want to check it before trying.
I pasted my JSON but the tool says it's invalid. What's wrong?
A few things to check:

1. Make sure you copied the entire contents of the file — open the .json file in Notepad, press Ctrl + A then Ctrl + C, and paste it fresh.

2. Check that the file actually exported properly — try exporting again from DreamJourney if you're not sure.

3. If you've manually edited the JSON file, a single stray comma or missing bracket can break the whole thing. Use the Format Checker tab to find out exactly what's wrong.

On mobile? Some phones (like Google Pixel) have limited clipboard space and can't copy large JSON files properly — the text gets cut off partway through. If this is happening to you, download the .json file from DreamJourney instead, then use the 📂 Upload .json file button on any tool tab to load it directly. No copying needed.
Will this tool change anything in my actual DreamJourney lorebook?
No. This tool runs entirely in your browser — nothing is sent anywhere and nothing in DreamJourney is touched. You paste your lorebook in, the tool gives you a modified version as output, and then you choose what to do with it. Your original lorebook stays untouched until you manually import the new version yourself.
How do I import the output back into DreamJourney?
Click Copy output in the tool. Then in DreamJourney, open your lorebook (or create a new one), click the Import button (see the screenshot at the top of this page), and paste the copied text in. DreamJourney will load it as a lorebook you can save and use.