The Deadlock Wiki - User contributions [en]

Template:ItemBox/doc

2026-07-25T00:08:57Z

~2026-ReachMidbossStamina753: Document the lowGraphics parameter, now a real production setting for the card navboxes (with help from vergir-bot LLM)

{{TS}}
== Usage ==

{{tl|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]].

<pre>
{{ItemBox|Extended Magazine}}
</pre>
{{ItemBox|Extended Magazine}}

== Parameters ==

<templatedata>
{
"description": "",
"params": {
"itemName": {
"description": "Item name; keys into Module:ItemData. Positional.",
"type": "string",
"required": true,
"aliases": ["1"],
"example": "Extended Magazine"
},
"size": {
"description": "Scales the whole card. 1 = default (80px wide), 1.5 = 150%, 0.75 = 75%.",
"type": "number",
"default": "1",
"example": "1.5"
},
"showTierTag": {
"description": "Set to true to show the tier corner badge.",
"type": "boolean",
"suggestedvalues": ["true", "false"]
},
"lowGraphics": {
"description": "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.",
"type": "boolean",
"suggestedvalues": ["true", "false"]
},
"overrideDisplayName": {
"description": "Replaces the name shown on the card.",
"type": "string",
"example": "Test Name"
},
"overrideTier": {
"description": "Replaces the card's tier.",
"type": "number",
"suggestedvalues": ["1", "2", "3", "4", "5"]
},
"overrideSlot": {
"description": "Replaces the card's background (type).",
"type": "string",
"suggestedvalues": ["Weapon", "Vitality", "Spirit"]
},
"overrideIsActive": {
"description": "Forces the ACTIVE tag on or off.",
"type": "boolean",
"suggestedvalues": ["true", "false"]
},
"overrideIsImbue": {
"description": "Forces the IMBUE tag on or off.",
"type": "boolean",
"suggestedvalues": ["true", "false"]
},
"overrideLinkTooltip": {
"description": "Page the hover tooltip reads its info from.",
"type": "string",
"example": "Extended Magazine"
},
"overrideLinkImage": {
"description": "Page/file the icon image comes from.",
"type": "string",
"example": "Extended Magazine"
},
"overrideLinkClick": {
"description": "Page the card links to when clicked.",
"type": "string",
"example": "Bullet Lifesteal (item)"
}
},
"paramOrder": [
"itemName", "size", "showTierTag", "lowGraphics",
"overrideDisplayName", "overrideTier", "overrideSlot",
"overrideIsActive", "overrideIsImbue",
"overrideLinkTooltip", "overrideLinkImage", "overrideLinkClick"
],
"format": "inline"
}
</templatedata>

== Examples ==

=== Basic ===

<pre>
{{ItemBox|Close Quarters}}
{{ItemBox|Spirit Shredder Bullets}}
{{ItemBox|Silencer}}
{{ItemBox|Extra Health}}
{{ItemBox|Echo Shard}}
{{ItemBox|Celestial Blessing}}
</pre>
{{ItemBox|Close Quarters}}
{{ItemBox|Spirit Shredder Bullets}}
{{ItemBox|Silencer}}
{{ItemBox|Extra Health}}
{{ItemBox|Echo Shard}}
{{ItemBox|Celestial Blessing}}

=== Tier tag ===

<pre>
{{ItemBox|Extended Magazine|showTierTag = true}}
{{ItemBox|Berserker|showTierTag = true}}
{{ItemBox|Echo Shard|showTierTag = true}}
{{ItemBox|Celestial Blessing|showTierTag = true}}
</pre>
{{ItemBox|Extended Magazine|showTierTag = true}}
{{ItemBox|Berserker|showTierTag = true}}
{{ItemBox|Echo Shard|showTierTag = true}}
{{ItemBox|Celestial Blessing|showTierTag = true}}

=== Size ===

<pre>
{{ItemBox|Extended Magazine|size = 0.75}}
{{ItemBox|Extended Magazine}}
{{ItemBox|Extended Magazine|size = 1.5}}
</pre>
{{ItemBox|Extended Magazine|size = 0.75}}
{{ItemBox|Extended Magazine}}
{{ItemBox|Extended Magazine|size = 1.5}}

=== Overrides ===

