Skip to main content

World editor

The same editor appears from the Worlds page, inside a roleplay session, and in an authoring chat. The source determines what changes mean:

  • editing a world changes future sessions;
  • editing a session changes only that story;
  • an authoring chat writes the world files on disk.

Sections​

An authored world also has parts that belong to the world as a whole and are not in a session's editor:

  • About: name, tags, description, the rules of the world (one short rule per line), the opening message (plain text; an opening with lines spoken by characters is shown read-only), other openings (a title and a narration each; the player picks one when starting a session), author and link, a version label (recorded in the sessions started from the world), and the time zone and starting time of the story clock. Saving changes only the fields that changed and keeps the rest of world.json.
  • Daily life: each character's routine: windows of the day with an activity, optional days of the week, place, spot and position, and whether the character would drop it for something that comes up. Times are HH:MM; a window that ends before it starts runs past midnight. Windows are checked as the world is read at a start, so a wrong time, day, place or spot is refused with the reason and nothing is written.
  • Tracked values: the variables the world declares (variables.json): a number, flag or choice about characters, things, places or the world, with limits, a starting value, how it is told in words (bands) and who can tell. A variable that a character, thing, place or the world still gives a value to cannot be removed, and a limit that an existing value breaks is refused.
  • Prompts: every prompt the models are given, in a chosen language, marked Style (persona and prose) or Rules (the game and its tools). A prompt the world carries replaces the shipped one in sessions started afterwards; Use the shipped one moves the world's own version to .trash. The same checks as the authoring assistant apply: the placeholders of the original must stay.
  • Images: the world's image library, like a session's gallery. Pictures added here, or fetched when a card is imported, are copied into every session started from the world. A picture a session has not described yet can be described by hand.

The parts of the cast and the story are:

  • Characters: identity, role, personality, speech, initial state, emotion, intents, routines, voice and visual identity.
  • Places: descriptions, containment, features and exits.
  • Things: descriptions, quantity, condition, ownership, placement and equipment properties.
  • Factions: values, structure, members, goals and faction relationships.
  • Relations: directional character relationships and explicit entity knowledge.
  • Lore: canonical entries, subjects, related entries and sources. In an authored world entries can be added by title and removed (moved to .trash); an entry that other lore or a plot still names cannot be removed until those references are gone.
  • Plots: plot definitions and, in a session, current progress.
  • Variables and triggers: authored deterministic state and reactions.

Each panel validates before saving. Keep IDs stable after other records refer to them. Names may change without breaking links; IDs are the links.

External file edits are not watched continuously. Refresh the world catalogue or editor after changing files outside DSH.