Realms Sandbox
Compendium
The Compendium is your realm's world database. Every entity, relationship, and piece of recorded lore lives here, growing with each session.
The Compendium displays all entities you have access to in the realm. Entities are shown in a grid and can be filtered by type using the type selector, narrowing the view to characters, locations, organizations, items, events, establishments, or miscellaneous records.
Press Cmd+F (or Ctrl+F on Windows) to open the search popup and find entities by name. The search popup also surfaces a quick option to create a new entity if no match is found.
New entities can be created at any time from the Compendium header. The creation form opens in a side panel and requires a name and type. Description, notes, and access settings are optional.
Name
The canonical name of the entity as it will appear in the Compendium and inline links.
Type
One of the 58 entity types across seven categories. The type determines how the entity is classified and filtered.
Description
A summary of the entity. Can be written manually or generated during extraction. Visible to any realm member with access to the entity.
Notes
A personal scratchpad: private notes visible only to you. Every realm member gets their own on each entity, and none are shared with players under any access setting.
Access
Which realm members can see this entity. Defaults to just you, the entity's creator. Can be expanded to specific players or the whole realm.
Create More
Enabling this keeps the creation form open after saving so multiple entities can be created in succession.
Open an entity to view its full record. Anyone with the Collaborator role or above will see an edit button that opens the same form used during creation. Any field can be updated: name, type, description, notes, or access.
Changes to the name, type, description, aliases, and image, whether you made them or a gardener did, are recorded on the entity's History tab. If a description changes for the worse, you can restore an earlier version from there.
Entities can be deleted individually from the entity panel, or in bulk by selecting multiple entities and using the bulk action menu. Deleting an entity is permanent and removes its variants, its relationships, and its History.
Relationships connect two entities with a typed edge. They are displayed in the right panel of the entity view, grouped by category. Clicking a connected entity navigates directly to its record.
New relationships can be added from the entity panel by any Collaborator or above. Select a target entity, choose a relationship type, and set access. Relationships created automatically during sessions also appear here and can be edited or removed.
Adding, changing, or removing a relationship is recorded in the History of both entities it connects. Removing a relationship is not final: it can be restored from History with the same access it had before.
The background helpers that grow the compendium during play are called gardeners, and each can be turned on or off per realm.
For a full reference of available relationship types, see the Entities documentation.
Each entity and each relationship is independently access-controlled, per item rather than by role. Even the realm's creator only sees what they've been granted access to, though session-extracted content and manual reveals mean they typically see most of it. Anyone without access sees nothing until it's explicitly revealed to them.
Public to Realm
Makes the entity visible to every current and future realm member, including anyone who joins later. Set it in the entity form, or use Reveal Entity to Realm from the entity panel menu.
Reveal all relationships
Makes every relationship on the entity Public to Realm. Useful after revealing a key character to fully expose their connections.
Per-player access
Individual entities and relationships can be shown to specific players without revealing them to the whole realm.
Reveal notifications
When a session mentions a hidden entity, participants in that session who can see it and have reveal permission get a notification with a quick action to reveal it to the people in that session. If no participant can, the realm's creator gets it instead.
On a public realm, Public to Realm items can also be seen by signed-in guests and your audience. See Public Compendium before publishing.
When the same entity exists under multiple records, they can be merged into one. Select the entities to merge, designate which one survives, and choose whether to consolidate notes, relationships, and access.
All variants and transcript references are updated automatically. For a full explanation of how merging works, see the Entities documentation.
The Compendium also tracks Quests: the party's hooks, goals, and rewards, each with its own step-by-step timeline. A quest's status follows its timeline automatically rather than being set by hand, and quests can be shared the same way as entities, either Public to Realm or with specific members.
For a full explanation of how quests work, see the Quests documentation.
The Compendium also contains a Notes section: freeform documents for Gamelord prep, lore, session recaps, or any knowledge your world needs to store. Notes are private to whoever created them by default and can be shared selectively with specific members or revealed to the whole realm at once.
For a full explanation of how notes work, see the Notes documentation.
Export
Download your compendium as a JSON file. Exports include entity names, types, descriptions, and optionally their relationships, notes, quests, and access lists. The file can be used as a backup or imported into another realm.
Import
Upload a previously exported JSON file to populate the compendium with entities and relationships. The platform auto-detects the format version and creates all records from the file.
For detailed format documentation and field reference, see Import / Export.