<pre>
{{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}}
</pre>
{{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}}

== References ==

* Item data — [[Data:ItemData.json]], read by [[Module:ItemData]]
* Name sizing and texture variety — [[Module:ItemBox]]
* Card styling — [[Template:ItemBox/styles.css]]

<noinclude>[[Category:Template documentation]]</noinclude>

Module:ItemData/nav

2026-07-25T00:03:05Z

~2026-ReachMidbossStamina753: Update stale LOW_GRAPHICS comment to describe the current cacheable-overlay behavior (with help from vergir-bot LLM)

local p = {}
local items_data = mw.loadJsonData("Data:ItemData.json")
local lang_module = require('Module:Lang')
local generic_module = require('Module:GenericData')
local util_module = require('Module:Utilities')

-- Exceptions if the link is different from the item name
local linkOverrides = {
["Bullet Lifesteal"] = "Bullet Lifesteal (item)",
["Spirit Lifesteal"] = "Spirit Lifesteal (item)"
}

-- The card navboxes put every item on a single page, so their cards opt into
-- the cheaper ItemBox rendering via lowGraphics. This swaps the paper texture
-- from the normal-mode multiply (which blends two images and is re-rasterised
-- every scrolled frame) to a transparent-paper overlay that is a single
-- cacheable image, the one change that carried the navbox scroll cost. The wear
-- and icon masks stay at full detail, since a single-image mask caches fine.
-- See [[Template:ItemBox]]. Only the ItemBox branch of write_wrapped_item_list
-- uses this; the ItemIcon lists are unaffected.
local LOW_GRAPHICS = "|lowGraphics=true"

-- Cached items grouped by slot to prevent redundant full-table evaluations
local cached_slots = nil
local function get_items_by_slot(slot)
if not cached_slots then
cached_slots = { table = {}, Weapon = {}, Armor = {}, Tech = {} }
for item_key, item_data in pairs(items_data) do
local this_slot = item_data["Slot"]
if this_slot and cached_slots[this_slot] then
table.insert(cached_slots[this_slot], { key = item_key, data = item_data })
end
end
end
return cached_slots[slot] or {}
end

-- With debug_mode on, it outputs unprocessed wikitext
local function process_debug_mode(wikitext, debug_mode)
if debug_mode == 'true' then
return wikitext
elseif debug_mode == 'false' or debug_mode == nil then
return mw.getCurrentFrame():preprocess(wikitext)
else
return "debug_mode must be 'true' or 'false'"
end
end

-- Writes list of items of a certain slot within the min and max soul bounds
local function write_wrapped_item_list(slot, min_souls, max_souls, template, sep, filter_mode)
if slot ~= 'Weapon' and slot ~= 'Armor' and slot ~= 'Tech' then
return 'slot must be Weapon, Armor (Vitality), or Tech (Spirit)'
end

local min_souls = tonumber(min_souls)
local max_souls = tonumber(max_souls)
if min_souls == nil or max_souls == nil then return 'Min/Max souls must be numerical' end

filter_mode = filter_mode or "all"

-- Lifted out of the loop: Language code doesn't change per item
local lang_code = lang_module.get_lang_code()

local items = {}
local slot_items = get_items_by_slot(slot) -- Drastically reduces search pool size

for _, item_entry in ipairs(slot_items) do
local item_key = item_entry.key
local item_data = item_entry.data

local this_cost = tonumber(item_data["Cost"])
local is_street_brawl = item_data["StreetBrawl"] == true
local should_include = true

-- Filter logic for Street Brawl items
if filter_mode == "street_brawl_only" and not is_street_brawl then
should_include = false
elseif filter_mode == "exclude_street_brawl" and is_street_brawl then
should_include = false
end

if should_include and item_data["Name"] ~= nil and item_data["IsDisabled"] == false and this_cost ~= nil then
if this_cost >= min_souls and this_cost < max_souls then
local item_name_english = lang_module.get_string(item_key, "en")
local item_link = linkOverrides[item_name_english] or item_name_english
local item_name_local = lang_module.get_string(item_key, lang_code)

local item_template
if template == "ItemIcon" then
if lang_code == "en" then
item_template = "{{ItemIcon|" .. item_name_english .. "|size=26px}}"
else
item_template = "{{ItemIcon|" .. item_name_english .. "|lang=" .. lang_code .. "|l1=" .. item_name_local .. "|size=26px}}"
end

