The Deadlock Wiki - User contributions [en]

Template:Infobox hero/styles.css

2026-07-16T20:02:16Z

~2026-GlassGreenKinetic677: clarify link-underline class

/* ========== @MEDIA/MINERVA FIXES/OVERRIDES ========== */
body.skin-minerva .infobox-h table{
margin: 0;
}
body.skin-minerva .infobox-h table caption{
text-align: center;
display: table-caption;
}

@media (max-width: 639px){
.infobox-h table,
body.skin-minerva .infobox-h table{
display: table;
overflow: visible;
}

.infobox-h table.infobox-h-content{
display: table;
}
}

@media (max-width: 539px){
body.skin-minerva .infobox-h{
max-width: 350px;
margin: 0em auto 1em auto;
float: none;
}
body.skin-minerva .infobox-h-subsection table td{
width: 50%;
}
}

/* ========== INFOBOX_HERO CSS ========== */
.infobox-h{
/* -- variables -- */
--th-heroinfobox-text-normal: white;

--th-heroinfobox-bg-image: url('/images/3/3e/Infobox_Item_BG.png');
--th-heroinfobox-bg-height: 700px;
--th-heroinfobox-bg-margin: 0px;
--th-heroinfobox-bg-grad-offset: 0px;
--th-heroinfobox-bg-grad-height: calc(var(--th-heroinfobox-bg-grad-offset) + var(--th-heroinfobox-bg-height));
--th-heroinfobox-bg-grad-point1: calc(var(--th-heroinfobox-bg-grad-height) * calc(3 / 7));
--th-heroinfobox-logo-bleed: 0px;
--th-heroinfobox-logo-bottom: 0px;
--th-heroinfobox-tags-text: #FFEFD7;
--th-heroinfobox-tags-back: #000000;
--th-heroinfobox-color1: #2F2F2F;
--th-heroinfobox-color1-transparent: color-mix(in srgb, var(--th-heroinfobox-color1) 70%, transparent 30%);
--th-heroinfobox-color1-grad: #2F2F2F;
--th-heroinfobox-color2: #5b5b5b;
--th-heroinfobox-color2-shadow: color-mix(in srgb, var(--th-heroinfobox-color2) 60%, black 20%, transparent 20%);

--th-heroinfobox-text-title: #FFEFD7;
--th-heroinfobox-stats-text: #F2EDE5;
--th-heroinfobox-stats-back: #11111180;

--th-heroinfobox-tornbox: url('/images/a/a1/Infobox_UI_Torn-Box.png');

/* -- base styles -- */
float: right;
position: relative;
width: 100%;
max-width: 275px;
min-width: 240px;
border-collapse: collapse;

font-family: 'Retail Demo', 'Open Sans', serif;
font-size: 15px;
background-color: var(--th-heroinfobox-color1);
margin: 0 0 1em 1em;
}

/* ---------- Background Styling ---------- */
.infobox-h-background {
position: absolute;
width: 100%;
height: 100%;
overflow: hidden;
}

/* --- Background Horizontal Positioning --- */
.infobox-h-background > figure{
margin-right: var(--th-heroinfobox-bg-margin) !important;
}

/* ---------- Content Styling ---------- */
.infobox-h-content {
position: relative;
width: 100%;
top: 0;
right: 0;
background-position: center top;
background-repeat: repeat;
background-size: cover;

color: var(--th-heroinfobox-text-normal);
background-image: linear-gradient(180deg, var(--th-heroinfobox-color1-transparent) var(--th-heroinfobox-bg-grad-point1), var(--th-heroinfobox-color1-grad) var(--th-heroinfobox-bg-grad-height));
background-color: transparent;
font-size: 15px;
text-align: center;
text-shadow: 1.5px 1.5px rgba(0, 0, 0, 0.7);
}

.infobox-h, .infobox-h-background, .infobox-h-content{
border-radius: 8px;
}

.infobox-h .infobox-h-image {
margin: auto;
border: none;
text-align: center;
}

/* ---------- Top Section (Above Portrait) ---------- */
.infobox-h-title{
color: var(--th-heroinfobox-text-title);
font-size: 22px;
font-weight: bold;
text-align: center;
text-shadow: 1.2px 2px 3px black, 1.2px 1.2px 0.1px #A5A5A5;
}

.infobox-h-title-regular{
color: var(--th-heroinfobox-text-title);
font-size: 22px;
font-weight: normal;
text-align: center;
text-shadow: 1.2px 2px 3px black, 1.2px 1.2px 0.1px #A5A5A5;
}

.infobox-h-title-hero{
display: flex;
position: relative;
justify-content: space-between;
align-items: center;
min-height: 34px;
margin-top: 2px;
margin-bottom: var(--th-heroinfobox-logo-bottom);
}

.infobox-h-title-hero-left{
position: absolute;
height: 100%;
top: 0;
left: 0;
}

/* --- Logo/Name --- */
.infobox-h-title-hero-middle{
position: relative;
width: 100%;
font-family: 'Valve Occult', 'Retail Demo', 'Open Sans', serif;
line-height: 30px;
filter: drop-shadow(1px 1px 2px black);
}
.infobox-h-title-hero-middle-text{
width: calc(100% - 120px);
margin: 0px 60px;
line-height: 1em;
padding-bottom: 4px;
word-break: break-word;
}
.infobox-h-title-hero-middle > span{
bottom: 0 !important;
}
.infobox-h-title-hero-middle img{
margin: var(--th-heroinfobox-logo-bleed);
}

/* --- Map Icon --- */
.infobox-h-title-hero-right{
position: absolute;
height: 45px;
width: auto;
aspect-ratio: 1;
top: 0;
right: 0;
margin-right: 5px;
}
.infobox-h-title-hero-right > div{
position: relative;
width: 100%;
height: 100%;
}

/* --- Torn Box Behind Map Icon --- */
.infobox-h-title-hero-tornbox{
position: absolute;
width: 105%;
height: 105%;
top: -2.5%;
right: -2.5%;
transform: rotate(-72deg);
background-color: var(--th-heroinfobox-color2);
mask-image: var(--th-heroinfobox-tornbox);
mask-mode: luminance;
mask-position: 0 0;
mask-size: 100% 100%;
}

.infobox-h-title-hero-icon{
position: absolute;
width: calc(100% - 10px);
height: calc(100% - 10px);
top: 0;
right: 0;
padding: 5px;
font-size: 16px;
}

/* --- Text Before Stats --- */
.infobox-h-text-weapon{
padding: 2px 0;
line-height: 1.2em;
position: relative;
}

.infobox-h-text-stat-subtitle > *:first-child,
.infobox-h-text-stat-subtitle-border > *:first-child{
margin-top: 4px;
margin-bottom: 0;
text-transform: uppercase;
}
.infobox-h-text-stat-subtitle > *:first-child{
margin-top: 4px;
}
.infobox-h-text-stat-subtitle-border{
margin-top: 2px;
border-top: solid 2px var(--th-heroinfobox-color2);
}

/* ---------- Hero Portrait Image ---------- */
.infobox-h-image > div{
max-width: 150px;
height: auto;
margin: auto;
padding: 0;
overflow: hidden;
border-radius: 8px;
background-color: var(--th-heroinfobox-color2);
box-shadow: 2px 2px 8px rgba(0, 0, 0, 0.7);
}
.infobox-h-image > div img{
filter: drop-shadow(2px 3px 2px var(--th-heroinfobox-color2-shadow));
clip-path: rect(3px calc(100% - 3px) calc(100% - 3px) 3px round 8px);
}

/* ---------- Hero Tags (Inside Infobox) ---------- */
.infobox-h-herotags-row {
padding: 0;
}

.infobox-h-herotags-inner {
display: flex;
justify-content: center;
flex-wrap: wrap;
gap: 6px;
padding: 4px 0 6px 0;
}

.infobox-h-herotag-pill {
display: inline-block;
padding: 2px 8px;
border-radius: 4px;
background: var(--th-heroinfobox-stats-back);
font-size: 13px;
font-weight: 600;
color: var(--th-heroinfobox-text-title);
text-transform: uppercase;
letter-spacing: 0.03em;
text-shadow: 1.5px 1.5px 0.8px rgba(0, 0, 0, 0.5);
}

/* ------------ Statistic Subsections -------------------*/
/* note: dropdown is a child of subsection */

.infobox-h-subsection {
padding: 0 2px 2px 2px;
vertical-align: middle;
}

.infobox-h-subsection table{
table-layout: auto;
padding: 0 6px;
}

.infobox-h-subsection tr{
font-size: 14px;
text-align: left;
line-height: 1.1em;
}
.infobox-h-subsection tr > td{
padding-bottom: 2px;
}
.infobox-h-subsection tr:first-child > td{
padding-top: 2px;
}
.infobox-h-dropdown .infobox-h-subsection-child tr:first-child > td {
padding-top: 5px;
}
.infobox-h-subsection tr:last-child > td{
padding-bottom: 4px;
}
.infobox-h-subsection tr > td:first-child{
width: auto;
font-family: "Retail Demo Medium", "Retail Demo", 'Open Sans', serif;
text-shadow: 1.5px 1.5px 0.8px rgba(0,0,0,0.5);
color: var(--th-heroinfobox-stats-text);
text-align: right;
padding-right: 4px;
vertical-align: top;
}
.infobox-h-subsection tr > td:first-child .infobox-h-stat-label{
color: var(--th-heroinfobox-stats-text);
text-decoration: underline;
}
.infobox-h-subsection tr > td:last-child{
width: max-content;
padding-left: 4px;
vertical-align: middle;
}

.infobox-h-spiritboon{
display: inline-block;
}
.infobox-h-spiritboon:not(:empty){
padding-right: 0;
}
.infobox-h-dropdown tr:first-child .infobox-h-spiritboon:not(:empty){
padding-top: 3px;
}

.infobox-h-subsection-child{
width: 100%;
font-weight: normal;
text-shadow: 1.5px 1.5px 0.8px rgba(0, 0, 0, 0.8);
background-color: var(--th-heroinfobox-stats-back);
border-radius: 4px;
}

.infobox-h-dropdown-header > button{
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
width: min-content;
height: min-content;
margin: auto 0 auto auto;
padding-right: 5px;
text-shadow: inherit;
}

.infobox-h-dropdown-title{
text-shadow: 0 2px 4px black, 1.2px 1.2px rgba(0, 0, 0, 0.7);
color: var(--th-heroinfobox-text-normal);
}

.infobox-h-dropdown-header button,
.infobox-h-dropdown-header button .mw-collapsible-text{
color: var(--th-heroinfobox-header-link);
font-size: 13px;
font-weight: bold;
}

.infobox-h-dropdown-header button.mw-collapsible-text:hover,
.infobox-h-dropdown-header button .mw-collapsible-text:hover{
color: white;
}

.infobox-h-dropdown-header-overflow a{
display: block;
margin: 2px 65px 2px 5px;
width: fit-content;
line-height: 1.25em;
word-break: break-word;
}

/* ------------ Dropdown Subsection Only -------------------*/
.infobox-h-dropdown{
--th-heroinfobox-header-back: #d5903f;
--th-heroinfobox-header-link: #F4E3CF;
}

.infobox-h-dropdown .infobox-h-subsection-child{
border-top-right-radius: 0;
border-top-left-radius: 0;
}

.infobox-h-dropdown .infobox-h-subsection-child:not(.mw-collapsed) .infobox-h-dropdown-header{
border-bottom-right-radius: 0;
border-bottom-left-radius: 0;
}

.infobox-h-dropdown tr > td:last-child{
white-space: nowrap;
}

/*--- Statistic Dropdown Themes --- */
.infobox-h-dropdown-weapon{
--th-heroinfobox-header-back: #CD8837;
--th-heroinfobox-header-link: #FFF0DF;
}
.infobox-h-dropdown-vitality{
--th-heroinfobox-header-back: #74b01c;
--th-heroinfobox-header-link: #DAFFD2;
}
.infobox-h-dropdown-spirit{
--th-heroinfobox-header-back: #A657BC;
--th-heroinfobox-header-link: #ffdff8;
}

/*--- Statistic Dropdown Header --- */
.infobox-h-dropdown-header{
position: relative;
width: calc(100% - 4px);
padding: 1px;

background-color: var(--th-heroinfobox-header-back);
border-radius: 4px;
}

