Good reporting on attacks
Build Successful The Ravenous rulebook, master handbook, and balance reports were built successfully.
Ravenous/ravenous_typst/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-08-22 23:49:52 +02:00
parent e5c4098a79
commit 41325ca4a5
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
2 changed files with 136 additions and 21 deletions

View File

@ -182,6 +182,7 @@
(
attack-id: attack.attack_id,
name: attack.name,
attack-type: category-or(attack.attack_type, "—"),
phase: attack.phase,
stance: player.profile_stance,
showcase: showcase,
@ -345,8 +346,8 @@
}
if item.one.ratio < 0.25 and item.two.ratio >= 0.25 { tags.push("Pression progressive") }
if item.one.ratio >= 1 { tags.push("Exécution immédiate") }
if item.defense-required >= 3 { tags.push("Pêche profonde") }
if item.threshold <= 5 and item.defense-required > 0 { tags.push("Pêche difficile") }
if item.defense-required >= 3 { tags.push("Défense en profondeur") }
if item.threshold <= 5 and item.defense-required > 0 { tags.push("Défense difficile") }
if item.maximum.ratio < 0.25 { tags.push("Faible menace directe") }
if tags.len() == 0 { tags.push("Pression standard") }
tags

View File

@ -20,21 +20,66 @@
#let stance-short(stance) = (
Neutral: "N", Defensive: "D", Offensive: "O", NoDefense: "ND",
).at(stance, default: stance)
#let expected-label(actual, expected) = if actual == expected {
box(
inset: (x: 2.5pt, y: 0.6pt), radius: 2.5pt,
fill: rgb("#4F805A").transparentize(78%),
stroke: 0.4pt + rgb("#4F805A"),
)[#text(fill: rgb("#31573A"), weight: "bold")[#expected]]
} else {
#let category-color(category) = (
None: report-theme.muted,
Chip: report-theme.chart-3,
Moderate: report-theme.chart-4,
High: report-theme.chart-2,
NearDeath: report-theme.dark-gold,
Kill: report-theme.chart-1,
FullBreak: report-theme.chart-1,
Overkill: report-theme.blood,
Malformed: report-theme.muted-ink,
).at(category, default: report-theme.muted-ink)
#let expected-label(expected, muted: false) = {
let color = category-color(expected)
box(
inset: (x: 2pt, y: 0.5pt), radius: 2pt,
fill: color.transparentize(if muted { 94% } else { 82% }),
stroke: 0.35pt + color.transparentize(if muted { 68% } else { 0% }),
)[#text(fill: if muted { report-theme.muted-ink.lighten(18%) } else { color.darken(18%) })[#expected]]
}
#let attack-family-color(kind) = if kind in ("ATK", "ASE", "CMB", "FLR", "GRB", "MXU", "ADF", "CLV", "AOE", "WID") {
report-theme.chart-1
} else if kind in ("BYP", "TBU", "TBZ", "TSH", "WIP", "BIS") {
report-theme.blood
} else if kind == "MVT" {
report-theme.chart-3
} else if kind in ("DEF", "REV") {
report-theme.chart-4
} else if kind == "PAS" {
report-theme.chart-4.lighten(22%)
} else if kind == "CLM" {
report-theme.dark-gold
} else if kind in ("TRA", "BAD") {
report-theme.chart-2
} else if kind in ("SRG", "HRG") {
report-theme.heading-accent
} else if kind in ("STA", "SZO", "SIT") {
report-theme.muted
} else {
report-theme.muted-ink
}
#let balance-status(row) = if row.damage-category == row.damage-expected and row.armor-category == row.armor-expected {
box(
inset: (x: 1.8pt, y: 0.35pt), radius: 2.5pt,
fill: report-theme.chart-4.transparentize(78%),
stroke: 0.4pt + report-theme.chart-4,
)[#text(fill: report-theme.chart-4.darken(18%), weight: "bold")[✓]]
} else {
box(
inset: (x: 1.8pt, y: 0.35pt), radius: 2.5pt,
fill: report-theme.chart-1.transparentize(82%),
stroke: 0.35pt + report-theme.chart-1,
)[#expected]
stroke: 0.4pt + report-theme.chart-1,
)[#text(fill: report-theme.chart-1.darken(12%), weight: "bold")[×]]
}
#let attack-row-label(row) = if row.showcase == "Balancing" {
[#row.name #text(size: 0.88em, weight: "bold", fill: report-theme.heading-accent)[(#(stance-short(row.stance)))]]
let color = attack-family-color(row.attack-type)
[#box(
inset: (x: 2.2pt, y: 0.55pt), radius: 2pt,
fill: color.transparentize(78%), stroke: 0.4pt + color,
)[#text(weight: "bold", fill: color.darken(20%))[#row.name #text(size: 0.88em)[(#(stance-short(row.stance)))]]]
#h(1.5pt)#balance-status(row)]
} else {
box(inset: (left: 7pt))[#text(fill: report-theme.muted-ink)[#stance-label(row.stance)]]
}
@ -49,6 +94,30 @@
#let defense-secondary-value(row, value) = if row.stance == "Neutral" {
value
} else { text(fill: report-theme.muted-ink, value) }
#let durability-color(actual, target) = if actual == none or actual == "NaN" or target == none or target == 0 {
report-theme.muted-ink
} else {
let difference = calc.abs(actual - target) / target * 100
if difference < 20 { report-theme.chart-4 }
else if difference < 30 { report-theme.chart-3 }
else if difference < 40 { report-theme.chart-1 }
else { report-theme.blood }
}
#let durability-target(row, actual, target) = {
let color = durability-color(actual, target)
let muted = row.stance != "Neutral"
box(
inset: (x: 2pt, y: 0.45pt), radius: 2pt,
fill: color.transparentize(if muted { 94% } else { 82% }),
stroke: 0.35pt + color.transparentize(if muted { 68% } else { 0% }),
)[#text(fill: if muted { report-theme.muted-ink.lighten(18%) } else { color.darken(18%) })[
#turns(actual, target)
]]
}
#let durability-legend-pill(label, color) = box(
inset: (x: 2.3pt, y: 0.5pt), radius: 2pt,
fill: color.transparentize(82%), stroke: 0.35pt + color,
)[#text(size: 5.2pt, weight: "bold", fill: color.darken(18%))[#label]]
#let percent-number(value) = str(calc.round(value * 100)) + "%"
#let diagnostic-colors = (
"Nuke": rgb("#7A2424"),
@ -57,8 +126,8 @@
"Thrashing": rgb("#A66A32"),
"Pression progressive": rgb("#70582F"),
"Exécution immédiate": rgb("#8D263D"),
"Pêche profonde": rgb("#365F82"),
"Pêche difficile": rgb("#62517B"),
"Défense en profondeur": rgb("#365F82"),
"Défense difficile": rgb("#62517B"),
"Faible menace directe": rgb("#6B716D"),
"Pression standard": rgb("#4F805A"),
)
@ -91,15 +160,52 @@
]
}
#let heuristic-methodology() = page(paper: "a4", margin: (x: 14mm, y: 14mm))[
#heading(level: 2)[Analyse avancée — méthode des archétypes]
#text(size: 7.4pt, fill: report-theme.muted-ink)[
Cette lecture ne remplace pas le type déclaré d’une capacité. Elle simule chaque
attaque contre les profils de joueurs de sa Difficulté, mesure les dégâts après
mitigation et observe combien de profils survivent. Plusieurs archétypes peuvent
donc décrire la même attaque : ils signalent des propriétés complémentaires, pas
des classes exclusives.
]
#v(5pt)
#tables.set-table-style(
table(
columns: (1.05fr, 3.2fr), align: (left, left),
table.header([Archétype], [Règle et interprétation]),
[Nuke], [Aucun profil ne survit, ou les dégâts non mitigés atteignent au moins 200 % des PV. La réponse défensive ordinaire ne suffit plus.],
[Tank buster], [Le profil Défensif survit, au plus la moitié des profils survivent, et le maximum atteint au moins Kill. Une défense lourde reste une réponse viable.],
[Contrôle de défense], [Le maximum atteint Kill alors que la cible prévue ne dépasse pas Moderate. L’attaque vérifie que la mitigation attendue est effectivement présente.],
[Thrashing], [Une réussite inflige moins de 25 % des PV et le maximum reste entre 25 % et moins de 100 %. Menace répétée, mais pas létale seule.],
[Pression progressive], [Une réussite reste sous 25 %, deux réussites atteignent au moins 25 %. La dangerosité monte nettement avec les réussites excédentaires.],
[Exécution immédiate], [Une seule réussite suffit à atteindre 100 % des PV après la mitigation du profil cible.],
[Défense en profondeur], [Il faut retirer au moins trois réussites à l’attaque pour que le profil cible survive. La défense doit produire beaucoup de réussites.],
[Défense difficile], [Une défense est nécessaire et son seuil effectif est de 5 ou moins. Les réussites défensives exigées sont difficiles à obtenir.],
[Faible menace directe], [Même le maximum non mitigé reste sous 25 % des PV. L’intérêt de la capacité vient probablement d’un effet, d’un groupe ou de sa répétition.],
[Pression standard], [Aucune règle spécialisée ci-dessus ne s’applique. Le profil ne présente pas d’extrême détecté par ces seuils.],
),
table-theme: "steingrund", text-size: 6.6pt,
)
#v(7pt)
#text(size: 6.8pt, fill: report-theme.muted-ink)[
*Mesures annexes.* Le rang de groupe compare une attaque aux autres capacités de
son groupe. Le z-score compare ses réussites aux créatures de même Difficulté.
La probabilité défensive estime la chance d’obtenir les réussites nécessaires au
seuil indiqué. Les lectures 1R/2R isolent le chip damage; Survie/max compte les
profils encore vivants et expose le cas sans mitigation.
]
]
#let defense-table(rows) = {
let body = rows.map(row => (
defense-row-label(row),
defense-secondary-value(row, ratio(row.armor-per-turn, row.integrity-p1)),
defense-secondary-value(row, turns(row.time-armor, row.target-armor)),
durability-target(row, row.time-armor, row.target-armor),
defense-secondary-value(row, ratio(row.damage-p1, row.health-p1)),
defense-secondary-value(row, turns(row.time-p1, row.target-p1)),
durability-target(row, row.time-p1, row.target-p1),
defense-secondary-value(row, ratio(row.damage-p2, row.health-p2)),
defense-secondary-value(row, turns(row.time-p2, row.target-p2)),
durability-target(row, row.time-p2, row.target-p2),
// The reference renderer intentionally shows DPT P2 in the second slot,
// even though the time after the arrow uses damage-through.
defense-secondary-value(row,
@ -129,10 +235,10 @@
secondary-value(row, decimal(row.successes-left) + " [>" + str(row.threshold) + "]"),
secondary-value(row, ratio(row.tanked, row.health)),
secondary-value(row, row.damage-category),
expected-label(row.damage-category, row.damage-expected),
expected-label(row.damage-expected, muted: row.showcase != "Balancing"),
secondary-value(row, ratio(row.armor-loss, row.integrity)),
secondary-value(row, row.armor-category),
expected-label(row.armor-category, row.armor-expected),
expected-label(row.armor-expected, muted: row.showcase != "Balancing"),
))
tables.set-table-style(
table(
@ -183,6 +289,8 @@
show-balanced: show-balanced,
)
heuristic-methodology()
for analysis in analyses {
let creature = analysis.creature
let balancing = creature.raw.balancing.first()
@ -195,6 +303,11 @@
correspondent aux profils supplémentaires demandés par `show_extra`.
]
#heading(level: 3)[Durabilité par partie et profil offensif des joueurs]
#text(size: 5.6pt, fill: report-theme.muted-ink)[Écart au nombre de tours cible :]
#h(2pt)#durability-legend-pill([< 20 %], report-theme.chart-4)
#h(2pt)#durability-legend-pill([20–30 %], report-theme.chart-3)
#h(2pt)#durability-legend-pill([30–40 %], report-theme.chart-1)
#h(2pt)#durability-legend-pill([≥ 40 %], report-theme.blood)
#defense-table(analysis.defense)
#heading(level: 3)[Signature offensive — synthèse]
#heuristic-summary(analysis.diagnostics)
@ -221,8 +334,9 @@
#heading(level: 3)[Létalité des capacités — #creature.name (#(index + 1)/#chunks.len())]
#text(size: 7.2pt, fill: report-theme.muted-ink)[
La première ligne de chaque capacité est son profil cible de balancing;
les suivantes montrent les autres postures. Une cible encadrée signale
que la catégorie calculée diffère de la catégorie attendue en base.
les suivantes montrent les autres postures. La couleur du nom suit le
type déclaré, les cibles suivent un gradient de gravité, et le ✓ ou ×
indique si dégâts et armure correspondent tous deux aux cibles en base.
]
#attack-table(rows)
]