local search_data = item_name_english
if lang_code ~= "en" and item_name_local then
search_data = search_data .. " " .. item_name_local
end

item_template = '<span class="item-nav-search-wrapper"><span class="item-nav-search-item" data-item-name="' .. search_data .. '">' .. item_template .. '</span>'
elseif template == "ItemBox" then
if lang_code == "en" then
if is_street_brawl then
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. item_link .. "|overrideTier=5" .. LOW_GRAPHICS .. "}}"
else
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. item_link .. LOW_GRAPHICS .. "}}"
end
else
local link_local = item_link .. "/" .. lang_code
if is_street_brawl then
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. link_local .. "|item_price={{#invoke:Lang|get_string|Citadel_ItemDraft_Legendary}}" .. LOW_GRAPHICS .. "}}"
else
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. link_local .. LOW_GRAPHICS .. "}}"
end
end
else
return "Invalid template type"
end
table.insert(items, item_template)
end
end
end

-- Order list alphabetically
table.sort(items)

-- Append closing tags and bullets
if template == "ItemIcon" then
local total_items = #items
for i = 1, total_items do
if i == total_items then
items[i] = items[i] .. '</span>'
else
items[i] = items[i] .. '<span class="item-nav-search-sep"> • </span></span>'
end
end
end

return table.concat(items, sep)
end

-- for [[Template:Item Navbox]]
function p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, filter_mode)
if type(slot) == "table" and slot.args then
local frame = slot
slot = frame.args[1]
min_souls = frame.args[2]
max_souls = frame.args[3]
debug_mode = frame.args["debug_mode"]
filter_mode = frame.args["filter"]
end

local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemIcon", '', filter_mode)
return process_debug_mode(item_list, debug_mode)
end

-- for [[Template:Infobox ShopItems]]
function p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, filter_mode)
if type(slot) == "table" and slot.args then
local frame = slot
slot = frame.args[1]
min_souls = frame.args[2]
max_souls = frame.args[3]
debug_mode = frame.args["debug_mode"]
filter_mode = frame.args["filter"]
end

local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemBox", ' ', filter_mode)
return process_debug_mode(item_list, debug_mode)
end

-- for [[Template:Item Navbox]] subgroup rows
function p.write_item_slot_subgroup(frame)
local slot = frame.args[1]
local type_func = frame.args[2]
local debug_mode = frame.args['debug_mode']
local street_brawl_label = frame.args['street_brawl_label'] or '{{Legendary|{{#invoke:Lang|get_string|Citadel_ItemDraft_Legendary}}}}'

if slot == nil then return "'slot' parameter is required" end

local template_args = {
["groupstyle"] = "background-color:" .. util_module.get_slot_color(slot) .. ";width:10%;min-width:70px;border-radius: 8px 0 0 8px",
["grouppadding"] = "5px",
["listpadding"] = "0 0.25rem",
}

local soul_style = "font-size: 12px; text-shadow: 1px 1px rgba(0, 0, 0, 0.3);"
local prices = generic_module.get_item_price_per_tier()
local group_index = 1

for i, souls in ipairs(prices) do
local min_souls = souls

if min_souls ~= 0 then
local max_souls = prices[i+1] or (min_souls * 10)

local list
if type_func == 'get_item_nav_cards' then
list = p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
elseif type_func == 'get_item_nav_bulletpoints' then
list = p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
else
return "'type' should be get_item_nav_cards or get_item_nav_bulletpoints"
end

if list and list ~= "" then
template_args["group" .. group_index] = frame:expandTemplate{title="Souls", args={[1] = min_souls, ["Shadow"] = soul_style}}
template_args["list" .. group_index] = list
group_index = group_index + 1
end
end
end

local sb_list
if type_func == 'get_item_nav_cards' then
sb_list = p.get_item_nav_cards(slot, 0, 999999, debug_mode, "street_brawl_only")
elseif type_func == 'get_item_nav_bulletpoints' then
sb_list = p.get_item_nav_bulletpoints(slot, 0, 999999, debug_mode, "street_brawl_only")
end

