Your entity library
Manage your campaign's NPCs, locations, factions, items, and plot threads in the Entity Library. See how SessionWeaver tracks your campaign world.
SessionWeaver tracks six types of entities across your campaign. Think of it as campaign memory — a living roster of every character, location, and plot thread your story has touched.
Entity types
| Type | What it tracks | Examples |
|---|---|---|
| NPC | Non-player characters | Quest givers, villains, shopkeepers, allies |
| PC | Player characters (synced from your party roster) | Your players' characters |
| Location | Places in your campaign world | Cities, dungeons, taverns, regions |
| Plot Thread | Ongoing storylines and quests | "The Missing Artifact", "War with the Orcs" |
| Faction | Organizations and groups | Guilds, kingdoms, cults, mercenary companies |
| Item | Named significant items | Artifacts, quest items, legendary weapons |
How entities get created
Entities enter your library in three ways:
- Automatic extraction — When you write a session recap in the generation wizard, the AI identifies entities in your text and adds them to the library. This is the most common path.
- Manual creation — Click the Add Entity button in the Entity Library to create any entity type by hand.
- NPC Generator — Open the NPC Generator dialog from the Entity Library to generate a full NPC with personality, appearance, motivation, speaking style, and a D&D 5e stat block.
The NPC Generator counts against your NPC generation quota (separate from session generation). Manual creation and automatic extraction are always free.
Lifecycle states
Entities are not static — they change as your campaign progresses. Each entity has a lifecycle status that affects whether it appears in future generated sessions:
| Status | Applies to | What it means |
|---|---|---|
| Active | All types | Currently alive, functional, and relevant |
| Killed | NPC, PC | Permanently slain |
| Destroyed | Location, Item, Faction | Physically destroyed |
| Departed | NPC, PC | Left the area or campaign |
| Disbanded | Faction | Organization dissolved |
| Resolved | Plot Thread | Quest completed, mystery solved |
When an entity's status changes to anything other than Active, the AI excludes it from future sessions. A killed NPC will not show up alive in your next generated session. A resolved plot thread will not be re-opened.
When your recap mentions that someone died or a quest was resolved, the Changes step in the generation wizard picks it up. You just confirm or reject.
The Entity Library page
Your campaign's Entity Library page centers on a force-directed relationship graph showing how entities connect to each other. Click any node to expand its details. Zoom, pan, and drag to explore. A minimap in the corner helps you navigate larger graphs. Filter by entity type to focus on what matters.
Entities are unlimited on all tiers, including Spinner (free). Your campaign's cast can grow as large as your story demands.
Entity relationships
Entities can have connections to each other — an NPC who belongs to a faction, a plot thread tied to a location, rivals who are enemies. The graph shows these as labels like "related to," "belongs to," or "part of" on the lines between nodes.
Relationships are extracted automatically from your recaps and displayed in the graph view. You can also add them manually when editing an entity.
Mini-generators
When editing an entity, you will see sparkle buttons next to certain fields. These are mini-generators — click one to regenerate just that field using the AI. Need a better name for an NPC? A more evocative description for a location? A sharper set of goals for a faction? One click.
Next steps
- The generation wizard — how entities flow into session generation
- Editing and regenerating — customize generated content and regenerate individual sections
- Quick start guide — set up your first campaign and party roster