Roll dice
roll-diceRoll dice formulas in Foundry VTT and get total plus individual die results. Optionally post to chat with flavor text, using actor data for @ references.
Instructions
Roll a free formula in Foundry, in any game system, e.g. "2d6+3" or "4d6kh3". Returns the total and every single die result. With actorId, @ references use that actor's roll data. Nothing is posted unless toChat is true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"formula": "<formula>"
},
"name": "roll-dice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flavor | No | Text shown with a posted roll | |
| toChat | No | Post the roll to the chat. Default false: nothing is posted | |
| actorId | No | Actor id or exact name whose roll data fills @ references | |
| formula | Yes | Foundry roll formula | |
| rollMode | No | Who sees a posted roll: publicroll everyone, gmroll Gamemasters (default), blindroll Gamemasters only and hidden from the roller, selfroll only the bridge user |