Skip to content

AddJournalEntry

Referee: append an authored beat to the session journal.

Full documentation: AddJournalEntry. Wire type: add_journal_entry.

Legal session modes: battle, encounter, exploring, game_over, town, victory

JSON Schema

{
  "description": "Referee: append an authored beat to the session journal.\n\nThe journal is the party's record of the adventure in order of discovery:\nentries append, are never rewritten, and are never derived from other state, so\na beat outlives whatever produced it. Each entry is stamped with the clock\nposition it landed at, and\n[`PlayerView.journal`][osrlib.crawl.views.PlayerView] ships the entries as they\nwere written. Referee commands are legal in every mode, terminal modes included\n\u2014 a closing beat lands after the adventure has concluded.\n\nModes:\n    `town`, `exploring`, `encounter`, `battle`, `game_over`, `victory`\n\nRejections:\n    None.\n\nEvents:\n    [`JournalEntryAddedEvent`][osrlib.crawl.events.JournalEntryAddedEvent] with\n    the text and the clock position.",
  "properties": {
    "command_type": {
      "const": "add_journal_entry",
      "default": "add_journal_entry",
      "title": "Command Type",
      "type": "string"
    },
    "source": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source"
    },
    "text": {
      "minLength": 1,
      "title": "Text",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "title": "AddJournalEntry",
  "type": "object"
}