Skip to content
Ishvana Ishvana Docs

Opposed Roll V2

POST
/api/creative/mechanics/analysis/v2/opposed

Analyze an opposed roll comparing actual die sums.

Request Body required

Section titled “Request Body required ”
OpposedRollRequestV2

Request for sum-based opposed roll analysis.

object
attackerPool
required
Attackerpool
integer
>= 1 <= 50
defenderPool
required
Defenderpool
integer
>= 1 <= 50
attackerBonus
Attackerbonus
number
0
defenderBonus
Defenderbonus
number
0
outcomeMapping
required
DiceOutcomeMapping

Defines how individual die faces map to categorical outcomes.

For a d10 pool system: faces 1-10 map to bands like Critical Success, Advantage, Neutral, Consequence, Critical Failure — each with a weight that determines net outcome when advantages and consequences cancel.

object
dieFaces
required
Diefaces
integer
>= 2 <= 100
bands
required
Bands
Array<object>
>= 1 items
DiceOutcomeBand

A range of die face values with a categorical meaning and weight.

Example: on a d10, faces 8-9 are “Advantage” with weight +1.

object
name
required
Name
string
>= 1 characters <= 50 characters
minValue
required
Minvalue
integer
>= 1
maxValue
required
Maxvalue
integer
>= 1
weight
Weight
integer
0
color
Color
string
default: #6b7280

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

OpposedResultV2

Opposed roll comparing actual die sums (not abstract weights).

object
attackerPool
required
Attackerpool
integer
defenderPool
required
Defenderpool
integer
attackerBonus
required
Attackerbonus
number
defenderBonus
required
Defenderbonus
number
attackerWinProb
required
Attackerwinprob
number
defenderWinProb
required
Defenderwinprob
number
tieProb
required
Tieprob
number
expectedMargin
required
Expectedmargin
number
marginDistribution
required
Margindistribution
Array<object>
DistributionBucket
object
value
required
Value
number
probability
required
Probability
number
cumulative
required
Cumulative
number
attackerSumStats
required
SumStatistics

Summary statistics for the sum of a dice pool.

object
mean
required
Mean
number
stdDev
required
Stddev
number
minimum
required
Minimum
integer
maximum
required
Maximum
integer
median
required
Median
number
defenderSumStats
required
SumStatistics

Summary statistics for the sum of a dice pool.

object
mean
required
Mean
number
stdDev
required
Stddev
number
minimum
required
Minimum
integer
maximum
required
Maximum
integer
median
required
Median
number

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object