Skip to content

DiceRolledEvent

An authorial dice roll resolved (referee — the referee's hidden adjudication rolls).

Full documentation: DiceRolledEvent. Wire type: dice_rolled.

Default visibility: referee

Message codes: adjudication.dice_rolled

JSON Schema

{
  "$defs": {
    "Visibility": {
      "description": "Who may see an event.\n\nThe wire values are `\"player\"` and `\"referee\"` \u2014 lowercase, serialized into every\nevent; changing them is a `schema_version` bump.",
      "enum": [
        "player",
        "referee"
      ],
      "title": "Visibility",
      "type": "string"
    }
  },
  "description": "An authorial dice roll resolved (referee \u2014 the referee's hidden adjudication rolls).\n\nEmitted by [`RollDice`][osrlib.crawl.commands.RollDice] when a referee resolves a\nfreeform *chance* outcome by rolling through the seeded session. Carries the\nexpression that was rolled, the `total`, and each individual die result in\n`rolls`.",
  "properties": {
    "code": {
      "default": "adjudication.dice_rolled",
      "title": "Code",
      "type": "string"
    },
    "visibility": {
      "$ref": "#/$defs/Visibility",
      "default": "referee"
    },
    "event_type": {
      "const": "dice_rolled",
      "default": "dice_rolled",
      "title": "Event Type",
      "type": "string"
    },
    "expression": {
      "title": "Expression",
      "type": "string"
    },
    "total": {
      "title": "Total",
      "type": "integer"
    },
    "rolls": {
      "items": {
        "type": "integer"
      },
      "title": "Rolls",
      "type": "array"
    }
  },
  "required": [
    "expression",
    "total",
    "rolls"
  ],
  "title": "DiceRolledEvent",
  "type": "object"
}