Reference

Troubleshooting and Reference

Resolve common workflow problems and review keyboard, editor, and campaign terminology.

GM + Player

About 10 minutes

Keyboard and editor shortcuts

Press Ctrl/Cmd + K or / outside an editor to open campaign search.
Press N in the GM workspace to start or resume a new entity draft.
Type @ in rich notes to search for and mention an entity.
Type #today followed by punctuation or a space in a calendar-enabled rich editor to insert the current world date.
Press Escape while editing an inline field to discard that unsaved inline change.

A field did not save or shows stale content

Wait for the field save indicator to finish before navigating away.
If a stale banner appears, compare the current value with the newer saved value.
Refresh only after preserving any text that is still unsaved.
During read-only maintenance, keep local draft text but expect writes to remain unavailable until maintenance ends.

A player cannot find shared content

Confirm the player membership is active and assigned to the expected group.
Confirm the entity has an audience: all players, the player group, or the individual player.
Confirm at least one content area such as summary, notes, portrait, metadata, or a custom field is shared.
Use View as Player and check both the entity list and search.

An OBS source is blank or stale

Confirm OBS integration is enabled for the campaign.
Copy the browser-source URL again after rotating a key.
Confirm the selected layout contains widgets and preview it inside Tapestry.
For initiative, confirm an encounter is active and exposed.
For maps, confirm a map is currently cast and the intended pins are marked stream-safe.
Refresh the OBS browser source after changing its URL or key.

Glossary

Access key: The secret value embedded in an OBS browser-source URL. Rotate it if the complete URL is exposed.
Archive: Removes an entity from active lists while preserving its history and relationships so it can be restored later.
Autosave: Automatically saves supported edits after a short delay. Wait for the save indicator before leaving the page.
Beat: A smaller moment, reveal, choice, or change planned inside a session scene.
Browser source: A URL loaded by OBS to render a Tapestry overlay, layout, map cast, or animated background.
Calendar preset: A managed calendar definition with established months, weekdays, leap rules, moons, and optional holidays. Switch it to Custom before editing its structure.
Campaign: The top-level workspace containing a game's entities, sessions, players, settings, maps, calendar, and integrations.
Campaign collaborator: An owner, GM, or viewer who uses the GM-side campaign workspace. Collaborators are separate from players.
Combatant: A participant copied or created inside an encounter for initiative, hit points, conditions, and combat tracking.
Communal content: Player-created journal or entity content shared with the player group in which it was created and visible to the GM.
Content controls: Sharing choices that determine which parts of an entity an audience receives, such as summary, notes, portrait, metadata, or custom fields.
Current date: The campaign's shared in-world today, used by calendar controls, date pickers, and the #today editor shortcut.
Custom field: A campaign-defined structured value added to an entity type, with a stable key, label, and data type.
Draft: Unfinished local input retained by supported creation or editing workflows until it is saved or discarded.
Encounter: A campaign entity that stores a prepared set of combatants and the state used by the combat tracker.
Entity: A durable campaign record such as a character, location, session, quest, rumor, encounter, or custom type.
Entity type: The schema and navigation category for a kind of entity, including its built-in and custom fields.
Field history: Saved earlier values for an individual entity field, available for review and, when permitted, restoration.
Game system: The campaign setting that selects which built-in SRD rules, monsters, spells or powers, items, shops, DCs, and travel references Tapestry uses.
GM: A campaign collaborator who can build and run campaign content but may not control owner-only settings.
Journal: A player-authored campaign note stored in either the private journal or the group communal journal.
Layout: A 1920 by 1080 arrangement of themed widgets rendered through a layout-specific OBS browser source.
Map cast: The map currently sent to the campaign's OBS map browser source, including only stream-safe pins.
Map pin: A positioned marker on a GM-side campaign map, usually linked to a location entity. Its stream-safe setting controls OBS map-overlay exposure.
Mention: An @ reference written in rich notes that links the prose to another campaign entity.
Note template: The default rich-note structure offered when a new entity of a configured type is created.
NPC generation dataset: An enabled collection of names, traits, appearances, motivations, or notes used to create editable NPC drafts.
Owner: The campaign collaborator with authority over members, integrations, data operations, deletion, and other owner-only settings.
Player: A campaign participant who uses the separate player workspace and sees only shared or player-owned content.
Player group: The party boundary used for group sharing and communal player content. Communal content remains with its original group.
Player workspace: The player-facing campaign area containing shared lore, journals, communal content, search, and any enabled calendar or creation tools.
Player-created entity: An entity authored in the player workspace with Private or Communal visibility, using a type enabled by the GM.
Private content: Player-owned journal or entity content visible only to its author unless the player enables the applicable GM review setting.
Relation type: The campaign-defined label, inverse label, and optional source or target restrictions used by relationships.
Relationship: A labeled, optionally contextual connection between two entities.
Rich note: Freeform formatted entity content that can include headings, lists, links, entity mentions, and world-date references.
Scene: An ordered unit of session preparation containing planned situations and beats; scenes can move between sessions.
Session: A campaign record for one planned or completed play period, including prep, scenes, references, run notes, and recap.
Sharing audience: The players allowed to receive an entity: all players, selected groups, selected individuals, or a combination.
Spotlight entity: A campaign entity pinned for quick reference in session preparation and run workspaces.
Story arc: A campaign entity that groups related sessions and tracks a larger developing thread.
Stream-safe pin: A map pin explicitly approved to appear on the public OBS map source while that map is cast.
Summary: The concise at-a-glance description shown in lists and previews, and shared independently from notes and other entity content.
System Reference Document (SRD): A licensed collection of game rules and reference content. An SRD is not necessarily the complete content of the commercial books for that edition.
Timeline: A long-range chronological view of dated campaign entities and notes, with search, type filters, and zoom controls.
View as Player: A GM-only, read-only preview of one selected player's effective access across the player workspace.
Viewer: A campaign collaborator who can inspect the GM workspace without changing campaign content.
War Table: The interactive graph that visualizes entities as nodes and their explicit relationships as connections.
Widget: A configurable element inside an OBS layout, such as initiative, party roster, rotating character information, or campaign date.