if sb_list and sb_list ~= "" then
local sb_style = "color:#98ffde; font-family:'Retail Demo', sans-serif; text-wrap: nowrap; text-shadow: 0px 0px 2px #2c312e, 1.3px 1.3px rgba(0, 0, 0, 0.2);padding:5px;"
local sb_link_text = "[[Street Brawl{{if_lang}}|<span style=\"" .. sb_style .. "\"><b>" .. street_brawl_label .. "</b></span>]]"
template_args["group" .. group_index] = frame:preprocess(sb_link_text)
template_args["list" .. group_index] = sb_list
end

return frame:expandTemplate{title="Navbox subgroup", args=template_args}
end

-- for [[Template:Active Items]]

-- Displayed when a stat does not apply to an item
local NO_VALUE = "—"

-- One expanded inline attribute as produced by [[Module:Lang]]:
-- wrapper span > icon span > spacer span > wikilink
local INLINE_ATTRIBUTE_PATTERN =
'<span class="no%-blue%-link" style="text%-wrap:nowrap; font%-weight:bold; color:[^;"]*;">' ..
'<span style="[^"]*">%[%[File:[^%]]*%]%]</span>' ..
'<span style="color: inherit;"> </span> ' ..
'%[%[([^|%]]+)|([^%]]*)%]%]</span>'

-- Range is taken from the first of these the item has a usable value for
local RANGE_PROPERTIES = { "AbilityCastRange", "Radius", "EndRadius" }

-- Rewrites the description markup [[Module:Lang]] produces
local function restyle_description(text)
text = text:gsub(INLINE_ATTRIBUTE_PATTERN, '[[%1|%2]]')
-- Attributes with an icon but no link keep their span; follow the site text color
text = text:gsub('color:#ffefd7;', 'color:var(--color-base);')
-- Diminished notes ("Cannot be used while Stunned...")
return (text:gsub('color:#C0C0C0', 'color:var(--color-subtle)'))
end

-- Numeric value of a stat, used for sorting
local function stat_sort_value(value)
if type(value) == "table" then value = value["Value"] end
if value == nil then return -1 end
return tonumber(tostring(value):match("[-%d%.]+")) or -1
end

-- First range property the item has a usable value for
local function get_range_property(item_data)
for _, property in ipairs(RANGE_PROPERTIES) do
local value = item_data[property]
if value ~= nil and stat_sort_value(value) > 0 then
return property, value
end
end
return nil, nil
end

-- Builds a stat cell, falling back to an em dash when the stat does not apply
local function stat_cell(raw_value, item_name, property, postfix)
if raw_value == nil or property == nil then
return '| data-sort-value="-1" style="text-align:center;font-size:16px" | ' .. NO_VALUE
end
return string.format(
'| data-sort-value="%s" style="text-align:center;font-size:16px" | {{#invoke:ItemData|get_prop|%s|%s}}%s',
stat_sort_value(raw_value), item_name, property, postfix or "")
end

function p.generate_active_items_table(frame)
local active_items = {}

for item_key, item_data in pairs(items_data) do
local cost = tonumber(item_data["Cost"])
if item_data["Name"] and
item_data["IsDisabled"] == false and
cost ~= nil and cost > 0 and
item_data["Activation"] and
item_data["Activation"] ~= "Passive" then

local range_property, range_value = get_range_property(item_data)

table.insert(active_items, {
name = item_data["Name"],
key = item_key,
cost = cost,
slot = item_data["Slot"] or "Weapon",
has_active_desc = item_data["ActiveDescription"] ~= nil,
cooldown = item_data["AbilityCooldown"],
duration = item_data["AbilityDuration"],
range_property = range_property,
range_value = range_value
})
end
end

table.sort(active_items, function(a, b) return a.name < b.name end)

