RollDamageRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/foundplay-io/json-schema/foundplay-io-roll-damage-request-schema.json",
  "title": "RollDamageRequest",
  "description": "Weapon-bound damage roll. Module looks up the item's `attack` activity and rolls the damage formula — base dice + ability modifier + magic bonuses.\n\n**`critical: true` doubles the dice** (Foundry standard crit damage handling) and the response's `is_critical` flag is set to true regardless of any natural d20 in the dice. Use this when the preceding `roll-attack` came back as crit (or when you simply want to force a crit damage roll).\n\n**`is_fumble` is never set on damage rolls** — the concept doesn't apply.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/foundplay-io-openapi.json#/components/schemas/RollDamageRequest",
  "properties": {
    "actor_id": {
      "description": "Foundry actor id within the calling tenant's world.",
      "minLength": 1,
      "type": "string"
    },
    "critical": {
      "default": false,
      "description": "Force critical-hit damage (double dice). Sets `is_critical: true` on the response. Use after a successful crit attack roll.",
      "type": "boolean"
    },
    "item_id": {
      "description": "Item id (weapon or attack-spell) owned by the actor.",
      "minLength": 1,
      "type": "string"
    },
    "show_in_chat": {
      "default": false,
      "description": "Post the roll to the world's Foundry chat. Default false (silent).",
      "type": "boolean"
    }
  },
  "required": [
    "actor_id",
    "item_id"
  ],
  "type": "object"
}