Characters & Worlds¶
Characters and worlds are your reusable creative building blocks. Create them once in your library and use them across any number of stories.
Characters¶
Creating a character¶
Open Library → Characters and click + New Character. The editor has two tabs: Card (core details) and Lorebook (keyword-triggered context snippets).
Key fields:
| Field | What it does |
|---|---|
| Name | Display name, used everywhere |
| Description | Appearance, background, key traits — the main block the AI sees |
| Personality | How they think, act, and speak |
| First Message | A voice example — one of the most powerful fields for consistent characterization |
| Dialogue Examples | Additional speech samples showing range |
Other fields: Scenario, System Prompt, Creator Notes (private — not sent to AI), Tags.
Tip: The more detail you provide, the better the AI writes your character. A few extra sentences in Description and Personality make a noticeable difference.
Avatars¶
Upload an image, crop it, and it appears throughout the app. Click any avatar to view full-size.
Importing characters¶
Storywright supports Character Card V2/V3 files (compatible with SillyTavern, Agnai, and other tools):
- PNG files — character data embedded in the image; the image becomes the avatar
- JSON files — standard character card format
Drag and drop onto the library, or use the Import button.
Assigning to stories¶
In a story's left panel, click + Add Character and pick from your library. Assign a role (protagonist, antagonist, supporting, mentor, love interest) and optionally toggle Narrator.
Quality inspection¶
Click the 🛡 shield icon to check for missing fields, empty descriptions, duplicate keywords, and other issues. Each finding links to the field that needs attention.
Exporting¶
Export as PNG (with embedded card data) or JSON for use in other tools.
Worlds¶
A world is a named container for lorebook entries — locations, factions, history, magic systems, and anything else that defines your fictional universe.
Creating a world¶
- When creating a story, you can create a new world or pick an existing one
- Or go to Library → Lorebooks and click + New → New World
Using worlds in stories¶
Each story links to one world. All that world's lorebook entries become available during generation. Change the world anytime in the story's setup panel.
Sharing across stories¶
Multiple stories can share the same world. Writing a series in the same universe? Link them all to one world — edit an entry once and every story picks up the change.
Lorebooks¶
Lorebooks are keyword-triggered reference entries. When a trigger word appears in the current scene's context, the matching entry is automatically included in the AI's prompt. The AI reads only the pages it needs.
Three sources¶
| Badge | Source | Best for |
|---|---|---|
| 🌍 World (blue) | Attached to a world | Locations, factions, history, magic systems |
| 📖 Story (green) | Attached to a story | Plot-specific devices, one-off settings |
| 👤 Character (orange) | Attached to a character card | Backstory, relationships, abilities |
All three merge at generation time. The AI doesn't know which source an entry came from — it just sees the relevant lore.
Creating entries¶
Each entry has:
- Keys — comma-separated trigger words
- Content — the information injected into the prompt
- Comment — a display label (not sent to the AI)
How matching works¶
Keys are checked against character names, the scene outline, summaries, and previous scene text. If any key matches, the entry is included.
Managing lorebooks¶
Open Library → Lorebooks to see all entries across all sources in one list, tagged with source badges. Use the story filter dropdown to focus on a specific story's entries. You can copy entries between scopes (World → Story → Character).
Quality tools¶
- 🛡 Quality inspection — finds duplicate keywords, empty entries, and formatting issues
- Conflict detection — scans for contradictions between entries
- World enrichment — suggests new entries based on facts that emerge during your story
Importing¶
Click + New → Import from File to import lorebook JSON files (compatible with SillyTavern and other tools). Character card imports also bring their attached lorebook entries.
Tips¶
- Use keywords wisely. Character names and unique terms work best. Avoid common words — they'll trigger on every scene.
- One concept per entry. A single location, relationship, or rule. Keeps matching precise.
- Put shared lore in the world, personal details in the character, plot-specific details in the story.
- Run quality inspection on new characters before generating scenes.