/* ------------ Subsection Text Themes -------------------*/
.infobox-h-content .infotext-h-bold{
font-weight: bold;
}
.infobox-h-content .infotext-h-title{
color: var(--th-heroinfobox-text-title);
}
.infobox-h-content .infotext-h-big{
font-size: 16px;
}
.infobox-h-content .infotext-h-bigger{
text-shadow: 1.1px 2px 2px black, 1.2px 1.2px 0.2px #7a7369;
font-size: 18px;
}

/* ------------ Stat Cell Modifiers -------------------*/

/* Headroom for a section's first row when it carries a scaling icon. */
.infobox-h .infobox-h-dropdown .infobox-h-subsection-child tr > td.infobox-h-stat-label-scaled{
padding-top: 8px;
}

/* Breathing room for value cells whose scaling icon sits near the edge. */
.infobox-h .infobox-h-dropdown .infobox-h-subsection-child tr > td.infobox-h-stat-value-padded{
padding-right: 5px;
}

Module:InfoboxHero

2026-07-16T20:01:44Z

~2026-GlassGreenKinetic677: move back to fancy tooltips, also add classes to label spans

--------------------------------------------------------------------------------
-- Module:InfoboxHero
--
-- Renders the hero infobox. Called from [[Template:Infobox hero]], which passes
-- the editor's parameters through as the parent frame:
--
-- {{#invoke:InfoboxHero|render}}
--
-- May also be invoked directly for testing, in which case parameters are read
-- from the invoke itself:
--
-- {{#invoke:InfoboxHero|render|key=hero_atlas}}
--
-- Stat data comes from [[Data:HeroData.json]]; per-hero colors, backgrounds and
-- logo sizes from [[Data:Infobox hero.json]]; labels from [[Module:Lang]] and
-- [[Module:Dictionary]]. Styling lives in [[Template:Infobox hero/styles.css]]
-- and [[Template:Infobox hero/themes.css]].
--
--------------------------------------------------------------------------------

local p = {}

local hero_data_all = mw.loadJsonData('Data:HeroData.json')
local theme_data = mw.loadJsonData('Data:Infobox_hero.json')

local util = require('Module:Utilities')
local lang_module = require('Module:Lang')
local dict_module = require('Module:Dictionary')
local hero_module = require('Module:HeroData')

local get_stat, has_stat, has_override_or_stat, stat_number

--------------------------------------------------------------------------------
-- CONFIG
--------------------------------------------------------------------------------

local DEFAULT_HERO_KEY = 'hero_targetdummy' -- used when |key= is missing/unknown
local DEFAULT_SIG_FIGS = 3
local FALLBACK_CARD = 'Dummy card.png'

-- Row fields (all optional except a label):
-- stat Key in Data:HeroData.json. Resolved top-level, then .Weapon,
-- then .Weapon.AltFire. Omit for manual-input-only rows.
-- param |param= that overrides the value.
-- label Key in Data:Lang_<code>.json.
-- label_dict Key in Data:Dictionary. Used instead of `label`.
-- label_text Literal, untranslated label. Used instead of `label`.
-- link Target for the label, as 'Page' or 'Page#Anchor'. The language
-- suffix is inserted for us, so write the plain English title.
-- icon_link Target for the icon. Defaults to `link`.
-- icon File: name of the value icon. Omit for no icon.
-- sig_figs Significant figures. Defaults to 3.
-- suffix Appended directly after the value, e.g. '%', 's', 'm/s'.
-- scaling Set false to suppress the Boon/Spirit scaling span. Scaling is
-- shown by default wherever the data provides it.
-- optional Hide the row unless the hero has a non-zero value or scaling.
-- cell_class Extra class on the value cell.
-- show function(ctx) -> boolean. Row omitted when false.

local SECTIONS = {
{
class = 'infobox-h-dropdown-weapon',
header = 'CitadelHeroStats_Weapon',
link = 'Stats#Weapon',
color = 'Brown',
rows = {
{
stat = 'DPS',
param = 'dps',
label = 'DPS_label',
link = 'Damage per second',
icon = 'Damage.png',
-- DPS is derived from bullet damage and fire rate, both of which
-- show their own scaling; repeating it here would double-count.
scaling = false,
},
{
stat = 'BulletDamage',
param = 'bullet_damage',
label = 'StatDesc_BulletDamage',
link = 'Bullet Damage',
icon = 'Bullet damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'BulletsPerShot',
param = 'pellets_per_shot',
label = 'BonusPelletsPerShot_label',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.pellets > 1 end,
},
{
stat = 'BulletsPerBurst',
param = 'bullets_per_burst',
label_dict = 'BulletsPerBurst',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.burst > 1 end,
},
{
stat = 'ClipSize',
param = 'ammo',
label = 'StatDesc_ClipSizeBonus',
link = 'Ammo',
icon = 'Clip size icon.png',
},
{
stat = 'RoundsPerSecond',
param = 'bullets_per_sec',
label = 'StatDesc_RoundsPerSecond',
link = 'Fire Rate',
icon = 'Bullets per sec icon.png',
},
{
stat = 'ReloadTime',
param = 'reload_time',
label = 'StatDesc_ReloadTime',
link = 'Reload Time',
icon = 'AttributeIconReloadTime.png',
suffix = 's',
},
{
stat = 'BulletSpeed',
param = 'bullet_velocity',
label = 'StatDesc_BulletSpeed',
link = 'Bullet Velocity',
icon = 'AttributeIconBulletSpeed.png',
suffix = 'm/s',
},
{
stat = 'LightMeleeDamage',
param = 'light_melee',
label = 'StatDesc_LightMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'HeavyMeleeDamage',
param = 'heavy_melee',
label = 'StatDesc_HeavyMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
param = 'max_range',
label_text = 'Max Range',
link = 'Falloff Range',
show = function(ctx) return ctx.args.max_range ~= '' end,
},
{
stat = 'CritDamageBonusPercent',
label = 'StatDesc_CritDamageBonusScale',
link = 'Weapon Damage#Crit_Multiplier',
icon = 'Crit reduction.png',
suffix = '%',
show = function(ctx)
return stat_number(ctx, 'CritDamageBonusPercent') ~= 0
end,
},
},
},
{
class = 'infobox-h-dropdown-vitality',
header = 'CitadelHeroStats_Vitality',
link = 'Stats#Vitality',
color = 'Green',
rows = {
{
stat = 'MaxHealth',
param = 'max_health',
label = 'StatDesc_HealthAttribute',
link = 'Health',
icon = 'Health.png',
},
{
stat = 'BaseHealthRegen',
param = 'health_regen',
label = 'StatDesc_HealthRegen',
link = 'Health Regen',
icon = 'Health regen.png',
sig_figs = 2,
},
{
stat = 'CritDamageReceivedPercent',
param = 'crit_reduction',
label = 'StatDesc_CritDamageReceivedScale',
link = 'Damage Resistance#Crit_Reduction',
icon = 'Crit reduction.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletResist',
param = 'bullet_resist',
label = 'StatDesc_BulletArmorDamageReduction',
link = 'Damage Resistance',
icon = 'Bullet Armor.png',
icon_link = 'Bullet Resist',
suffix = '%',
optional = true,
},
{
stat = 'TechResist',
param = 'spirit_resist',
label = 'StatDesc_TechArmorDamageReduction',
link = 'Damage Resistance#Spirit_Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'MeleeResist',
param = 'melee_resist',
label = 'StatDesc_MeleeResist',
link = 'Damage Resistance#Melee Resist',
icon = 'Melee damage.png',
suffix = '%',
optional = true,
},
{
stat = 'DebuffResist',
param = 'debuff_resist',
label = 'StatDesc_DebuffResist',
link = 'Debuff Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletLifesteal',
param = 'bullet_lifesteal',
label = 'StatDesc_BulletLifesteal',
link = 'Lifesteal#Bullet Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'SpiritLifesteal',
param = 'spirit_lifesteal',
label = 'StatDesc_SpiritLifesteal',
link = 'Lifesteal#Spirit Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'MaxMoveSpeed',
param = 'move_speed',
label = 'StatDesc_RunSpeed',
link = 'Move Speed',
icon = 'Move speed.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'SprintSpeed',
param = 'sprint_speed',
label = 'StatDesc_SprintSpeed',
link = 'Move Speed#Sprint',
icon = 'Move speed sprint.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'GroundDashSpeed',
label = 'DashSpeed_label',
link = 'Stamina#Dash_Speed',
icon = 'Springy boots icon.png',
suffix = 'm/s',
},
{
stat = 'Stamina',
param = 'stamina',
label = 'StatDesc_Stamina',
link = 'Stamina',
icon = 'Springy boots icon.png',
sig_figs = 2,
},
{
stat = 'StaminaCooldown',
param = 'stamina_cooldown',
label = 'StatDesc_StaminaCooldown',
link = 'Stamina#Cooldown',
icon = 'AttributeIconTechDuration.png',
sig_figs = 2,
suffix = 's',
},
},
},
{
class = 'infobox-h-dropdown-spirit',
header = 'CitadelHeroStats_Spirit',
link = 'Stats#Spirit',
color = 'Purple',
rows = {
{
stat = 'TechPower',
param = 'spirit_power',
label = 'SpiritPower_label',
link = 'Spirit Power',
icon = 'Spirit icon noborder.png',
sig_figs = 2,
},
},
},
}

-- The "Information" block. Manual input only; hidden entirely when all are empty.
local INFO_ROWS = {
{ param = 'release_date', label_dict = 'ReleaseDate', link = 'Heroes by release' },
{ param = 'pronouns', label_dict = 'Pronouns' },
{ param = 'voice_actor', label_dict = 'VoiceActor' },
{ param = 'codenames', label_dict = 'Codenames', tooltip = 'Codenames used for this hero in the game files' },
}

-- name: literal, or function(ctx) -> string. when: function(ctx) -> boolean.
local CATEGORIES = {
{ name = 'Heroes' },
{
name = function(ctx) return ctx.hero_en end,
-- Silver (Transformed) is documented on Silver's page and shares her category.
when = function(ctx) return ctx.hero_en ~= 'Silver (Transformed)' end,
},
{
name = 'Heroes with spreadshot weapons',
when = function(ctx) return ctx.pellets > 1 end,
},
{
name = 'Heroes with single damage spreadshot weapons',
when = function(ctx)
return ctx.pellets > 1 and get_stat(ctx.hero, 'HitOnceAcrossAllBullets') == true
end,
},
{
name = 'Heroes with burst weapons',
when = function(ctx) return ctx.burst > 1 end,
},
{
name = 'Heroes with automatic weapons',
when = function(ctx) return ctx.pellets <= 1 and ctx.burst <= 1 end,
},
{
name = 'Heroes with alternate fire weapons',
when = function(ctx)
return ctx.hero.Weapon ~= nil and ctx.hero.Weapon.AltFire ~= nil
end,
},
{
name = 'Heroes with single reload weapons',
when = function(ctx) return get_stat(ctx.hero, 'ReloadSingle') == true end,
},
{
name = 'Heroes with spin up weapons',
when = function(ctx) return has_stat(ctx.hero, 'SpinAcceleration') end,
},
{
name = 'Heroes with no weapon damage falloff',
when = function(ctx)
return (get_stat(ctx.hero, 'FalloffStartRange') or 0)
== (get_stat(ctx.hero, 'FalloffEndRange') or 0)
end,
},
{
name = "Heroes that don't deal critical damage",
when = function(ctx) return get_stat(ctx.hero, 'CanCrit') == false end,
},
{
name = 'Heroes with modified crit scale',
when = function(ctx) return stat_number(ctx, 'CritDamageBonusPercent') ~= 0 end,
},
{
name = 'Heroes with modified crit resistance',
when = function(ctx)
return has_override_or_stat(ctx, 'crit_reduction', 'CritDamageReceivedPercent')
end,
},
{
name = 'Heroes with modified bullet resist',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_resist', 'BulletResist')
end,
},
{
name = 'Heroes with modified spirit resist',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_resist', 'TechResist')
end,
},
{
name = 'Heroes with modified melee resist',
when = function(ctx)
return has_override_or_stat(ctx, 'melee_resist', 'MeleeResist')
end,
},
{
name = 'Heroes with modified debuff resist',
when = function(ctx)
return has_override_or_stat(ctx, 'debuff_resist', 'DebuffResist')
end,
},
{
name = 'Heroes with modified bullet lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_lifesteal', 'BulletLifesteal')
end,
},
{
name = 'Heroes with modified spirit lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_lifesteal', 'SpiritLifesteal')
end,
},
{
name = 'Heroes with modified gravity scale',
when = function(ctx) return has_stat(ctx.hero, 'GravityChange') end,
},
{
name = function(ctx) return 'Heroes with ' .. ctx.stamina .. ' stamina' end,
when = function(ctx) return ctx.stamina ~= '' end,
},
{
name = function(ctx)
if ctx.dash < 14.7 then return 'Heroes with slow dash speed' end
if ctx.dash > 14.7 then return 'Heroes with fast dash speed' end
return 'Heroes with medium dash speed'
end,
},
}

--------------------------------------------------------------------------------
-- Data access
--------------------------------------------------------------------------------

-- Stats live at the top level for vitality, and under .Weapon for weapon stats.
get_stat = function(hero, stat)
if hero == nil or stat == nil then return nil end
local value = hero[stat]
if value == nil and hero.Weapon then
value = hero.Weapon[stat]
if value == nil and hero.Weapon.AltFire then
value = hero.Weapon.AltFire[stat]
end
end
return value
end

-- The raw Boon (Level) and Spirit scaling values for a stat, if any.
local function get_scaling(hero, stat)
local out = {}
for _, scaling_type in ipairs({ 'Level', 'Spirit' }) do
local scaling = hero[scaling_type .. 'Scaling']
local value = scaling and stat and scaling[stat]
if value ~= nil and value ~= 0 then
out[#out + 1] = { type = scaling_type, value = value }
end
end
return out
end

-- True when the hero has a non-zero base value, or any scaling, for a stat.
has_stat = function(hero, stat)
local value = get_stat(hero, stat)
if value ~= nil and value ~= 0 then return true end
return #get_scaling(hero, stat) > 0
end

has_override_or_stat = function(ctx, param, stat)
if param and ctx.args[param] ~= '' then return true end
return has_stat(ctx.hero, stat)
end

-- Rounded numeric value of a stat, honouring a |param= override.
stat_number = function(ctx, stat, param)
if param and ctx.args[param] ~= '' then return tonumber(ctx.args[param]) or 0 end
return tonumber(util.round_to_sig_fig(get_stat(ctx.hero, stat) or 0, DEFAULT_SIG_FIGS)) or 0
end

local function format_value(raw, sig_figs)
if raw == nil then return '0' end
local rounded = util.round_to_sig_fig(raw, sig_figs or DEFAULT_SIG_FIGS)
return tostring(rounded ~= nil and rounded or raw)
end

--------------------------------------------------------------------------------
-- Rendering helpers
--------------------------------------------------------------------------------

local function theme_var(hero_key, name)
local hero_theme = theme_data[hero_key]
if hero_theme and hero_theme[name] ~= nil then return hero_theme[name] end
return theme_data['hero_default'][name]
end

local function label_of(row)
if row.label_text then return row.label_text end
if row.label_dict then return dict_module.translate(row.label_dict) end
return lang_module.get_string(row.label)
end

-- 'Damage Resistance#Spirit_Resist' -> 'Damage Resistance/ru#Spirit_Resist'
local function page_link(ctx, target)
if not target then return '' end
local page, anchor = target:match('^([^#]*)(#?.*)$')
return page .. ctx.if_lang .. anchor
end

local function icon_cell(ctx, row, color, value_html)
local icon = ''
if row.icon then
icon = string.format('[[File:%s|20px|link=%s]]', row.icon,
page_link(ctx, row.icon_link or row.link))
end
return ctx.frame:expandTemplate{ title = 'Icon/' .. color, args = { icon, value_html } }
end

-- Ammo and reload time are meaningless for heroes whose weapon never reloads.
local NO_AMMO_STATS = { ClipSize = true, ReloadTime = true }

-- Returns true when the row rendered.
local function render_stat_row(ctx, tbl, row, color, is_first)
if row.show and not row.show(ctx) then return false end
if row.optional and not has_override_or_stat(ctx, row.param, row.stat) then return false end

local value, scaling_inner
if NO_AMMO_STATS[row.stat] and ctx.args.no_ammo == 'true' then
value, scaling_inner = 'N/A', ''
else
local override = row.param and ctx.args[row.param] or ''
if override ~= '' then
value = override
else
value = format_value(get_stat(ctx.hero, row.stat), row.sig_figs)
end
value = value .. (row.suffix or '')

if row.stat and row.scaling ~= false then
local parts = {}
for _, scaling in ipairs(get_scaling(ctx.hero, row.stat)) do
parts[#parts + 1] = hero_module.write_scalar_str(scaling.value, scaling.type)
end
scaling_inner = table.concat(parts)
value = value .. '' .. scaling_inner .. ''
else
scaling_inner = ''
end
end

local tr = tbl:tag('tr')

local label_cell = tr:tag('td')
-- The section's first row needs extra headroom when it carries a scaling icon.
if is_first and scaling_inner ~= '' then
label_cell:addClass('infobox-h-stat-label-scaled')
end
if row.link then
label_cell:wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label_of(row)))
else
label_cell:wikitext(label_of(row) .. ':')
end

local value_cell = tr:tag('td')
if row.cell_class then value_cell:addClass(row.cell_class) end
value_cell:wikitext(icon_cell(ctx, row, color, value))

return true
end

local function render_section(ctx, parent, section)
local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection infobox-h-dropdown ' .. section.class)
:tag('table'):addClass('mw-collapsible infobox-h-subsection-child')

local caption = tbl:tag('caption'):addClass('infobox-h-dropdown-header')
if ctx.if_lang == '/ru' then
caption:addClass('infobox-h-dropdown-header-overflow')
end
caption:wikitext(string.format(
'[[%s|%s]]',
page_link(ctx, section.link), lang_module.get_string(section.header)))

local is_first = true
for _, row in ipairs(section.rows) do
if render_stat_row(ctx, tbl, row, section.color, is_first) then
is_first = false
end
end
end

local function render_information(ctx, parent)
local present = {}
for _, row in ipairs(INFO_ROWS) do
if ctx.args[row.param] ~= '' then present[#present + 1] = row end
end
if #present == 0 then return end

parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-text-stat-subtitle')
:wikitext(''
.. dict_module.translate('Information') .. '')

local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection')
:tag('table'):addClass('infobox-h-subsection-child')

for _, row in ipairs(present) do
local tr = tbl:tag('tr')
local label = dict_module.translate(row.label_dict)
if row.tooltip then
label = ctx.frame:expandTemplate{ title = 'Tooltip', args = { label, row.tooltip } }
end
if row.link then
tr:tag('td'):wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label))
else
tr:tag('td'):wikitext(label .. ':')
end
tr:tag('td'):wikitext(ctx.args[row.param])
end
end

local function render_title(ctx, parent)
local th = parent:tag('tr'):tag('th'):attr('colspan', '2'):addClass('infobox-h-title')
if ctx.args.name_font_size ~= '' then
th:cssText('font-size: ' .. ctx.args.name_font_size .. ';')
end

local wrap = th:tag('div'):addClass('infobox-h-title-hero')
wrap:tag('div'):addClass('infobox-h-title-hero-left')

-- Name logo: <Name>_name.svg, or <Name>_name_<lang>.svg on translated pages.
-- Heroes without a logo fall back to their name as plain text.
local svg = ((ctx.args.name ~= '' and ctx.args.name) or ctx.hero_en) .. '_name'
if ctx.if_lang ~= '' then svg = svg .. '_' .. ctx.lang_code end

local middle = wrap:tag('div'):addClass('infobox-h-title-hero-middle')
if util.page_exists('File:' .. svg .. '.svg') then
middle:wikitext(ctx.frame:expandTemplate{ title = 'Icon/White', args = {
string.format('[[File:%s.svg|%s|class=notpageimage]]',
svg, theme_var(ctx.hero_key, 'logo-height')) } })
else
middle:wikitext(ctx.display_name)
end

local right = wrap:tag('div'):addClass('infobox-h-title-hero-right'):tag('div')
if ctx.show_icon then
local icon = ((ctx.args.icon ~= '' and ctx.args.icon) or ctx.hero_en) .. '.png'
if util.page_exists('File:' .. icon) then
right:tag('div'):addClass('infobox-h-title-hero-tornbox')
right:tag('div'):addClass('infobox-h-title-hero-icon')
:wikitext(string.format('[[File:%s|center|35px|class=notpageimage]]', icon))
end
end
end

local function render_card(ctx, parent)
local card = (ctx.args.card ~= '' and ctx.args.card) or (ctx.hero_en .. ' card.png')
if not util.page_exists('File:' .. card) then card = FALLBACK_CARD end
parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-image')
:tag('div')
:wikitext(string.format('[[File:%s|150px|alt=%s]]',
card, mw.title.getCurrentTitle().baseText))
end

local function render_tags(ctx, parent)
if not ctx.show_hero_tags then return end

local tags = {}
for i = 1, 3 do
local tag = hero_module.get_hero_tag({ args = { ctx.hero_en, tostring(i) } })
if tag and tag ~= '' and not tag:find('Error:', 1, true) then
tags[#tags + 1] = tag
end
end
if #tags == 0 then return end

local inner = parent:tag('tr'):tag('td')
:attr('colspan', '2')
:addClass('infobox-h-herotags-row')
:tag('div'):addClass('infobox-h-herotags-inner ' .. ctx.hero_key)
for _, tag in ipairs(tags) do
inner:tag('div'):addClass('infobox-h-herotag-pill'):wikitext(tag)
end
end

local function render_categories(ctx)
if mw.ustring.lower(ctx.args.nocat ~= '' and ctx.args.nocat or 'false') ~= 'false' then
return ''
end
if get_stat(ctx.hero, 'IsDisabled') ~= false then return '' end

local out = {}
for _, category in ipairs(CATEGORIES) do
if category.when == nil or category.when(ctx) then
local name = category.name
if type(name) == 'function' then name = name(ctx) end
out[#out + 1] = ctx.frame:expandTemplate{ title = 'lang cat', args = { name } }
end
end
return table.concat(out)
end

--------------------------------------------------------------------------------
-- Entry point
--------------------------------------------------------------------------------

-- |key= accepts a hero_* key or the hero's English name; unknown values fall back
-- to the target dummy, the default character in Sandbox mode.
local function resolve_hero_key(provided)
if provided == nil or provided == '' then return DEFAULT_HERO_KEY end
if hero_data_all[provided] ~= nil then return provided end
local wanted = mw.ustring.lower(provided)
for key, hero in pairs(hero_data_all) do
if hero.Name and mw.ustring.lower(hero.Name) == wanted then return key end
end
return DEFAULT_HERO_KEY
end

function p.render(frame)
local parent = frame:getParent()
local invoke_args = frame.args
local template_args = parent and parent.args or {}

-- Missing parameters read as '' so callers never have to nil-check.
local args = setmetatable({}, { __index = function(_, k)
local value = invoke_args[k]
if value == nil then value = template_args[k] end
return value or ''
end })

local hero_key = resolve_hero_key(args.key)
local hero = hero_data_all[hero_key]

local ctx = {
frame = frame,
args = args,
hero = hero,
hero_key = hero_key,
hero_en = hero.Name,
lang_code = lang_module.get_lang_code(),
if_lang = frame:expandTemplate{ title = 'If lang' },
}
ctx.display_name = (args.name ~= '' and args.name) or lang_module.get_string(hero_key)

ctx.show_hero_tags = args.show_hero_tags ~= 'false'
ctx.show_icon = args.show_icon ~= 'false'

-- Needed by both row visibility and the category rules.
ctx.pellets = stat_number(ctx, 'BulletsPerShot', 'pellets_per_shot')
ctx.burst = stat_number(ctx, 'BulletsPerBurst', 'bullets_per_burst')
ctx.dash = stat_number(ctx, 'GroundDashSpeed')
ctx.stamina = (args.stamina ~= '' and args.stamina)
or format_value(get_stat(hero, 'Stamina'), 2)

local root = mw.html.create('div'):addClass('infobox-h ' .. hero_key)
root:tag('div'):addClass('infobox-h-background')
:wikitext(string.format('[[File:%s|%s|right|link=|class=notpageimage]]',
theme_var(hero_key, 'bg-image'), theme_var(hero_key, 'bg-height')))

local tbl = root:tag('table'):addClass('infobox-h-content')
render_title(ctx, tbl)
render_card(ctx, tbl)
render_tags(ctx, tbl)
for _, section in ipairs(SECTIONS) do
render_section(ctx, tbl, section)
end
render_information(ctx, tbl)

if mw.title.getCurrentTitle().nsText ~= 'Template' then
frame:callParserFunction('DISPLAYTITLE', ctx.display_name)
end
return tostring(root) .. render_categories(ctx)
end

return p

Module:InfoboxHero

2026-07-16T19:46:30Z

~2026-GlassGreenKinetic677: change tooltip type (the boring html title style)

--------------------------------------------------------------------------------
-- Module:InfoboxHero
--
-- Renders the hero infobox. Called from [[Template:Infobox hero]], which passes
-- the editor's parameters through as the parent frame:
--
-- {{#invoke:InfoboxHero|render}}
--
-- May also be invoked directly for testing, in which case parameters are read
-- from the invoke itself:
--
-- {{#invoke:InfoboxHero|render|key=hero_atlas}}
--
-- Stat data comes from [[Data:HeroData.json]]; per-hero colors, backgrounds and
-- logo sizes from [[Data:Infobox hero.json]]; labels from [[Module:Lang]] and
-- [[Module:Dictionary]]. Styling lives in [[Template:Infobox hero/styles.css]]
-- and [[Template:Infobox hero/themes.css]].
--
--------------------------------------------------------------------------------

local p = {}

local hero_data_all = mw.loadJsonData('Data:HeroData.json')
local theme_data = mw.loadJsonData('Data:Infobox_hero.json')

local util = require('Module:Utilities')
local lang_module = require('Module:Lang')
local dict_module = require('Module:Dictionary')
local hero_module = require('Module:HeroData')

local get_stat, has_stat, has_override_or_stat, stat_number

--------------------------------------------------------------------------------
-- CONFIG
--------------------------------------------------------------------------------

local DEFAULT_HERO_KEY = 'hero_targetdummy' -- used when |key= is missing/unknown
local DEFAULT_SIG_FIGS = 3
local FALLBACK_CARD = 'Dummy card.png'

-- Row fields (all optional except a label):
-- stat Key in Data:HeroData.json. Resolved top-level, then .Weapon,
-- then .Weapon.AltFire. Omit for manual-input-only rows.
-- param |param= that overrides the value.
-- label Key in Data:Lang_<code>.json.
-- label_dict Key in Data:Dictionary. Used instead of `label`.
-- label_text Literal, untranslated label. Used instead of `label`.
-- link Target for the label, as 'Page' or 'Page#Anchor'. The language
-- suffix is inserted for us, so write the plain English title.
-- icon_link Target for the icon. Defaults to `link`.
-- icon File: name of the value icon. Omit for no icon.
-- sig_figs Significant figures. Defaults to 3.
-- suffix Appended directly after the value, e.g. '%', 's', 'm/s'.
-- scaling Set false to suppress the Boon/Spirit scaling span. Scaling is
-- shown by default wherever the data provides it.
-- optional Hide the row unless the hero has a non-zero value or scaling.
-- cell_class Extra class on the value cell.
-- show function(ctx) -> boolean. Row omitted when false.

local SECTIONS = {
{
class = 'infobox-h-dropdown-weapon',
header = 'CitadelHeroStats_Weapon',
link = 'Stats#Weapon',
color = 'Brown',
rows = {
{
stat = 'DPS',
param = 'dps',
label = 'DPS_label',
link = 'Damage per second',
icon = 'Damage.png',
-- DPS is derived from bullet damage and fire rate, both of which
-- show their own scaling; repeating it here would double-count.
scaling = false,
},
{
stat = 'BulletDamage',
param = 'bullet_damage',
label = 'StatDesc_BulletDamage',
link = 'Bullet Damage',
icon = 'Bullet damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'BulletsPerShot',
param = 'pellets_per_shot',
label = 'BonusPelletsPerShot_label',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.pellets > 1 end,
},
{
stat = 'BulletsPerBurst',
param = 'bullets_per_burst',
label_dict = 'BulletsPerBurst',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.burst > 1 end,
},
{
stat = 'ClipSize',
param = 'ammo',
label = 'StatDesc_ClipSizeBonus',
link = 'Ammo',
icon = 'Clip size icon.png',
},
{
stat = 'RoundsPerSecond',
param = 'bullets_per_sec',
label = 'StatDesc_RoundsPerSecond',
link = 'Fire Rate',
icon = 'Bullets per sec icon.png',
},
{
stat = 'ReloadTime',
param = 'reload_time',
label = 'StatDesc_ReloadTime',
link = 'Reload Time',
icon = 'AttributeIconReloadTime.png',
suffix = 's',
},
{
stat = 'BulletSpeed',
param = 'bullet_velocity',
label = 'StatDesc_BulletSpeed',
link = 'Bullet Velocity',
icon = 'AttributeIconBulletSpeed.png',
suffix = 'm/s',
},
{
stat = 'LightMeleeDamage',
param = 'light_melee',
label = 'StatDesc_LightMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'HeavyMeleeDamage',
param = 'heavy_melee',
label = 'StatDesc_HeavyMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
param = 'max_range',
label_text = 'Max Range',
link = 'Falloff Range',
show = function(ctx) return ctx.args.max_range ~= '' end,
},
{
stat = 'CritDamageBonusPercent',
label = 'StatDesc_CritDamageBonusScale',
link = 'Weapon Damage#Crit_Multiplier',
icon = 'Crit reduction.png',
suffix = '%',
show = function(ctx)
return stat_number(ctx, 'CritDamageBonusPercent') ~= 0
end,
},
},
},
{
class = 'infobox-h-dropdown-vitality',
header = 'CitadelHeroStats_Vitality',
link = 'Stats#Vitality',
color = 'Green',
rows = {
{
stat = 'MaxHealth',
param = 'max_health',
label = 'StatDesc_HealthAttribute',
link = 'Health',
icon = 'Health.png',
},
{
stat = 'BaseHealthRegen',
param = 'health_regen',
label = 'StatDesc_HealthRegen',
link = 'Health Regen',
icon = 'Health regen.png',
sig_figs = 2,
},
{
stat = 'CritDamageReceivedPercent',
param = 'crit_reduction',
label = 'StatDesc_CritDamageReceivedScale',
link = 'Damage Resistance#Crit_Reduction',
icon = 'Crit reduction.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletResist',
param = 'bullet_resist',
label = 'StatDesc_BulletArmorDamageReduction',
link = 'Damage Resistance',
icon = 'Bullet Armor.png',
icon_link = 'Bullet Resist',
suffix = '%',
optional = true,
},
{
stat = 'TechResist',
param = 'spirit_resist',
label = 'StatDesc_TechArmorDamageReduction',
link = 'Damage Resistance#Spirit_Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'MeleeResist',
param = 'melee_resist',
label = 'StatDesc_MeleeResist',
link = 'Damage Resistance#Melee Resist',
icon = 'Melee damage.png',
suffix = '%',
optional = true,
},
{
stat = 'DebuffResist',
param = 'debuff_resist',
label = 'StatDesc_DebuffResist',
link = 'Debuff Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletLifesteal',
param = 'bullet_lifesteal',
label = 'StatDesc_BulletLifesteal',
link = 'Lifesteal#Bullet Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'SpiritLifesteal',
param = 'spirit_lifesteal',
label = 'StatDesc_SpiritLifesteal',
link = 'Lifesteal#Spirit Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'MaxMoveSpeed',
param = 'move_speed',
label = 'StatDesc_RunSpeed',
link = 'Move Speed',
icon = 'Move speed.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'SprintSpeed',
param = 'sprint_speed',
label = 'StatDesc_SprintSpeed',
link = 'Move Speed#Sprint',
icon = 'Move speed sprint.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'GroundDashSpeed',
label = 'DashSpeed_label',
link = 'Stamina#Dash_Speed',
icon = 'Springy boots icon.png',
suffix = 'm/s',
},
{
stat = 'Stamina',
param = 'stamina',
label = 'StatDesc_Stamina',
link = 'Stamina',
icon = 'Springy boots icon.png',
sig_figs = 2,
},
{
stat = 'StaminaCooldown',
param = 'stamina_cooldown',
label = 'StatDesc_StaminaCooldown',
link = 'Stamina#Cooldown',
icon = 'AttributeIconTechDuration.png',
sig_figs = 2,
suffix = 's',
},
},
},
{
class = 'infobox-h-dropdown-spirit',
header = 'CitadelHeroStats_Spirit',
link = 'Stats#Spirit',
color = 'Purple',
rows = {
{
stat = 'TechPower',
param = 'spirit_power',
label = 'SpiritPower_label',
link = 'Spirit Power',
icon = 'Spirit icon noborder.png',
sig_figs = 2,
},
},
},
}

-- The "Information" block. Manual input only; hidden entirely when all are empty.
local INFO_ROWS = {
{ param = 'release_date', label_dict = 'ReleaseDate', link = 'Heroes by release' },
{ param = 'pronouns', label_dict = 'Pronouns' },
{ param = 'voice_actor', label_dict = 'VoiceActor' },
{ param = 'codenames', label_dict = 'Codenames', tooltip = 'Codenames used for this hero in the game files' },
}

-- name: literal, or function(ctx) -> string. when: function(ctx) -> boolean.
local CATEGORIES = {
{ name = 'Heroes' },
{
name = function(ctx) return ctx.hero_en end,
-- Silver (Transformed) is documented on Silver's page and shares her category.
when = function(ctx) return ctx.hero_en ~= 'Silver (Transformed)' end,
},
{
name = 'Heroes with spreadshot weapons',
when = function(ctx) return ctx.pellets > 1 end,
},
{
name = 'Heroes with single damage spreadshot weapons',
when = function(ctx)
return ctx.pellets > 1 and get_stat(ctx.hero, 'HitOnceAcrossAllBullets') == true
end,
},
{
name = 'Heroes with burst weapons',
when = function(ctx) return ctx.burst > 1 end,
},
{
name = 'Heroes with automatic weapons',
when = function(ctx) return ctx.pellets <= 1 and ctx.burst <= 1 end,
},
{
name = 'Heroes with alternate fire weapons',
when = function(ctx)
return ctx.hero.Weapon ~= nil and ctx.hero.Weapon.AltFire ~= nil
end,
},
{
name = 'Heroes with single reload weapons',
when = function(ctx) return get_stat(ctx.hero, 'ReloadSingle') == true end,
},
{
name = 'Heroes with spin up weapons',
when = function(ctx) return has_stat(ctx.hero, 'SpinAcceleration') end,
},
{
name = 'Heroes with no weapon damage falloff',
when = function(ctx)
return (get_stat(ctx.hero, 'FalloffStartRange') or 0)
== (get_stat(ctx.hero, 'FalloffEndRange') or 0)
end,
},
{
name = "Heroes that don't deal critical damage",
when = function(ctx) return get_stat(ctx.hero, 'CanCrit') == false end,
},
{
name = 'Heroes with modified crit scale',
when = function(ctx) return stat_number(ctx, 'CritDamageBonusPercent') ~= 0 end,
},
{
name = 'Heroes with modified crit resistance',
when = function(ctx)
return has_override_or_stat(ctx, 'crit_reduction', 'CritDamageReceivedPercent')
end,
},
{
name = 'Heroes with modified bullet resist',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_resist', 'BulletResist')
end,
},
{
name = 'Heroes with modified spirit resist',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_resist', 'TechResist')
end,
},
{
name = 'Heroes with modified melee resist',
when = function(ctx)
return has_override_or_stat(ctx, 'melee_resist', 'MeleeResist')
end,
},
{
name = 'Heroes with modified debuff resist',
when = function(ctx)
return has_override_or_stat(ctx, 'debuff_resist', 'DebuffResist')
end,
},
{
name = 'Heroes with modified bullet lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_lifesteal', 'BulletLifesteal')
end,
},
{
name = 'Heroes with modified spirit lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_lifesteal', 'SpiritLifesteal')
end,
},
{
name = 'Heroes with modified gravity scale',
when = function(ctx) return has_stat(ctx.hero, 'GravityChange') end,
},
{
name = function(ctx) return 'Heroes with ' .. ctx.stamina .. ' stamina' end,
when = function(ctx) return ctx.stamina ~= '' end,
},
{
name = function(ctx)
if ctx.dash < 14.7 then return 'Heroes with slow dash speed' end
if ctx.dash > 14.7 then return 'Heroes with fast dash speed' end
return 'Heroes with medium dash speed'
end,
},
}

--------------------------------------------------------------------------------
-- Data access
--------------------------------------------------------------------------------

-- Stats live at the top level for vitality, and under .Weapon for weapon stats.
get_stat = function(hero, stat)
if hero == nil or stat == nil then return nil end
local value = hero[stat]
if value == nil and hero.Weapon then
value = hero.Weapon[stat]
if value == nil and hero.Weapon.AltFire then
value = hero.Weapon.AltFire[stat]
end
end
return value
end

-- The raw Boon (Level) and Spirit scaling values for a stat, if any.
local function get_scaling(hero, stat)
local out = {}
for _, scaling_type in ipairs({ 'Level', 'Spirit' }) do
local scaling = hero[scaling_type .. 'Scaling']
local value = scaling and stat and scaling[stat]
if value ~= nil and value ~= 0 then
out[#out + 1] = { type = scaling_type, value = value }
end
end
return out
end

-- True when the hero has a non-zero base value, or any scaling, for a stat.
has_stat = function(hero, stat)
local value = get_stat(hero, stat)
if value ~= nil and value ~= 0 then return true end
return #get_scaling(hero, stat) > 0
end

has_override_or_stat = function(ctx, param, stat)
if param and ctx.args[param] ~= '' then return true end
return has_stat(ctx.hero, stat)
end

-- Rounded numeric value of a stat, honouring a |param= override.
stat_number = function(ctx, stat, param)
if param and ctx.args[param] ~= '' then return tonumber(ctx.args[param]) or 0 end
return tonumber(util.round_to_sig_fig(get_stat(ctx.hero, stat) or 0, DEFAULT_SIG_FIGS)) or 0
end

local function format_value(raw, sig_figs)
if raw == nil then return '0' end
local rounded = util.round_to_sig_fig(raw, sig_figs or DEFAULT_SIG_FIGS)
return tostring(rounded ~= nil and rounded or raw)
end

--------------------------------------------------------------------------------
-- Rendering helpers
--------------------------------------------------------------------------------

local function theme_var(hero_key, name)
local hero_theme = theme_data[hero_key]
if hero_theme and hero_theme[name] ~= nil then return hero_theme[name] end
return theme_data['hero_default'][name]
end

local function label_of(row)
if row.label_text then return row.label_text end
if row.label_dict then return dict_module.translate(row.label_dict) end
return lang_module.get_string(row.label)
end

-- 'Damage Resistance#Spirit_Resist' -> 'Damage Resistance/ru#Spirit_Resist'
local function page_link(ctx, target)
if not target then return '' end
local page, anchor = target:match('^([^#]*)(#?.*)$')
return page .. ctx.if_lang .. anchor
end

local function icon_cell(ctx, row, color, value_html)
local icon = ''
if row.icon then
icon = string.format('[[File:%s|20px|link=%s]]', row.icon,
page_link(ctx, row.icon_link or row.link))
end
return ctx.frame:expandTemplate{ title = 'Icon/' .. color, args = { icon, value_html } }
end

-- Ammo and reload time are meaningless for heroes whose weapon never reloads.
local NO_AMMO_STATS = { ClipSize = true, ReloadTime = true }

-- Returns true when the row rendered.
local function render_stat_row(ctx, tbl, row, color, is_first)
if row.show and not row.show(ctx) then return false end
if row.optional and not has_override_or_stat(ctx, row.param, row.stat) then return false end

local value, scaling_inner
if NO_AMMO_STATS[row.stat] and ctx.args.no_ammo == 'true' then
value, scaling_inner = 'N/A', ''
else
local override = row.param and ctx.args[row.param] or ''
if override ~= '' then
value = override
else
value = format_value(get_stat(ctx.hero, row.stat), row.sig_figs)
end
value = value .. (row.suffix or '')

if row.stat and row.scaling ~= false then
local parts = {}
for _, scaling in ipairs(get_scaling(ctx.hero, row.stat)) do
parts[#parts + 1] = hero_module.write_scalar_str(scaling.value, scaling.type)
end
scaling_inner = table.concat(parts)
value = value .. '' .. scaling_inner .. ''
else
scaling_inner = ''
end
end

local tr = tbl:tag('tr')

local label_cell = tr:tag('td')
-- The section's first row needs extra headroom when it carries a scaling icon.
if is_first and scaling_inner ~= '' then
label_cell:addClass('infobox-h-stat-label-scaled')
end
if row.link then
label_cell:wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label_of(row)))
else
label_cell:wikitext(label_of(row) .. ':')
end

local value_cell = tr:tag('td')
if row.cell_class then value_cell:addClass(row.cell_class) end
value_cell:wikitext(icon_cell(ctx, row, color, value))

return true
end

local function render_section(ctx, parent, section)
local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection infobox-h-dropdown ' .. section.class)
:tag('table'):addClass('mw-collapsible infobox-h-subsection-child')

local caption = tbl:tag('caption'):addClass('infobox-h-dropdown-header')
if ctx.if_lang == '/ru' then
caption:addClass('infobox-h-dropdown-header-overflow')
end
caption:wikitext(string.format(
'[[%s|%s]]',
page_link(ctx, section.link), lang_module.get_string(section.header)))

local is_first = true
for _, row in ipairs(section.rows) do
if render_stat_row(ctx, tbl, row, section.color, is_first) then
is_first = false
end
end
end

local function render_information(ctx, parent)
local present = {}
for _, row in ipairs(INFO_ROWS) do
if ctx.args[row.param] ~= '' then present[#present + 1] = row end
end
if #present == 0 then return end

parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-text-stat-subtitle')
:wikitext(''
.. dict_module.translate('Information') .. '')

local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection')
:tag('table'):addClass('infobox-h-subsection-child')

for _, row in ipairs(present) do
local tr = tbl:tag('tr')
local label = dict_module.translate(row.label_dict)
local label_cell = tr:tag('td')
if row.tooltip then
label_cell:attr('title', row.tooltip)
end
if row.link then
label_cell:wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label))
else
label_cell:wikitext(label .. ':')
end
tr:tag('td'):wikitext(ctx.args[row.param])
end
end

local function render_title(ctx, parent)
local th = parent:tag('tr'):tag('th'):attr('colspan', '2'):addClass('infobox-h-title')
if ctx.args.name_font_size ~= '' then
th:cssText('font-size: ' .. ctx.args.name_font_size .. ';')
end

local wrap = th:tag('div'):addClass('infobox-h-title-hero')
wrap:tag('div'):addClass('infobox-h-title-hero-left')

-- Name logo: <Name>_name.svg, or <Name>_name_<lang>.svg on translated pages.
-- Heroes without a logo fall back to their name as plain text.
local svg = ((ctx.args.name ~= '' and ctx.args.name) or ctx.hero_en) .. '_name'
if ctx.if_lang ~= '' then svg = svg .. '_' .. ctx.lang_code end

local middle = wrap:tag('div'):addClass('infobox-h-title-hero-middle')
if util.page_exists('File:' .. svg .. '.svg') then
middle:wikitext(ctx.frame:expandTemplate{ title = 'Icon/White', args = {
string.format('[[File:%s.svg|%s|class=notpageimage]]',
svg, theme_var(ctx.hero_key, 'logo-height')) } })
else
middle:wikitext(ctx.display_name)
end

local right = wrap:tag('div'):addClass('infobox-h-title-hero-right'):tag('div')
if ctx.show_icon then
local icon = ((ctx.args.icon ~= '' and ctx.args.icon) or ctx.hero_en) .. '.png'
if util.page_exists('File:' .. icon) then
right:tag('div'):addClass('infobox-h-title-hero-tornbox')
right:tag('div'):addClass('infobox-h-title-hero-icon')
:wikitext(string.format('[[File:%s|center|35px|class=notpageimage]]', icon))
end
end
end

local function render_card(ctx, parent)
local card = (ctx.args.card ~= '' and ctx.args.card) or (ctx.hero_en .. ' card.png')
if not util.page_exists('File:' .. card) then card = FALLBACK_CARD end
parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-image')
:tag('div')
:wikitext(string.format('[[File:%s|150px|alt=%s]]',
card, mw.title.getCurrentTitle().baseText))
end

local function render_tags(ctx, parent)
if not ctx.show_hero_tags then return end

local tags = {}
for i = 1, 3 do
local tag = hero_module.get_hero_tag({ args = { ctx.hero_en, tostring(i) } })
if tag and tag ~= '' and not tag:find('Error:', 1, true) then
tags[#tags + 1] = tag
end
end
if #tags == 0 then return end

local inner = parent:tag('tr'):tag('td')
:attr('colspan', '2')
:addClass('infobox-h-herotags-row')
:tag('div'):addClass('infobox-h-herotags-inner ' .. ctx.hero_key)
for _, tag in ipairs(tags) do
inner:tag('div'):addClass('infobox-h-herotag-pill'):wikitext(tag)
end
end

local function render_categories(ctx)
if mw.ustring.lower(ctx.args.nocat ~= '' and ctx.args.nocat or 'false') ~= 'false' then
return ''
end
if get_stat(ctx.hero, 'IsDisabled') ~= false then return '' end

local out = {}
for _, category in ipairs(CATEGORIES) do
if category.when == nil or category.when(ctx) then
local name = category.name
if type(name) == 'function' then name = name(ctx) end
out[#out + 1] = ctx.frame:expandTemplate{ title = 'lang cat', args = { name } }
end
end
return table.concat(out)
end

--------------------------------------------------------------------------------
-- Entry point
--------------------------------------------------------------------------------

-- |key= accepts a hero_* key or the hero's English name; unknown values fall back
-- to the target dummy, the default character in Sandbox mode.
local function resolve_hero_key(provided)
if provided == nil or provided == '' then return DEFAULT_HERO_KEY end
if hero_data_all[provided] ~= nil then return provided end
local wanted = mw.ustring.lower(provided)
for key, hero in pairs(hero_data_all) do
if hero.Name and mw.ustring.lower(hero.Name) == wanted then return key end
end
return DEFAULT_HERO_KEY
end

function p.render(frame)
local parent = frame:getParent()
local invoke_args = frame.args
local template_args = parent and parent.args or {}

-- Missing parameters read as '' so callers never have to nil-check.
local args = setmetatable({}, { __index = function(_, k)
local value = invoke_args[k]
if value == nil then value = template_args[k] end
return value or ''
end })

local hero_key = resolve_hero_key(args.key)
local hero = hero_data_all[hero_key]

local ctx = {
frame = frame,
args = args,
hero = hero,
hero_key = hero_key,
hero_en = hero.Name,
lang_code = lang_module.get_lang_code(),
if_lang = frame:expandTemplate{ title = 'If lang' },
}
ctx.display_name = (args.name ~= '' and args.name) or lang_module.get_string(hero_key)

ctx.show_hero_tags = args.show_hero_tags ~= 'false'
ctx.show_icon = args.show_icon ~= 'false'

-- Needed by both row visibility and the category rules.
ctx.pellets = stat_number(ctx, 'BulletsPerShot', 'pellets_per_shot')
ctx.burst = stat_number(ctx, 'BulletsPerBurst', 'bullets_per_burst')
ctx.dash = stat_number(ctx, 'GroundDashSpeed')
ctx.stamina = (args.stamina ~= '' and args.stamina)
or format_value(get_stat(hero, 'Stamina'), 2)

local root = mw.html.create('div'):addClass('infobox-h ' .. hero_key)
root:tag('div'):addClass('infobox-h-background')
:wikitext(string.format('[[File:%s|%s|right|link=|class=notpageimage]]',
theme_var(hero_key, 'bg-image'), theme_var(hero_key, 'bg-height')))

local tbl = root:tag('table'):addClass('infobox-h-content')
render_title(ctx, tbl)
render_card(ctx, tbl)
render_tags(ctx, tbl)
for _, section in ipairs(SECTIONS) do
render_section(ctx, tbl, section)
end
render_information(ctx, tbl)

if mw.title.getCurrentTitle().nsText ~= 'Template' then
frame:callParserFunction('DISPLAYTITLE', ctx.display_name)
end
return tostring(root) .. render_categories(ctx)
end

return p

Module:InfoboxHero

2026-07-16T19:45:55Z

~2026-GlassGreenKinetic677: add tooltips (the fancy template style)

--------------------------------------------------------------------------------
-- Module:InfoboxHero
--
-- Renders the hero infobox. Called from [[Template:Infobox hero]], which passes
-- the editor's parameters through as the parent frame:
--
-- {{#invoke:InfoboxHero|render}}
--
-- May also be invoked directly for testing, in which case parameters are read
-- from the invoke itself:
--
-- {{#invoke:InfoboxHero|render|key=hero_atlas}}
--
-- Stat data comes from [[Data:HeroData.json]]; per-hero colors, backgrounds and
-- logo sizes from [[Data:Infobox hero.json]]; labels from [[Module:Lang]] and
-- [[Module:Dictionary]]. Styling lives in [[Template:Infobox hero/styles.css]]
-- and [[Template:Infobox hero/themes.css]].
--
--------------------------------------------------------------------------------

local p = {}

local hero_data_all = mw.loadJsonData('Data:HeroData.json')
local theme_data = mw.loadJsonData('Data:Infobox_hero.json')

local util = require('Module:Utilities')
local lang_module = require('Module:Lang')
local dict_module = require('Module:Dictionary')
local hero_module = require('Module:HeroData')

local get_stat, has_stat, has_override_or_stat, stat_number

--------------------------------------------------------------------------------
-- CONFIG
--------------------------------------------------------------------------------

local DEFAULT_HERO_KEY = 'hero_targetdummy' -- used when |key= is missing/unknown
local DEFAULT_SIG_FIGS = 3
local FALLBACK_CARD = 'Dummy card.png'

-- Row fields (all optional except a label):
-- stat Key in Data:HeroData.json. Resolved top-level, then .Weapon,
-- then .Weapon.AltFire. Omit for manual-input-only rows.
-- param |param= that overrides the value.
-- label Key in Data:Lang_<code>.json.
-- label_dict Key in Data:Dictionary. Used instead of `label`.
-- label_text Literal, untranslated label. Used instead of `label`.
-- link Target for the label, as 'Page' or 'Page#Anchor'. The language
-- suffix is inserted for us, so write the plain English title.
-- icon_link Target for the icon. Defaults to `link`.
-- icon File: name of the value icon. Omit for no icon.
-- sig_figs Significant figures. Defaults to 3.
-- suffix Appended directly after the value, e.g. '%', 's', 'm/s'.
-- scaling Set false to suppress the Boon/Spirit scaling span. Scaling is
-- shown by default wherever the data provides it.
-- optional Hide the row unless the hero has a non-zero value or scaling.
-- cell_class Extra class on the value cell.
-- show function(ctx) -> boolean. Row omitted when false.

local SECTIONS = {
{
class = 'infobox-h-dropdown-weapon',
header = 'CitadelHeroStats_Weapon',
link = 'Stats#Weapon',
color = 'Brown',
rows = {
{
stat = 'DPS',
param = 'dps',
label = 'DPS_label',
link = 'Damage per second',
icon = 'Damage.png',
-- DPS is derived from bullet damage and fire rate, both of which
-- show their own scaling; repeating it here would double-count.
scaling = false,
},
{
stat = 'BulletDamage',
param = 'bullet_damage',
label = 'StatDesc_BulletDamage',
link = 'Bullet Damage',
icon = 'Bullet damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'BulletsPerShot',
param = 'pellets_per_shot',
label = 'BonusPelletsPerShot_label',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.pellets > 1 end,
},
{
stat = 'BulletsPerBurst',
param = 'bullets_per_burst',
label_dict = 'BulletsPerBurst',
link = 'Damage per second',
icon = 'Bullets per sec icon.png',
icon_link = 'Fire Rate',
show = function(ctx) return ctx.burst > 1 end,
},
{
stat = 'ClipSize',
param = 'ammo',
label = 'StatDesc_ClipSizeBonus',
link = 'Ammo',
icon = 'Clip size icon.png',
},
{
stat = 'RoundsPerSecond',
param = 'bullets_per_sec',
label = 'StatDesc_RoundsPerSecond',
link = 'Fire Rate',
icon = 'Bullets per sec icon.png',
},
{
stat = 'ReloadTime',
param = 'reload_time',
label = 'StatDesc_ReloadTime',
link = 'Reload Time',
icon = 'AttributeIconReloadTime.png',
suffix = 's',
},
{
stat = 'BulletSpeed',
param = 'bullet_velocity',
label = 'StatDesc_BulletSpeed',
link = 'Bullet Velocity',
icon = 'AttributeIconBulletSpeed.png',
suffix = 'm/s',
},
{
stat = 'LightMeleeDamage',
param = 'light_melee',
label = 'StatDesc_LightMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
stat = 'HeavyMeleeDamage',
param = 'heavy_melee',
label = 'StatDesc_HeavyMeleeDamage',
link = 'Melee Damage',
icon = 'Melee damage.png',
cell_class = 'infobox-h-stat-value-padded',
},
{
param = 'max_range',
label_text = 'Max Range',
link = 'Falloff Range',
show = function(ctx) return ctx.args.max_range ~= '' end,
},
{
stat = 'CritDamageBonusPercent',
label = 'StatDesc_CritDamageBonusScale',
link = 'Weapon Damage#Crit_Multiplier',
icon = 'Crit reduction.png',
suffix = '%',
show = function(ctx)
return stat_number(ctx, 'CritDamageBonusPercent') ~= 0
end,
},
},
},
{
class = 'infobox-h-dropdown-vitality',
header = 'CitadelHeroStats_Vitality',
link = 'Stats#Vitality',
color = 'Green',
rows = {
{
stat = 'MaxHealth',
param = 'max_health',
label = 'StatDesc_HealthAttribute',
link = 'Health',
icon = 'Health.png',
},
{
stat = 'BaseHealthRegen',
param = 'health_regen',
label = 'StatDesc_HealthRegen',
link = 'Health Regen',
icon = 'Health regen.png',
sig_figs = 2,
},
{
stat = 'CritDamageReceivedPercent',
param = 'crit_reduction',
label = 'StatDesc_CritDamageReceivedScale',
link = 'Damage Resistance#Crit_Reduction',
icon = 'Crit reduction.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletResist',
param = 'bullet_resist',
label = 'StatDesc_BulletArmorDamageReduction',
link = 'Damage Resistance',
icon = 'Bullet Armor.png',
icon_link = 'Bullet Resist',
suffix = '%',
optional = true,
},
{
stat = 'TechResist',
param = 'spirit_resist',
label = 'StatDesc_TechArmorDamageReduction',
link = 'Damage Resistance#Spirit_Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'MeleeResist',
param = 'melee_resist',
label = 'StatDesc_MeleeResist',
link = 'Damage Resistance#Melee Resist',
icon = 'Melee damage.png',
suffix = '%',
optional = true,
},
{
stat = 'DebuffResist',
param = 'debuff_resist',
label = 'StatDesc_DebuffResist',
link = 'Debuff Resist',
icon = 'Spirit Armor.png',
suffix = '%',
optional = true,
},
{
stat = 'BulletLifesteal',
param = 'bullet_lifesteal',
label = 'StatDesc_BulletLifesteal',
link = 'Lifesteal#Bullet Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'SpiritLifesteal',
param = 'spirit_lifesteal',
label = 'StatDesc_SpiritLifesteal',
link = 'Lifesteal#Spirit Lifesteal',
icon = 'AttributeIconBulletLifesteal.png',
suffix = '%',
optional = true,
},
{
stat = 'MaxMoveSpeed',
param = 'move_speed',
label = 'StatDesc_RunSpeed',
link = 'Move Speed',
icon = 'Move speed.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'SprintSpeed',
param = 'sprint_speed',
label = 'StatDesc_SprintSpeed',
link = 'Move Speed#Sprint',
icon = 'Move speed sprint.png',
sig_figs = 2,
suffix = 'm/s',
},
{
stat = 'GroundDashSpeed',
label = 'DashSpeed_label',
link = 'Stamina#Dash_Speed',
icon = 'Springy boots icon.png',
suffix = 'm/s',
},
{
stat = 'Stamina',
param = 'stamina',
label = 'StatDesc_Stamina',
link = 'Stamina',
icon = 'Springy boots icon.png',
sig_figs = 2,
},
{
stat = 'StaminaCooldown',
param = 'stamina_cooldown',
label = 'StatDesc_StaminaCooldown',
link = 'Stamina#Cooldown',
icon = 'AttributeIconTechDuration.png',
sig_figs = 2,
suffix = 's',
},
},
},
{
class = 'infobox-h-dropdown-spirit',
header = 'CitadelHeroStats_Spirit',
link = 'Stats#Spirit',
color = 'Purple',
rows = {
{
stat = 'TechPower',
param = 'spirit_power',
label = 'SpiritPower_label',
link = 'Spirit Power',
icon = 'Spirit icon noborder.png',
sig_figs = 2,
},
},
},
}

-- The "Information" block. Manual input only; hidden entirely when all are empty.
local INFO_ROWS = {
{ param = 'release_date', label_dict = 'ReleaseDate', link = 'Heroes by release' },
{ param = 'pronouns', label_dict = 'Pronouns' },
{ param = 'voice_actor', label_dict = 'VoiceActor' },
{ param = 'codenames', label_dict = 'Codenames', tooltip = 'Codenames used for this hero in the game files' },
}

-- name: literal, or function(ctx) -> string. when: function(ctx) -> boolean.
local CATEGORIES = {
{ name = 'Heroes' },
{
name = function(ctx) return ctx.hero_en end,
-- Silver (Transformed) is documented on Silver's page and shares her category.
when = function(ctx) return ctx.hero_en ~= 'Silver (Transformed)' end,
},
{
name = 'Heroes with spreadshot weapons',
when = function(ctx) return ctx.pellets > 1 end,
},
{
name = 'Heroes with single damage spreadshot weapons',
when = function(ctx)
return ctx.pellets > 1 and get_stat(ctx.hero, 'HitOnceAcrossAllBullets') == true
end,
},
{
name = 'Heroes with burst weapons',
when = function(ctx) return ctx.burst > 1 end,
},
{
name = 'Heroes with automatic weapons',
when = function(ctx) return ctx.pellets <= 1 and ctx.burst <= 1 end,
},
{
name = 'Heroes with alternate fire weapons',
when = function(ctx)
return ctx.hero.Weapon ~= nil and ctx.hero.Weapon.AltFire ~= nil
end,
},
{
name = 'Heroes with single reload weapons',
when = function(ctx) return get_stat(ctx.hero, 'ReloadSingle') == true end,
},
{
name = 'Heroes with spin up weapons',
when = function(ctx) return has_stat(ctx.hero, 'SpinAcceleration') end,
},
{
name = 'Heroes with no weapon damage falloff',
when = function(ctx)
return (get_stat(ctx.hero, 'FalloffStartRange') or 0)
== (get_stat(ctx.hero, 'FalloffEndRange') or 0)
end,
},
{
name = "Heroes that don't deal critical damage",
when = function(ctx) return get_stat(ctx.hero, 'CanCrit') == false end,
},
{
name = 'Heroes with modified crit scale',
when = function(ctx) return stat_number(ctx, 'CritDamageBonusPercent') ~= 0 end,
},
{
name = 'Heroes with modified crit resistance',
when = function(ctx)
return has_override_or_stat(ctx, 'crit_reduction', 'CritDamageReceivedPercent')
end,
},
{
name = 'Heroes with modified bullet resist',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_resist', 'BulletResist')
end,
},
{
name = 'Heroes with modified spirit resist',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_resist', 'TechResist')
end,
},
{
name = 'Heroes with modified melee resist',
when = function(ctx)
return has_override_or_stat(ctx, 'melee_resist', 'MeleeResist')
end,
},
{
name = 'Heroes with modified debuff resist',
when = function(ctx)
return has_override_or_stat(ctx, 'debuff_resist', 'DebuffResist')
end,
},
{
name = 'Heroes with modified bullet lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'bullet_lifesteal', 'BulletLifesteal')
end,
},
{
name = 'Heroes with modified spirit lifesteal',
when = function(ctx)
return has_override_or_stat(ctx, 'spirit_lifesteal', 'SpiritLifesteal')
end,
},
{
name = 'Heroes with modified gravity scale',
when = function(ctx) return has_stat(ctx.hero, 'GravityChange') end,
},
{
name = function(ctx) return 'Heroes with ' .. ctx.stamina .. ' stamina' end,
when = function(ctx) return ctx.stamina ~= '' end,
},
{
name = function(ctx)
if ctx.dash < 14.7 then return 'Heroes with slow dash speed' end
if ctx.dash > 14.7 then return 'Heroes with fast dash speed' end
return 'Heroes with medium dash speed'
end,
},
}

--------------------------------------------------------------------------------
-- Data access
--------------------------------------------------------------------------------

-- Stats live at the top level for vitality, and under .Weapon for weapon stats.
get_stat = function(hero, stat)
if hero == nil or stat == nil then return nil end
local value = hero[stat]
if value == nil and hero.Weapon then
value = hero.Weapon[stat]
if value == nil and hero.Weapon.AltFire then
value = hero.Weapon.AltFire[stat]
end
end
return value
end

-- The raw Boon (Level) and Spirit scaling values for a stat, if any.
local function get_scaling(hero, stat)
local out = {}
for _, scaling_type in ipairs({ 'Level', 'Spirit' }) do
local scaling = hero[scaling_type .. 'Scaling']
local value = scaling and stat and scaling[stat]
if value ~= nil and value ~= 0 then
out[#out + 1] = { type = scaling_type, value = value }
end
end
return out
end

-- True when the hero has a non-zero base value, or any scaling, for a stat.
has_stat = function(hero, stat)
local value = get_stat(hero, stat)
if value ~= nil and value ~= 0 then return true end
return #get_scaling(hero, stat) > 0
end

has_override_or_stat = function(ctx, param, stat)
if param and ctx.args[param] ~= '' then return true end
return has_stat(ctx.hero, stat)
end

-- Rounded numeric value of a stat, honouring a |param= override.
stat_number = function(ctx, stat, param)
if param and ctx.args[param] ~= '' then return tonumber(ctx.args[param]) or 0 end
return tonumber(util.round_to_sig_fig(get_stat(ctx.hero, stat) or 0, DEFAULT_SIG_FIGS)) or 0
end

local function format_value(raw, sig_figs)
if raw == nil then return '0' end
local rounded = util.round_to_sig_fig(raw, sig_figs or DEFAULT_SIG_FIGS)
return tostring(rounded ~= nil and rounded or raw)
end

--------------------------------------------------------------------------------
-- Rendering helpers
--------------------------------------------------------------------------------

local function theme_var(hero_key, name)
local hero_theme = theme_data[hero_key]
if hero_theme and hero_theme[name] ~= nil then return hero_theme[name] end
return theme_data['hero_default'][name]
end

local function label_of(row)
if row.label_text then return row.label_text end
if row.label_dict then return dict_module.translate(row.label_dict) end
return lang_module.get_string(row.label)
end

-- 'Damage Resistance#Spirit_Resist' -> 'Damage Resistance/ru#Spirit_Resist'
local function page_link(ctx, target)
if not target then return '' end
local page, anchor = target:match('^([^#]*)(#?.*)$')
return page .. ctx.if_lang .. anchor
end

local function icon_cell(ctx, row, color, value_html)
local icon = ''
if row.icon then
icon = string.format('[[File:%s|20px|link=%s]]', row.icon,
page_link(ctx, row.icon_link or row.link))
end
return ctx.frame:expandTemplate{ title = 'Icon/' .. color, args = { icon, value_html } }
end

-- Ammo and reload time are meaningless for heroes whose weapon never reloads.
local NO_AMMO_STATS = { ClipSize = true, ReloadTime = true }

-- Returns true when the row rendered.
local function render_stat_row(ctx, tbl, row, color, is_first)
if row.show and not row.show(ctx) then return false end
if row.optional and not has_override_or_stat(ctx, row.param, row.stat) then return false end

local value, scaling_inner
if NO_AMMO_STATS[row.stat] and ctx.args.no_ammo == 'true' then
value, scaling_inner = 'N/A', ''
else
local override = row.param and ctx.args[row.param] or ''
if override ~= '' then
value = override
else
value = format_value(get_stat(ctx.hero, row.stat), row.sig_figs)
end
value = value .. (row.suffix or '')

if row.stat and row.scaling ~= false then
local parts = {}
for _, scaling in ipairs(get_scaling(ctx.hero, row.stat)) do
parts[#parts + 1] = hero_module.write_scalar_str(scaling.value, scaling.type)
end
scaling_inner = table.concat(parts)
value = value .. '' .. scaling_inner .. ''
else
scaling_inner = ''
end
end

local tr = tbl:tag('tr')

local label_cell = tr:tag('td')
-- The section's first row needs extra headroom when it carries a scaling icon.
if is_first and scaling_inner ~= '' then
label_cell:addClass('infobox-h-stat-label-scaled')
end
if row.link then
label_cell:wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label_of(row)))
else
label_cell:wikitext(label_of(row) .. ':')
end

local value_cell = tr:tag('td')
if row.cell_class then value_cell:addClass(row.cell_class) end
value_cell:wikitext(icon_cell(ctx, row, color, value))

return true
end

local function render_section(ctx, parent, section)
local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection infobox-h-dropdown ' .. section.class)
:tag('table'):addClass('mw-collapsible infobox-h-subsection-child')

local caption = tbl:tag('caption'):addClass('infobox-h-dropdown-header')
if ctx.if_lang == '/ru' then
caption:addClass('infobox-h-dropdown-header-overflow')
end
caption:wikitext(string.format(
'[[%s|%s]]',
page_link(ctx, section.link), lang_module.get_string(section.header)))

local is_first = true
for _, row in ipairs(section.rows) do
if render_stat_row(ctx, tbl, row, section.color, is_first) then
is_first = false
end
end
end

local function render_information(ctx, parent)
local present = {}
for _, row in ipairs(INFO_ROWS) do
if ctx.args[row.param] ~= '' then present[#present + 1] = row end
end
if #present == 0 then return end

parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-text-stat-subtitle')
:wikitext(''
.. dict_module.translate('Information') .. '')

local tbl = parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-subsection')
:tag('table'):addClass('infobox-h-subsection-child')

for _, row in ipairs(present) do
local tr = tbl:tag('tr')
local label = dict_module.translate(row.label_dict)
if row.tooltip then
label = ctx.frame:expandTemplate{ title = 'Tooltip', args = { label, row.tooltip } }
end
if row.link then
tr:tag('td'):wikitext(string.format('[[%s|%s]]:',
page_link(ctx, row.link), label))
else
tr:tag('td'):wikitext(label .. ':')
end
tr:tag('td'):wikitext(ctx.args[row.param])
end
end

local function render_title(ctx, parent)
local th = parent:tag('tr'):tag('th'):attr('colspan', '2'):addClass('infobox-h-title')
if ctx.args.name_font_size ~= '' then
th:cssText('font-size: ' .. ctx.args.name_font_size .. ';')
end

local wrap = th:tag('div'):addClass('infobox-h-title-hero')
wrap:tag('div'):addClass('infobox-h-title-hero-left')

-- Name logo: <Name>_name.svg, or <Name>_name_<lang>.svg on translated pages.
-- Heroes without a logo fall back to their name as plain text.
local svg = ((ctx.args.name ~= '' and ctx.args.name) or ctx.hero_en) .. '_name'
if ctx.if_lang ~= '' then svg = svg .. '_' .. ctx.lang_code end

local middle = wrap:tag('div'):addClass('infobox-h-title-hero-middle')
if util.page_exists('File:' .. svg .. '.svg') then
middle:wikitext(ctx.frame:expandTemplate{ title = 'Icon/White', args = {
string.format('[[File:%s.svg|%s|class=notpageimage]]',
svg, theme_var(ctx.hero_key, 'logo-height')) } })
else
middle:wikitext(ctx.display_name)
end

local right = wrap:tag('div'):addClass('infobox-h-title-hero-right'):tag('div')
if ctx.show_icon then
local icon = ((ctx.args.icon ~= '' and ctx.args.icon) or ctx.hero_en) .. '.png'
if util.page_exists('File:' .. icon) then
right:tag('div'):addClass('infobox-h-title-hero-tornbox')
right:tag('div'):addClass('infobox-h-title-hero-icon')
:wikitext(string.format('[[File:%s|center|35px|class=notpageimage]]', icon))
end
end
end

local function render_card(ctx, parent)
local card = (ctx.args.card ~= '' and ctx.args.card) or (ctx.hero_en .. ' card.png')
if not util.page_exists('File:' .. card) then card = FALLBACK_CARD end
parent:tag('tr'):tag('th')
:attr('colspan', '2')
:addClass('infobox-h-image')
:tag('div')
:wikitext(string.format('[[File:%s|150px|alt=%s]]',
card, mw.title.getCurrentTitle().baseText))
end

local function render_tags(ctx, parent)
if not ctx.show_hero_tags then return end

local tags = {}
for i = 1, 3 do
local tag = hero_module.get_hero_tag({ args = { ctx.hero_en, tostring(i) } })
if tag and tag ~= '' and not tag:find('Error:', 1, true) then
tags[#tags + 1] = tag
end
end
if #tags == 0 then return end

local inner = parent:tag('tr'):tag('td')
:attr('colspan', '2')
:addClass('infobox-h-herotags-row')
:tag('div'):addClass('infobox-h-herotags-inner ' .. ctx.hero_key)
for _, tag in ipairs(tags) do
inner:tag('div'):addClass('infobox-h-herotag-pill'):wikitext(tag)
end
end

local function render_categories(ctx)
if mw.ustring.lower(ctx.args.nocat ~= '' and ctx.args.nocat or 'false') ~= 'false' then
return ''
end
if get_stat(ctx.hero, 'IsDisabled') ~= false then return '' end

local out = {}
for _, category in ipairs(CATEGORIES) do
if category.when == nil or category.when(ctx) then
local name = category.name
if type(name) == 'function' then name = name(ctx) end
out[#out + 1] = ctx.frame:expandTemplate{ title = 'lang cat', args = { name } }
end
end
return table.concat(out)
end

--------------------------------------------------------------------------------
-- Entry point
--------------------------------------------------------------------------------

-- |key= accepts a hero_* key or the hero's English name; unknown values fall back
-- to the target dummy, the default character in Sandbox mode.
local function resolve_hero_key(provided)
if provided == nil or provided == '' then return DEFAULT_HERO_KEY end
if hero_data_all[provided] ~= nil then return provided end
local wanted = mw.ustring.lower(provided)
for key, hero in pairs(hero_data_all) do
if hero.Name and mw.ustring.lower(hero.Name) == wanted then return key end
end
return DEFAULT_HERO_KEY
end

function p.render(frame)
local parent = frame:getParent()
local invoke_args = frame.args
local template_args = parent and parent.args or {}

-- Missing parameters read as '' so callers never have to nil-check.
local args = setmetatable({}, { __index = function(_, k)
local value = invoke_args[k]
if value == nil then value = template_args[k] end
return value or ''
end })

local hero_key = resolve_hero_key(args.key)
local hero = hero_data_all[hero_key]

local ctx = {
frame = frame,
args = args,
hero = hero,
hero_key = hero_key,
hero_en = hero.Name,
lang_code = lang_module.get_lang_code(),
if_lang = frame:expandTemplate{ title = 'If lang' },
}
ctx.display_name = (args.name ~= '' and args.name) or lang_module.get_string(hero_key)

ctx.show_hero_tags = args.show_hero_tags ~= 'false'
ctx.show_icon = args.show_icon ~= 'false'

-- Needed by both row visibility and the category rules.
ctx.pellets = stat_number(ctx, 'BulletsPerShot', 'pellets_per_shot')
ctx.burst = stat_number(ctx, 'BulletsPerBurst', 'bullets_per_burst')
ctx.dash = stat_number(ctx, 'GroundDashSpeed')
ctx.stamina = (args.stamina ~= '' and args.stamina)
or format_value(get_stat(hero, 'Stamina'), 2)

local root = mw.html.create('div'):addClass('infobox-h ' .. hero_key)
root:tag('div'):addClass('infobox-h-background')
:wikitext(string.format('[[File:%s|%s|right|link=|class=notpageimage]]',
theme_var(hero_key, 'bg-image'), theme_var(hero_key, 'bg-height')))

local tbl = root:tag('table'):addClass('infobox-h-content')
render_title(ctx, tbl)
render_card(ctx, tbl)
render_tags(ctx, tbl)
for _, section in ipairs(SECTIONS) do
render_section(ctx, tbl, section)
end
render_information(ctx, tbl)

if mw.title.getCurrentTitle().nsText ~= 'Template' then
frame:callParserFunction('DISPLAYTITLE', ctx.display_name)
end
return tostring(root) .. render_categories(ctx)
end

return p

User:LVL/Sandbox2

2026-07-16T19:24:22Z

~2026-GlassGreenKinetic677: move headings around for better page structure

'''Damage Amplification''' or '''Damage Amp''' is a stat that multiplies the damage caused by the player to affected enemies and NPCs. It can be both positive and negative. In latter case it reduces damage and is also known as '''Damage Reduction'''.

{{#ev:youtube|apzBQPZyW_w|360|description=Video explaining Damage Amplification}}

== Damage Amplification ==

=== Sources of Damage Amplification ===

==== Additive Amplifiers ====

{| class="wikitable sortable"
|+List of heroes
!Hero
!Ability
!Tier
!Stat change
|-
| rowspan="1" |{{HeroIcon|Calico}}
| rowspan="1" |{{AbilityIcon|Ava}}
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Ava|3|OutgoingDamagePercent}}%''' Ramping Damage Amp
|-
|{{HeroIcon|Ivy}}
|{{AbilityIcon|Air Drop}}
|0
|'''+20%''' Damage Amp on Ivy and carried ally
|-
| rowspan="2" |{{HeroIcon|Shiv}}
| rowspan="2" |{{AbilityIcon|Killing Blow}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Killing Blow|BuffDamage}}%''' Damage Amp
|-
|2
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Killing Blow|2|BuffDamage}}%''' Damage Amp
|}

==== Multiplicative Amplifiers ====

{| class="wikitable sortable"
|+List of heroes
!Hero
!Ability
!Tier
!Stat change
|-
| rowspan="2" |{{HeroIcon|Infernus}}
| rowspan="2" |{{AbilityIcon|Napalm}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Napalm|IncomingDamagePercentFromCaster}}%''' Damage Amp
|-
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Napalm|3|IncomingDamagePercentFromCaster}}%''' Damage Amp
|-
|{{HeroIcon|McGinnis}}
|{{AbilityIcon|Spectral Wall}}
|1
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Spectral Wall|1|BonusDamagePercent}}%''' Damage Amp
|-
|{{HeroIcon|Mo & Krill}}
|{{AbilityIcon|Scorn}}
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Scorn|3|DamageBonus}}%''' Damage Amp per Stack
|-
|{{HeroIcon|Bebop}}
|{{AbilityIcon|Hook}}
|1
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Grapple Arm|1|BulletAmp}}%''' Weapon Damage Amp against hooked targets
|-
| All Heroes
| [[Parry]]
| 0
| '''+25%''' Damage Amp (Parried target takes 25% increased damage from all sources)
|}

==== Instance Amplifiers ====

{| class="wikitable sortable"
|+List of heroes and items
!Hero / Item
!Ability
!Tier
!Stat change
|-
| rowspan="2" |{{HeroIcon|Drifter}}
| rowspan="2" |{{AbilityIcon|Bloodscent}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Bloodscent|AmpDamagePercent}}%''' Damage Amp on Isolated Heroes
|-
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Bloodscent|3|AmpDamagePercent}}%''' Damage Amp on Isolated Heroes
|-
| rowspan="2" |{{HeroIcon|Lady Geist}}
| rowspan="2" |{{AbilityIcon|Malice}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Malice|VulnerabilityPerStack}}%''' Damage Amp per Stack
|-
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Malice|3|VulnerabilityPerStack}}%''' Damage Amp per Stack
|-
|{{HeroIcon|Paradox}}
|{{AbilityIcon|Pulse Grenade}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Pulse Grenade|DamageAmplificationPerStack}}%''' Damage Amp per Stack
|-
| rowspan="2" |{{HeroIcon|Pocket}}
| rowspan="2" |{{AbilityIcon|Barrage}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|Barrage|AmpPercentPerStack}}%''' Damage Amp per Stack
|-
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|Barrage|3|AmpPercentPerStack}}%''' Damage Amp per Stack
|-
| rowspan="2" |{{HeroIcon|Sinclair}}
| rowspan="2" |{{AbilityIcon|Rabbit Hex}}
|0
|'''+{{#invoke:Abilities|get_ability_prop|ability_magician_animalhexarea|DamageAmpPercentage}}%''' Damage Amp
|-
|3
|'''+{{#invoke:Abilities|get_ability_upgrade_prop|ability_magician_animalhexarea|3|DamageAmpPercentage}}%''' Damage Amp
|-
|{{ItemIcon|Escalating Exposure}}
| -
| -
| '''+{{ItemData|Escalating Exposure|MagicIncreasePerStack}}''' Damage Amp per Stack
|}

== Damage Reduction ==

'''Damage Reduction''' is a negative form of Damage Amplification, reducing the damage output of enemies or its user. Mechanically, standard Damage Reductions are treated as negative '''Additive Amps''' (see Calculation section).

=== Damage Reduction Stacking ===

Valve's May 22 patch notes state that Damage Reduction debuffs are intended to stack diminishingly (i.e., multiplicatively, in the same manner as Resistance)<ref>{{Update link|May|22|2026}}</ref>.

However, live testing confirms that standard Damage Reduction debuffs have not been fully migrated to this new system. Currently, Damage Reductions (such as {{ItemIcon|Inhibitor}} or {{AbilityIcon|Fire Scarabs}}) simply act as negative Additive Amps. This means they add directly together with other additive amps (positive or negative) rather than multiplying against each other.

=== Sources of Damage Reduction ===

==== Weapon and Spirit Reduction ====

{| class="wikitable sortable"
|+List of heroes
!Hero
!Ability
!Tier
!Stat change
|-
| rowspan="2" |{{HeroIcon|Mirage}}
| rowspan="2" |{{AbilityIcon|Fire Scarabs}}
|0
|'''{{#invoke:Abilities|get_ability_prop|Fire Scarabs|OutgoingDamagePenaltyPercent}}%''' Damage Reduction
|-
|3
|'''{{#invoke:Abilities|get_ability_upgrade_prop|Fire Scarabs|3|OutgoingDamagePenaltyPercent}}%''' Damage Reduction
|}

{{Item stat table|Damage Reduction}}

* {{ItemIcon|Cheat Death}}, {{ItemIcon|Golden Goose Egg}} and {{ItemIcon|Cursed Relic}} reduce damage dealt by its user.

==== Spirit Damage Reduction====

Spirit Damage Reduction from {{HeroIcon|Infernus}}'s {{AbilityIcon|Afterburn}} (T2) and {{ItemIcon|Silencer}} does '''not''' behave like standard Damage Reduction. Multiple sources of Spirit‑specific reduction stack additively with each other (e.g., Afterburn T2 + Silencer = sum of percentages). This combined spirit reduction is then applied as a '''separate multiplier''', multiplicative with all other additive amps such as {{ItemIcon|Inhibitor}}.
{| class="wikitable sortable"
|+List of heroes and items
!Hero / Item
!Ability
!Tier
!Stat change
|-
|{{HeroIcon|Infernus}}
|{{AbilityIcon|Afterburn}}
|2
|'''{{#invoke:Abilities|get_ability_upgrade_prop|Afterburn|2|OutgoingTechDamagePercent}}%''' Spirit Damage Reduction '''Note:''' Additive with itself, but multiplicative with other additive amps.
|-
|{{ItemIcon|Silencer}}
| -
| -
|'''{{ItemData|Silencer|TechDamageReduction}}''' Spirit Damage Reduction '''Note:''' Additive with itself, but multiplicative with other additive amps.
|}

== Calculation ==
Contrary to what the percentages might suggest, multiple sources of damage amplification do not all stack in the same way. There are three distinct categories of Damage Amplification, each interacting with the damage formula differently:

* '''Additive Amps:''' These add together with each other (including additive Damage Reductions) into a single pool.
* '''Multiplicative Amps:''' These multiply the total damage one by one.
* '''Instance Amps:''' These are nearly identical to multiplicative amps, main exception being they create a new instance of damage.

=== The Damage Formula ===

Based on testing, the generalized formula for how these amps apply to weapon damage is as follows:

<math>\text{Damage} = [(\text{Base Bullet Damage} \times \text{Weapon Multiplier}) \times (1 + \text{Total Additive Amps}) + \text{Flat Bonus}] \times \text{Multiplicative Amp}_1 \times \text{Multiplicative Amp}_2 \dots \times \text{Instance Amp Damage}_1 \times \text{Instance Amp Damage}_2</math>

'''Example:'''

# A hero has a base bullet damage of '''100''' and '''0''' flat weapon damage for simplicity.
# The hero is affected by {{ItemIcon|Inhibitor}} (an Additive Damage Reduction of '''-30%'''). Their damage drops to '''70''' (100 * 0.70 = 70).
# {{HeroIcon|Ivy}} casts {{AbilityIcon|Air Drop}} on the hero (an Additive Amp of '''+20%'''). The additive pool is now -30% + 20% = -10%. The hero deals '''90''' damage (100 * 0.90 = 90).
# The hero parries an enemy hero (Multiplicative Amp of '''+25%''' against parried target''')'''. This is applied after the additive pool. The hero now deals '''112.5''' damage (90 * 1.25 = 112.5).

== Bugs, Quirks, and Exceptions ==
* '''Additive Amps''' do not apply to many flat values, such as flat weapon damage bonuses, base damage for Melee abilities (Such as the bonus +60 damage from {{HeroIcon|Calico}}'s {{AbilityIcon|Leaping Slash}} T3 upgrade), {{ItemIcon|Capacitor}} active, {{AbilityIcon|Backstabber}}, etc.
* '''Headhunter Interaction:''' Multiplicative non-instance amps are the only amps that work correctly with {{ItemIcon|Headhunter}} damage.
* '''Return Fire / Reflection:''' Because Multiplicative Amps act as defensive stats on the target, if an attacker fires at a target with {{ItemIcon|Return Fire}} while the attacker has an M-amp active against them, the attacker will take increased reflected damage.
* '''Barrier Interaction:''' {{HeroIcon|Billy}}'s bullet amp from {{AbilityIcon|Blasted}} is unique as it is a post-mitigation [[True Damage|true damage]] amp. Because of this, it does not work at all against barriers.
* '''Silencer / Infernus Afterburn T2:''' {{ItemIcon|Silencer}} and {{HeroIcon|Infernus}}'s {{AbilityIcon|Afterburn}} Tier 2 Spirit Damage Reduction are exceptions to the standard Damage Reduction rule. They stack additively with themselves, but multiplicatively with other additive amps.
* '''Celeste:''' {{HeroIcon|Celeste}}'s self Spirit damage amp works like a multiplicative amp but is affected by additive amp bugs.

==References==
<references/>
{{Stat navbox}}

User:Vergir

2026-07-16T18:58:19Z

~2026-GlassGreenKinetic677:

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

texttexttexttexttexttexttexttexttexttexttexttexttext

== Damage Amplification ==

=== Sources of Damage Amplification ===

==== Additive Amplifiers ====

==== Multiplicative Amplifiers ====

==== Instance Amplifiers ====

== Damage Reduction ==

=== Damage Reduction Stacking ===

=== Sources of Damage Reduction ===

==== Weapon and Spirit Reduction ====

==== Spirit Damage Reduction ====

== Total Damage Calculation ==

=== The Damage Formula ===

== Bugs, Quirks, and Exceptions ==

==References==

User:Vergir

2026-07-16T18:56:00Z

~2026-GlassGreenKinetic677:

text

== Damage Amplification ==

=== Sources of Damage Amplification ===

==== Additive Amplifiers ====

==== Multiplicative Amplifiers ====

==== Instance Amplifiers ====

== Damage Reduction ==

=== Damage Reduction Stacking ===

=== Sources of Damage Reduction ===

==== Weapon and Spirit Reduction ====

==== Spirit Damage Reduction ====

== Total Damage Calculation ==

=== The Damage Formula ===

== Bugs, Quirks, and Exceptions ==

==References==

User:Vergir

2026-07-16T18:54:11Z

~2026-GlassGreenKinetic677:

'''Damage Amplification''' or '''Damage Amp''' is a stat that multiplies the damage caused by the player to affected enemies and NPCs.

{{#ev:youtube|apzBQPZyW_w|360|description=Video explaining Damage Amplification}}

== Damage Reduction ==

== Calculation ==

=== The Damage Formula ===

=== Damage Reduction Stacking ===

== Bugs, Quirks, and Exceptions ==

== Sources of Damage Amplification ==

=== Additive Amplifiers ===

=== Multiplicative Amplifiers ===

=== Instance Amplifiers ===

== Sources of Damage Reduction (Negative Additive Amps) ==

=== Weapon and Spirit Reduction ===

=== Spirit Damage Reduction===

==References==