Skip to content

chooseBoardTargets

Sent when a spell or ability needs targets chosen from the board — players, permanents, or spells on the stack. For example, picking the creature or player Lightning Bolt will deal 3 damage to.

input.type is "chooseBoardTargets". The remaining fields:

interface ChooseBoardTargetsInput {
candidates: Array<TargetRef>;
hostile: boolean;
intent: TargetingIntent;
minTargets: number;
maxTargets: number;
chosenTargets: number;
label: string;
}

References: TargetRef , TargetingIntent

Each candidates entry is a TargetRef:

FieldTypeDescription
kind"player" | "card" | "spell"What kind of object the target is.
idstringId of the player/card/spell.
type ChooseBoardTargetsOutput = { type: "boardTargets"; chosen: TargetRef[] };

Return the chosen TargetRefs — between minTargets and maxTargets of them, drawn from candidates.

{
"promptId": 5,
"decidingPlayerId": "player-0",
"sourceCardId": "hand-2",
"input": {
"type": "chooseBoardTargets",
"candidates": [
{ "kind": "player", "id": "player-1" },
{ "kind": "card", "id": "bf-7" }
],
"hostile": true,
"intent": "damage",
"minTargets": 1,
"maxTargets": 1,
"chosenTargets": 0,
"label": "Damage"
}
}
{
"promptId": 5,
"output": {
"type": "boardTargets",
"chosen": [{ "kind": "card", "id": "bf-7" }]
}
}