Realms of Shod logo

Realms of Shod

Overview

  • Getting Started

    • Quickstart
    • Storytelling
    • Using the H.U.B.
    • Sculpting Realms
    • Collaborating
    • Coins

  • Understanding the Interface

    • Navigation
    • Media Controls
    • Story Tools

  • Realms Sandbox

    • Play Modes
    • Gamestream
    • Transcripts
    • Compendium

  • World Building

    • Import / Export
    • Entities
    • Notes

  • Integrations

    • Discord
    • MCP

  • API Reference

    • Authentication
    • Realms API
    • Entity Graph API
    • Notes API
    • Sessions API

  • Support

    • FAQs
    • Contact & Feedback
    • Privacy
Notes

World Building

Notes

Notes are freeform documents that live in your realm's Compendium. Use them for GM prep, lore dumps, session recaps, or anything your world needs to remember, and share them with players when the moment is right.

Notes are standalone documents scoped to a realm. They sit alongside entities in the Compendium but operate independently: they have their own names, content, and access lists. Every note is private to the realm creator by default; members only see notes that have been explicitly shared with them.

This makes notes a flexible tool for keeping Gamelord information separate from player-facing lore until the right moment arrives.

Open the Compendium and switch to the Notes tab to see all notes you have access to. Press Cmd+K (or Ctrl+K on Windows) to open the command palette and search for a note anywhere in a realm.

Create a note from the main compendium page, the storytools button in the sidebar, or the command palette.

Name

The title shown in the notes list. Required.

Access

Which realm members can view this note. Defaults to creator-only. Members granted viewer access can read but not edit.

Notes are written in Markdown. The editor auto-saves a few seconds after you stop typing, so there is no manual save button. A status indicator in the editor shows whether your latest changes have synced.

Entity links

Type [[ followed by an entity name to insert a linked entity chip. The editor autocompletes from your realm's Compendium. Clicking a chip opens the entity panel.

Auto-sync

Changes are saved automatically. The editor shows "Syncing...", "Changes synced", or "Unsynced changes" depending on the current state.

Notes start private. The realm creator can share a note two ways:

Per-member access

Grant viewer access to specific realm members from the note's access panel. Useful for notes that are relevant to only part of the party.

Reveal to all

Share the note with every active realm member in one action. Members added to the realm after the reveal do not automatically receive access.

Viewers can read a note but cannot edit its content or access list. Only the realm creator can modify, reveal, or delete a note.

Every entity also has a private notes field visible only to the realm creator. Entity notes are not shareable: they are a scratchpad for the Gamelord, never visible to players regardless of access settings.

Compendium notes are the shareable counterpart: standalone documents with their own titles, content, and access lists. Use entity notes for private reminders tied to a specific entity; use Compendium notes for anything meant to eventually reach the players or that spans more than one entity.

Notes are included in Compendium exports using the V3 format. Each note is exported with its name, full text, and access list. Imported notes follow the same access rules: the importing user becomes the creator.

See Import / Export for the full schema reference.

Notes are fully accessible via the REST API and the MCP server.

  • Notes API — list, get, create, update, and delete notes with Bearer token authentication.

  • MCP tools — list_notes, get_note, create_note, edit_note, and delete_note are available to any connected AI assistant.

← Previous: EntitiesNext Import / Export →