-- Optimized string compilation using a structural buffer table
local rows = {}
table.insert(rows, [=[{| class="wikitable mw-collapsible sortable" style="width:100%"
|+{{#invoke:Dictionary|translate|Active Items}}
! colspan="2" | {{#invoke:Lang|get_string|Citadel_HeroBuilds_CategoryNameLabel}}
! {{#invoke:Lang|get_string|Citadel_UserFeedback_TypeLabel}}
! {{Souls|{{#invoke:Dictionary|translate|Cost}}}}
! {{#invoke:Lang|get_string|Citadel_Mod_Tooltip_Active}}
! {{#invoke:Lang|get_string|AbilityCooldown_label}}
! {{#invoke:Lang|get_string|AbilityDuration_label}}
! {{#invoke:Lang|get_string|AbilityCastRange_label}}]=])

for _, item in ipairs(active_items) do
local bg_color = util_module.get_slot_color(item.slot)

local item_type
if item.slot == "Armor" then
item_type = "Armor"
elseif item.slot == "Tech" then
item_type = "Tech"
else
item_type = "Weapon"
end

local row = string.format([=[
|-
! style="background-color:%s" | [[File:%s.png|64x64px]]
! [[%s{{If_lang}}|{{#invoke:Lang|get_string|%s}}]]
| style="text-align:center;font-weight:bold" | {{ItemType|%s|{{#invoke:Lang|get_string|CitadelCategory%s}}}}
| data-sort-value="%d" style="text-align:center;font-size:15px" | {{Souls|%d}}
| {{#invoke:Utilities|process_variables|%s_active_desc|%s}}{{#invoke:Utilities|process_variables|%s_desc|%s}}{{#invoke:Utilities|process_variables|%s_active|%s}}
%s
%s
%s]=],
bg_color,
item.name,
item.name, item.key,
item_type, item_type,
item.cost, item.cost,
item.key, item.name, item.key, item.name, item.key, item.name,
stat_cell(item.cooldown, item.name, "AbilityCooldown", "s"),
stat_cell(item.duration, item.name, "AbilityDuration", "s"),
stat_cell(item.range_value, item.name, item.range_property))

table.insert(rows, row)
end

table.insert(rows, "\n|}")
return restyle_description(frame:preprocess(table.concat(rows, "\n")))
end

return p

Template:ItemBox

2026-07-25T00:01:37Z

~2026-ReachMidbossStamina753: Wire lowGraphics to the per-item overlay (itembox-lowgfx) and remove the texture/wearMask/iconMask testing switch now that the texture approach is settled (with help from vergir-bot LLM)

2026-07-24T19:45:28Z

~2026-ReachMidbossStamina753: Revert the lowGraphics icon downscale to isolate its effect; the paper blend removal was the real win. Icons back to 160px (with help from vergir-bot LLM)

Template:ItemBox

2026-07-24T15:19:38Z

~2026-ReachMidbossStamina753: Test whether the paper blend is what keeps picture cache tiles invalid: drop it from lowGraphics (with help from vergir-bot LLM)

Module:ItemData/nav

2026-07-24T15:07:03Z

~2026-ReachMidbossStamina753: Use the single lowGraphics flag for navbox cards now that ItemBox bundles the cheap layers and the 1x icon request (with help from vergir-bot LLM)

local p = {}
local items_data = mw.loadJsonData("Data:ItemData.json")
local lang_module = require('Module:Lang')
local generic_module = require('Module:GenericData')
local util_module = require('Module:Utilities')

-- Exceptions if the link is different from the item name
local linkOverrides = {
["Bullet Lifesteal"] = "Bullet Lifesteal (item)",
["Spirit Lifesteal"] = "Spirit Lifesteal (item)"
}

-- The card navboxes put every item on a single page, so their cards opt into
-- the cheaper ItemBox rendering: a gradient instead of the masked wear tint, no
-- icon mask, one shared paper, and an icon requested at the size it is actually
-- drawn. Each of those is a render pass, a backdrop read or a texture upload the
-- GPU would otherwise repeat for every card on screen. See [[Template:ItemBox]].
-- Only the ItemBox branch of write_wrapped_item_list uses this; the ItemIcon
-- lists are unaffected.
local LOW_GRAPHICS = "|lowGraphics=true"

-- Cached items grouped by slot to prevent redundant full-table evaluations
local cached_slots = nil
local function get_items_by_slot(slot)
if not cached_slots then
cached_slots = { table = {}, Weapon = {}, Armor = {}, Tech = {} }
for item_key, item_data in pairs(items_data) do
local this_slot = item_data["Slot"]
if this_slot and cached_slots[this_slot] then
table.insert(cached_slots[this_slot], { key = item_key, data = item_data })
end
end
end
return cached_slots[slot] or {}
end

-- With debug_mode on, it outputs unprocessed wikitext
local function process_debug_mode(wikitext, debug_mode)
if debug_mode == 'true' then
return wikitext
elseif debug_mode == 'false' or debug_mode == nil then
return mw.getCurrentFrame():preprocess(wikitext)
else
return "debug_mode must be 'true' or 'false'"
end
end

-- Writes list of items of a certain slot within the min and max soul bounds
local function write_wrapped_item_list(slot, min_souls, max_souls, template, sep, filter_mode)
if slot ~= 'Weapon' and slot ~= 'Armor' and slot ~= 'Tech' then
return 'slot must be Weapon, Armor (Vitality), or Tech (Spirit)'
end

local min_souls = tonumber(min_souls)
local max_souls = tonumber(max_souls)
if min_souls == nil or max_souls == nil then return 'Min/Max souls must be numerical' end

filter_mode = filter_mode or "all"

-- Lifted out of the loop: Language code doesn't change per item
local lang_code = lang_module.get_lang_code()

local items = {}
local slot_items = get_items_by_slot(slot) -- Drastically reduces search pool size

for _, item_entry in ipairs(slot_items) do
local item_key = item_entry.key
local item_data = item_entry.data

local this_cost = tonumber(item_data["Cost"])
local is_street_brawl = item_data["StreetBrawl"] == true
local should_include = true

-- Filter logic for Street Brawl items
if filter_mode == "street_brawl_only" and not is_street_brawl then
should_include = false
elseif filter_mode == "exclude_street_brawl" and is_street_brawl then
should_include = false
end

if should_include and item_data["Name"] ~= nil and item_data["IsDisabled"] == false and this_cost ~= nil then
if this_cost >= min_souls and this_cost < max_souls then
local item_name_english = lang_module.get_string(item_key, "en")
local item_link = linkOverrides[item_name_english] or item_name_english
local item_name_local = lang_module.get_string(item_key, lang_code)

local item_template
if template == "ItemIcon" then
if lang_code == "en" then
item_template = "{{ItemIcon|" .. item_name_english .. "|size=26px}}"
else
item_template = "{{ItemIcon|" .. item_name_english .. "|lang=" .. lang_code .. "|l1=" .. item_name_local .. "|size=26px}}"
end

local search_data = item_name_english
if lang_code ~= "en" and item_name_local then
search_data = search_data .. " " .. item_name_local
end

item_template = '<span class="item-nav-search-wrapper"><span class="item-nav-search-item" data-item-name="' .. search_data .. '">' .. item_template .. '</span>'
elseif template == "ItemBox" then
if lang_code == "en" then
if is_street_brawl then
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. item_link .. "|overrideTier=5" .. LOW_GRAPHICS .. "}}"
else
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. item_link .. LOW_GRAPHICS .. "}}"
end
else
local link_local = item_link .. "/" .. lang_code
if is_street_brawl then
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. link_local .. "|item_price={{#invoke:Lang|get_string|Citadel_ItemDraft_Legendary}}" .. LOW_GRAPHICS .. "}}"
else
item_template = "{{ItemBox|itemName=" .. item_name_english .. "|overrideLinkClick=" .. link_local .. LOW_GRAPHICS .. "}}"
end
end
else
return "Invalid template type"
end
table.insert(items, item_template)
end
end
end

-- Order list alphabetically
table.sort(items)

-- Append closing tags and bullets
if template == "ItemIcon" then
local total_items = #items
for i = 1, total_items do
if i == total_items then
items[i] = items[i] .. '</span>'
else
items[i] = items[i] .. '<span class="item-nav-search-sep"> • </span></span>'
end
end
end

return table.concat(items, sep)
end

-- for [[Template:Item Navbox]]
function p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, filter_mode)
if type(slot) == "table" and slot.args then
local frame = slot
slot = frame.args[1]
min_souls = frame.args[2]
max_souls = frame.args[3]
debug_mode = frame.args["debug_mode"]
filter_mode = frame.args["filter"]
end

local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemIcon", '', filter_mode)
return process_debug_mode(item_list, debug_mode)
end

-- for [[Template:Infobox ShopItems]]
function p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, filter_mode)
if type(slot) == "table" and slot.args then
local frame = slot
slot = frame.args[1]
min_souls = frame.args[2]
max_souls = frame.args[3]
debug_mode = frame.args["debug_mode"]
filter_mode = frame.args["filter"]
end

local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemBox", ' ', filter_mode)
return process_debug_mode(item_list, debug_mode)
end

-- for [[Template:Item Navbox]] subgroup rows
function p.write_item_slot_subgroup(frame)
local slot = frame.args[1]
local type_func = frame.args[2]
local debug_mode = frame.args['debug_mode']
local street_brawl_label = frame.args['street_brawl_label'] or '{{Legendary|{{#invoke:Lang|get_string|Citadel_ItemDraft_Legendary}}}}'

if slot == nil then return "'slot' parameter is required" end

local template_args = {
["groupstyle"] = "background-color:" .. util_module.get_slot_color(slot) .. ";width:10%;min-width:70px;border-radius: 8px 0 0 8px",
["grouppadding"] = "5px",
["listpadding"] = "0 0.25rem",
}

local soul_style = "font-size: 12px; text-shadow: 1px 1px rgba(0, 0, 0, 0.3);"
local prices = generic_module.get_item_price_per_tier()
local group_index = 1

for i, souls in ipairs(prices) do
local min_souls = souls

if min_souls ~= 0 then
local max_souls = prices[i+1] or (min_souls * 10)

local list
if type_func == 'get_item_nav_cards' then
list = p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
elseif type_func == 'get_item_nav_bulletpoints' then
list = p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
else
return "'type' should be get_item_nav_cards or get_item_nav_bulletpoints"
end

if list and list ~= "" then
template_args["group" .. group_index] = frame:expandTemplate{title="Souls", args={[1] = min_souls, ["Shadow"] = soul_style}}
template_args["list" .. group_index] = list
group_index = group_index + 1
end
end
end

local sb_list
if type_func == 'get_item_nav_cards' then
sb_list = p.get_item_nav_cards(slot, 0, 999999, debug_mode, "street_brawl_only")
elseif type_func == 'get_item_nav_bulletpoints' then
sb_list = p.get_item_nav_bulletpoints(slot, 0, 999999, debug_mode, "street_brawl_only")
end

if sb_list and sb_list ~= "" then
local sb_style = "color:#98ffde; font-family:'Retail Demo', sans-serif; text-wrap: nowrap; text-shadow: 0px 0px 2px #2c312e, 1.3px 1.3px rgba(0, 0, 0, 0.2);padding:5px;"
local sb_link_text = "[[Street Brawl{{if_lang}}|<span style=\"" .. sb_style .. "\"><b>" .. street_brawl_label .. "</b></span>]]"
template_args["group" .. group_index] = frame:preprocess(sb_link_text)
template_args["list" .. group_index] = sb_list
end

return frame:expandTemplate{title="Navbox subgroup", args=template_args}
end

-- for [[Template:Active Items]]

-- Displayed when a stat does not apply to an item
local NO_VALUE = "—"

-- One expanded inline attribute as produced by [[Module:Lang]]:
-- wrapper span > icon span > spacer span > wikilink
local INLINE_ATTRIBUTE_PATTERN =
'<span class="no%-blue%-link" style="text%-wrap:nowrap; font%-weight:bold; color:[^;"]*;">' ..
'<span style="[^"]*">%[%[File:[^%]]*%]%]</span>' ..
'<span style="color: inherit;"> </span> ' ..
'%[%[([^|%]]+)|([^%]]*)%]%]</span>'

-- Range is taken from the first of these the item has a usable value for
local RANGE_PROPERTIES = { "AbilityCastRange", "Radius", "EndRadius" }

-- Rewrites the description markup [[Module:Lang]] produces
local function restyle_description(text)
text = text:gsub(INLINE_ATTRIBUTE_PATTERN, '[[%1|%2]]')
-- Attributes with an icon but no link keep their span; follow the site text color
text = text:gsub('color:#ffefd7;', 'color:var(--color-base);')
-- Diminished notes ("Cannot be used while Stunned...")
return (text:gsub('color:#C0C0C0', 'color:var(--color-subtle)'))
end

-- Numeric value of a stat, used for sorting
local function stat_sort_value(value)
if type(value) == "table" then value = value["Value"] end
if value == nil then return -1 end
return tonumber(tostring(value):match("[-%d%.]+")) or -1
end

-- First range property the item has a usable value for
local function get_range_property(item_data)
for _, property in ipairs(RANGE_PROPERTIES) do
local value = item_data[property]
if value ~= nil and stat_sort_value(value) > 0 then
return property, value
end
end
return nil, nil
end

-- Builds a stat cell, falling back to an em dash when the stat does not apply
local function stat_cell(raw_value, item_name, property, postfix)
if raw_value == nil or property == nil then
return '| data-sort-value="-1" style="text-align:center;font-size:16px" | ' .. NO_VALUE
end
return string.format(
'| data-sort-value="%s" style="text-align:center;font-size:16px" | {{#invoke:ItemData|get_prop|%s|%s}}%s',
stat_sort_value(raw_value), item_name, property, postfix or "")
end

function p.generate_active_items_table(frame)
local active_items = {}

for item_key, item_data in pairs(items_data) do
local cost = tonumber(item_data["Cost"])
if item_data["Name"] and
item_data["IsDisabled"] == false and
cost ~= nil and cost > 0 and
item_data["Activation"] and
item_data["Activation"] ~= "Passive" then

local range_property, range_value = get_range_property(item_data)

table.insert(active_items, {
name = item_data["Name"],
key = item_key,
cost = cost,
slot = item_data["Slot"] or "Weapon",
has_active_desc = item_data["ActiveDescription"] ~= nil,
cooldown = item_data["AbilityCooldown"],
duration = item_data["AbilityDuration"],
range_property = range_property,
range_value = range_value
})
end
end

table.sort(active_items, function(a, b) return a.name < b.name end)

-- Optimized string compilation using a structural buffer table
local rows = {}
table.insert(rows, [=[{| class="wikitable mw-collapsible sortable" style="width:100%"
|+{{#invoke:Dictionary|translate|Active Items}}
! colspan="2" | {{#invoke:Lang|get_string|Citadel_HeroBuilds_CategoryNameLabel}}
! {{#invoke:Lang|get_string|Citadel_UserFeedback_TypeLabel}}
! {{Souls|{{#invoke:Dictionary|translate|Cost}}}}
! {{#invoke:Lang|get_string|Citadel_Mod_Tooltip_Active}}
! {{#invoke:Lang|get_string|AbilityCooldown_label}}
! {{#invoke:Lang|get_string|AbilityDuration_label}}
! {{#invoke:Lang|get_string|AbilityCastRange_label}}]=])

for _, item in ipairs(active_items) do
local bg_color = util_module.get_slot_color(item.slot)

local item_type
if item.slot == "Armor" then
item_type = "Armor"
elseif item.slot == "Tech" then
item_type = "Tech"
else
item_type = "Weapon"
end

local row = string.format([=[
|-
! style="background-color:%s" | [[File:%s.png|64x64px]]
! [[%s{{If_lang}}|{{#invoke:Lang|get_string|%s}}]]
| style="text-align:center;font-weight:bold" | {{ItemType|%s|{{#invoke:Lang|get_string|CitadelCategory%s}}}}
| data-sort-value="%d" style="text-align:center;font-size:15px" | {{Souls|%d}}
| {{#invoke:Utilities|process_variables|%s_active_desc|%s}}{{#invoke:Utilities|process_variables|%s_desc|%s}}{{#invoke:Utilities|process_variables|%s_active|%s}}
%s
%s
%s]=],
bg_color,
item.name,
item.name, item.key,
item_type, item_type,
item.cost, item.cost,
item.key, item.name, item.key, item.name, item.key, item.name,
stat_cell(item.cooldown, item.name, "AbilityCooldown", "s"),
stat_cell(item.duration, item.name, "AbilityDuration", "s"),
stat_cell(item.range_value, item.name, item.range_property))

table.insert(rows, row)
end

table.insert(rows, "\n|}")
return restyle_description(frame:preprocess(table.concat(rows, "\n")))
end

return p

Template:ItemBox

2026-07-24T15:05:52Z

~2026-ReachMidbossStamina753: Add lowGraphics flag bundling the cheap layers and a 1x icon request, so callers rendering many cards set one parameter (with help from vergir-bot LLM)