Start Battle
start_battleStart a D&D battle session from finalized character builds and SRD stat blocks. Provide initiative scores for every combatant, admit retained companions, and begin turn-order combat.
Instructions
Start a battle session from finalized Character Builds and selected SRD Stat Blocks. When list_stat_blocks exposes alternative Sizes, provide one authored size on that Stat Block combatant. The caller must provide Initiative scores for every combatant; choose initialSetup to keep the SDK-owned Initiative setup open for the battle_lifecycle surface.
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": {
"battleId": "<battleId>",
"initiativeMode": "<initiativeMode>",
"initialCombatants": "<initialCombatants>",
"companionAdmissions": "<companionAdmissions>",
"playSessionId": "<playSessionId>"
},
"name": "start_battle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| battleId | Yes | Caller-chosen durable battle id. | |
| playSessionId | Yes | Play Session handle returned by create_play_session for follow-up stateful calls in the same local process or authenticated account. | |
| initiativeMode | Yes | Use direct for an already supplied Initiative score or initialSetup to retain the SDK-owned setup for supported swaps and finalization. This field is required. | |
| initialCombatants | Yes | Non-empty initial combatant roster. Each combatant comes from a finalized character session or an ordinary SRD Stat Block. | |
| companionAdmissions | Yes | Explicit retained-companion admissions. Use an empty array when no retained companion enters the battle. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||