Template:ItemBox: Difference between revisions

From The Deadlock Wiki
Jump to navigation Jump to search
Add texture=over-light preset so the lighter overlay can be set without inline style (with help from vergir-bot LLM)
Add texture=split and split1/2/3: paper blended onto icon and name area separately, continuous across the seam (with help from vergir-bot LLM)
Line 23: Line 23:
     lowGraphics=true is the setting for callers that place dozens of cards on
     lowGraphics=true is the setting for callers that place dozens of cards on
     one page. The wear tint becomes a gradient and the icon mask is dropped,
     one page. The wear tint becomes a gradient and the icon mask is dropped,
     and the paper texture is composited into the card layer with
     and the paper texture is composited into the icon and name area with
     background-blend-mode instead of the separate mix-blend-mode overlay. That
     background-blend-mode instead of the separate mix-blend-mode overlay. That
     is the change that matters: mix-blend-mode reads the page backdrop so
     is the change that matters: mix-blend-mode reads the page backdrop so
Line 29: Line 29:
     same-element blend stays a static tile. Removing the overlay blend cut the
     same-element blend stays a static tile. Removing the overlay blend cut the
     render thread's OpenGL work on the profiled navbox by around 90%.
     render thread's OpenGL work on the profiled navbox by around 90%.
-->{{#vardefine:lowGraphics|{{#ifeq:{{{lowGraphics|}}}|true|itembox-ramp-wear itembox-flat-icon itembox-blend-texture itembox-blend-tex-3}}}}<!--
-->{{#vardefine:lowGraphics|{{#ifeq:{{{lowGraphics|}}}|true|itembox-ramp-wear itembox-flat-icon itembox-split-texture itembox-blend-tex-3}}}}<!--


     The same layers individually, for testing combinations or overriding the
     The same layers individually, for testing combinations or overriding the
Line 39: Line 39:
     no    - drop it entirely
     no    - drop it entirely
     1/2/3 - one shared paper via the mix-blend overlay (does not cache)
     1/2/3 - one shared paper via the mix-blend overlay (does not cache)
     blend / blend1..3 - paper multiplied into the card art, cacheable, but
     blend / blend1..3 - paper multiplied into the card art only, cacheable
            reaches only the card art, not the icon or name
     split / split1..3 - paper multiplied onto the icon and name area, so it
     over / over1..3 - paper as a plain alpha overlay over the whole card,
            reaches the whole card, cacheable, grain continuous across the seam
            cacheable; lightens instead of multiplying
-->{{#vardefine:lite|{{#switch:{{{wearMask|}}}|no=itembox-flat-wear|ramp=itembox-ramp-wear|soft=itembox-soft-wear}} {{#ifeq:{{{iconMask|}}}|no|itembox-flat-icon}} {{#switch:{{{texture|}}}|no=itembox-no-texture|1=itembox-force-tex-1|2=itembox-force-tex-2|3=itembox-force-tex-3|blend=itembox-blend-texture|blend1=itembox-blend-texture itembox-blend-tex-1|blend2=itembox-blend-texture itembox-blend-tex-2|blend3=itembox-blend-texture itembox-blend-tex-3|split=itembox-split-texture|split1=itembox-split-texture itembox-blend-tex-1|split2=itembox-split-texture itembox-blend-tex-2|split3=itembox-split-texture itembox-blend-tex-3}}}}<!--
    over-light - the plain overlay (paper 3) at a lighter opacity
-->{{#vardefine:lite|{{#switch:{{{wearMask|}}}|no=itembox-flat-wear|ramp=itembox-ramp-wear|soft=itembox-soft-wear}} {{#ifeq:{{{iconMask|}}}|no|itembox-flat-icon}} {{#switch:{{{texture|}}}|no=itembox-no-texture|1=itembox-force-tex-1|2=itembox-force-tex-2|3=itembox-force-tex-3|blend=itembox-blend-texture|blend1=itembox-blend-texture itembox-blend-tex-1|blend2=itembox-blend-texture itembox-blend-tex-2|blend3=itembox-blend-texture itembox-blend-tex-3|over=itembox-over-texture|over1=itembox-over-texture itembox-blend-tex-1|over2=itembox-over-texture itembox-blend-tex-2|over3=itembox-over-texture itembox-blend-tex-3|over-light=itembox-over-texture itembox-blend-tex-3 itembox-over-light}}}}<!--


     Links.
     Links.

Revision as of 20:41, 24 July 2026

Template documentation [view] [edit] [history] [purge]
CSS3 logo.svg
This template uses CSS found at ItemBox/styles.css.

Usage

{{ItemBox}} renders a Deadlock shop item as a card: icon, tier art, and the item name auto-sized to fit. Pass an item name and everything else — tier, slot, tags, image — is pulled from Module:ItemData.

{{ItemBox|Extended Magazine}}
Imbue

Extended Magazine

Active

Parameters

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
itemNameitemName 1

Item name; keys into Module:ItemData. Positional.

Example
Extended Magazine
Stringrequired
sizesize

Scales the whole card. 1 = default (80px wide), 1.5 = 150%, 0.75 = 75%.

Default
1
Example
1.5
Numberoptional
showTierTagshowTierTag

Set to true to show the tier corner badge.

Suggested values
true false
Booleanoptional
lowGraphicslowGraphics

Set to true for pages that place many cards at once (the card navboxes). Swaps the paper texture to a cacheable overlay so scrolling stays smooth; the look is nearly identical.

Suggested values
true false
Booleanoptional
overrideDisplayNameoverrideDisplayName

Replaces the name shown on the card.

Example
Test Name
Stringoptional
overrideTieroverrideTier

Replaces the card's tier.

Suggested values
1 2 3 4 5
Numberoptional
overrideSlotoverrideSlot

Replaces the card's background (type).

Suggested values
Weapon Vitality Spirit
Stringoptional
overrideIsActiveoverrideIsActive

Forces the ACTIVE tag on or off.

Suggested values
true false
Booleanoptional
overrideIsImbueoverrideIsImbue

Forces the IMBUE tag on or off.

Suggested values
true false
Booleanoptional
overrideLinkTooltipoverrideLinkTooltip

Page the hover tooltip reads its info from.

Example
Extended Magazine
Stringoptional
overrideLinkImageoverrideLinkImage

Page/file the icon image comes from.

Example
Extended Magazine
Stringoptional
overrideLinkClickoverrideLinkClick

Page the card links to when clicked.

Example
Bullet Lifesteal (item)
Stringoptional

Examples

Basic

{{ItemBox|Close Quarters}}
{{ItemBox|Spirit Shredder Bullets}}
{{ItemBox|Silencer}}
{{ItemBox|Extra Health}}
{{ItemBox|Echo Shard}}
{{ItemBox|Celestial Blessing}}
Imbue

Close Quarters

Active
Imbue

Spirit Shredder Bullets

Active
Imbue

Silencer

Active
Imbue

Extra Health

Active
Imbue

Echo Shard

Active
Imbue

Celestial Blessing

Active

Tier tag

{{ItemBox|Extended Magazine|showTierTag = true}}
{{ItemBox|Berserker|showTierTag = true}}
{{ItemBox|Echo Shard|showTierTag = true}}
{{ItemBox|Celestial Blessing|showTierTag = true}}
Imbue

Extended Magazine

Active
Imbue

Berserker

Active
Imbue

Echo Shard

Active
Imbue

Celestial Blessing

Active

Size

{{ItemBox|Extended Magazine|size = 0.75}}
{{ItemBox|Extended Magazine}}
{{ItemBox|Extended Magazine|size = 1.5}}
Imbue

Extended Magazine

Active
Imbue

Extended Magazine

Active
Imbue

Extended Magazine

Active

Low graphics

For pages that place many cards at once. The paper texture becomes a single cacheable overlay so scrolling stays smooth; the look is nearly identical.

{{ItemBox|Extra Health}}
{{ItemBox|Kinetic Dash}}
{{ItemBox|Metal Skin}}
{{ItemBox|Echo Shard}}

{{ItemBox|Extra Health|lowGraphics = true}}
{{ItemBox|Kinetic Dash|lowGraphics = true}}
{{ItemBox|Metal Skin|lowGraphics = true}}
{{ItemBox|Echo Shard|lowGraphics = true}}

Normal

Imbue

Extra Health

Active
Imbue

Kinetic Dash

Active
Imbue

Metal Skin

Active
Imbue

Echo Shard

Active

Low graphics

Imbue

Extra Health

Active
Imbue

Kinetic Dash

Active
Imbue

Metal Skin

Active
Imbue

Echo Shard

Active

Overrides

{{ItemBox|High-Velocity Rounds|overrideDisplayName = Test Name}}
{{ItemBox|Intensifying Magazine|overrideTier = 4}}
{{ItemBox|Weakening Headshot|overrideSlot = Spirit}}
{{ItemBox|Recharging Rush|overrideIsActive = true}}
{{ItemBox|Alchemical Fire|overrideIsImbue = true}}
{{ItemBox|Bullet Lifesteal|overrideLinkClick = Heroes}}
Imbue

Test Name

Active
Imbue

Intensifying Magazine

Active
Imbue

Weakening Headshot

Active
Imbue

Recharging Rush

Active
Imbue

Alchemical Fire

Active
Imbue

Bullet Lifesteal

Active

References