Module:Sandbox/LVL: Difference between revisions

Jump to navigation Jump to search
Browse history interactively
← Older editNewer edit →

LVL (talk | contribs)

3 user groups
4,834 edits
undo
LVL (talk | contribs)
Contributors, Interface administrators, Moderators
4,834 edits
No edit summary
LVL (talk | contribs)
Contributors, Interface administrators, Moderators
4,834 edits
No edit summary
Line 1: Line 1:
local p = {}
local p = {};
local items_data = mw.loadJsonData("Data:ItemData.json")
local heroes_data = mw.loadJsonData("Data:HeroData.json")
local attributes_data = mw.loadJsonData("Data:AttributeData.json")
local attribute_orders = mw.loadJsonData("Data:StatInfoboxOrder.json")
local util_module = require('Module:Utilities')
local lang_module = require('Module:Lang')
local lang_module = require('Module:Lang')
local generic_module = require('Module:GenericData')
local dictionary_module = require('Module:Dictionary')
local util_module = require('Module:Utilities')
local attribute_module = require('Module:AttributeData')
 
-- returns the table of a specific item, used by external modules
function p.get_json_item(name)
for i,v in pairs(heroes_data) do
if (v["Name"] == name) then
return v
end
end
return nil
end


--With debug_mode on, it outputs unprocessed wikitext
-- Returns an array of item tables that have the same properties
--With debug_mode off/unspecified, it processes the wikitext
-- @function  get_similar_items
local function process_debug_mode(wikitext, debug_mode)
-- @param      {string}
if debug_mode == 'true' then
-- @return    {array of tables}
return wikitext
local function get_similar_items(property)
elseif debug_mode == 'false' or debug_mode == nil then
local similarItems = {}
return mw.getCurrentFrame():preprocess(wikitext)
for _, v in pairs(heroes_data) do
else
if (v[property] ~= nil) then
return "debug_mode must be 'true' or 'false'"
table.insert(similarItems, v)
end
end
end
return similarItems
end
end


--Writes list of items of a certain slot within the min and max soul bounds
-- returns the key of the specified hero's english name
-- Each item is wrapped and separated. For example of wrapping/separator, see
function p.get_hero_key(name)
-- get_item_nav_bulletpoints. 'sep' should not be combined with 'right_wrap',
for i,v in pairs(heroes_data) do
-- as the trailing separator should also be removed from the string
if (v["Name"] == name) then
-- NEW: filter_mode parameter added. Options: nil/"all", "exclude_street_brawl", "street_brawl_only"
return i
local function write_wrapped_item_list(slot, min_souls, max_souls, template, sep, filter_mode)
end
     if slot ~= 'Weapon' and slot ~= 'Armor' and slot ~= 'Tech' then
end
         return 'slot must be Weapon, Armor (Vitality), or Tech (Spirit)'
return nil
end
 
 
--{{#invoke:HeroData|get_hero_var|HERO_NAME|STAT_NAME|sig_figs_or_localize}}--
--sig_figs optional for rounding floats
p.get_hero_var = function(frame)
    local hero_name = frame.args[1]
    local hero_stat_key = frame.args[2]
    local sig_figs_or_localize = frame.args[3]
   
    local hero = heroes_data[hero_name]
    if(hero == nil) then hero = p.get_json_item(hero_name) end
    if(hero == nil) then return "Hero Not Found" end
   
    -- Check top-level first, then Weapon, then AltFire
    local var_value = hero[hero_stat_key]
     if var_value == nil and hero.Weapon then
        var_value = hero.Weapon[hero_stat_key]
    end
    if var_value == nil and hero.Weapon and hero.Weapon.AltFire then
         var_value = hero.Weapon.AltFire[hero_stat_key]
     end
     end
      
      
     local min_souls = tonumber(min_souls)
     if(var_value == nil) then return 0 end
    local max_souls = tonumber(max_souls)
   
    if min_souls == nil or max_souls == nil then return 'Min/Max souls must be numerical' end
    --round
    if (sig_figs_or_localize ~= nil and tonumber(sig_figs_or_localize) ~= nil) then
        var_value = util_module.round_to_sig_fig(var_value, sig_figs_or_localize)
        if (var_value == nil) then return "get_hero_var() error with rounding" end
    end
   
    --localize
    if (sig_figs_or_localize == "true") then
        return lang_module.get_string(var_value)
    end
 
    return var_value
end
 
--{{#invoke:HeroData|get_alt_fire_var|HERO_NAME|STAT_NAME|sig_figs_or_localize}}--
p.get_alt_fire_var = function(frame)
    local hero_name = frame.args[1]
    local stat_key = frame.args[2]
    local sig_figs_or_localize = frame.args[3]
      
      
     -- Normalize filter_mode
     local hero = heroes_data[hero_name]
     filter_mode = filter_mode or "all"
     if(hero == nil) then hero = p.get_json_item(hero_name) end
    if(hero == nil) then return "Hero Not Found" end
      
      
     -- Retrieve all items that fit the bounds
     if not (hero.Weapon and hero.Weapon.AltFire) then
    local items = {}
        return "No Alt Fire"
    for item_key, item_data in pairs(items_data) do
        -- future proofing; Disabled will be renamed to IsDisabled soon
        local this_cost = tonumber(item_data["Cost"])
        local this_slot = item_data["Slot"]
       
        -- NEW: Filter logic for Street Brawl items
        local is_street_brawl = item_data["StreetBrawl"] == true
        local should_include = true
       
        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 and this_slot ~= nil then
            if slot == this_slot and this_cost >= min_souls and this_cost < max_souls then
                local item_name_english = lang_module.get_string(item_key, "en") -- Get the English name
                local lang_code = lang_module.get_lang_code() -- Get the language code from the subpage
                local item_name_local = lang_module.get_string(item_key, lang_code) -- Get the localized name
               
                -- Construct the template based on the type
                local item_template
                if template == "ItemIcon" then
                    if lang_code == "en" then
                        -- For English pages, do not include lang or localized name
                        item_template = "{{ItemIcon|" .. item_name_english .. "}}"
                    else
                        -- For non-English pages, include lang and localized name
                        item_template = "{{ItemIcon|" .. item_name_english .. "|lang=" .. lang_code .. "|" .. item_name_local .. "}}"
                    end
                elseif template == "ItemBox" then
                    if lang_code == "en" then
                        -- For English pages, do not include item_loc or link
                        item_template = "{{ItemBox|item_name=" .. item_name_english .. "}}"
                    else
                        -- For non-English pages, include item_loc and link
                        local link = item_name_english .. "/" .. lang_code -- Add subpage for non-English languages
                        item_template = "{{ItemBox|item_name=" .. item_name_english .. "|item_loc=" .. item_name_local .. "|link=" .. link .. "}}"
                    end
                else
                    return "Invalid template type"
                end
                table.insert(items, item_template)
            end
        end
     end
     end
      
      
     -- Order list alphabetically
     local var_value = hero.Weapon.AltFire[stat_key]
     table.sort(items) -- O(nlogn)
     if(var_value == nil) then return 0 end
      
      
     -- Add each item to output
     --round
     -- Each item is already wrapped in the template, so no need for additional wrapping
     if (sig_figs_or_localize ~= nil and tonumber(sig_figs_or_localize) ~= nil) then
    local ret = table.concat(items, sep)
        var_value = util_module.round_to_sig_fig(var_value, sig_figs_or_localize)
    end
      
      
     return ret
     --localize
    if (sig_figs_or_localize == "true") then
        return lang_module.get_string(var_value)
    end
 
    return var_value
end
end


-- for [[Template:Item Navbox]]
--{{#invoke:HeroData|get_list_elem|HERO_NAME|VAR|NUMBER|LOCALIZE}}
-- NEW: Added filter parameter support
p.get_list_elem = function(frame)
function p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, filter_mode)
local hero_name = frame.args[1]
    -- Handle the case where it's called via #invoke (i.e., from wikitext)
local var = frame.args[2]
    if type(slot) == "table" and slot.args then
local number_str = frame.args[3]
        local frame = slot
local number_int = tonumber(number_str)
        slot = frame.args[1]
local localize = frame.args[4]
        min_souls = frame.args[2]
        max_souls = frame.args[3]
local hero = heroes_data[hero_name]
        debug_mode = frame.args["debug_mode"]
if(hero == nil) then hero = p.get_json_item(hero_name) end
        filter_mode = frame.args["filter"] -- NEW: grab filter from template args
if(hero == nil) then return "Hero Not Found" end
    end
-- Check top-level first, then Weapon, then AltFire
local list = hero[var]
if list == nil and hero.Weapon then
    list = hero.Weapon[var]
end
if list == nil and hero.Weapon and hero.Weapon.AltFire then
    list = hero.Weapon.AltFire[var]
end
    local sep = ' &bull; '
if (list == nil) then return "" end
local element = list[number_int]
if (element == nil) then return "" end
    local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemIcon", sep, filter_mode)
if localize=="true" then
element = lang_module.get_string(element)
end
return element
end
 
p.get_ability_key = function(frame)
local hero_key = frame.args[1]
local bound_slot_number = frame.args[2]
local hero_data = heroes_data[hero_key]
if (hero_data == nil) then return "Hero key "..hero_key.. " not found" end
local bound_abilities_data = hero_data["BoundAbilities"]
if (bound_abilities_data == nil) then return "Hero key " .. hero_key.. " has no BoundAbilities" end
return bound_abilities_data[tonumber(bound_slot_number)]["Key"]
end
 
p.write_role_playstyle_quote = function(frame)
local hero_key = frame.args[1]
local hero_data = heroes_data[hero_key]
if (hero_data == nil) then return hero_key.." not found" end
local role_key = hero_data["Role"]
local role_localized = lang_module.get_string(role_key, nil, 'en')
local playstyle_key = hero_data["Playstyle"]
local playstyle_localized = lang_module.get_string(playstyle_key, nil, 'en')
    return process_debug_mode(item_list, debug_mode)
local str = "<b>" .. role_localized .. '</b><br>' .. playstyle_localized
local template_args = {}
template_args[1] = ""
template_args[2] = str
return frame:expandTemplate{title = 'Quotation', args = template_args}
end
end


-- for [[Template:Infobox ShopItems]]
p.write_default_items = function(frame)
-- NEW: Added filter parameter support
local hero_key = frame.args[1] --unlocalized
function p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, filter_mode)
if (hero_key == nil) then return "No hero key provided" end
    -- Handle the case where it's called via #invoke (i.e., from wikitext)
local str = ""
    if type(slot) == "table" and slot.args then
local hero = heroes_data[hero_key]
        local frame = slot
if (hero == nil) then return "Hero not found, must be unlocalized" end
        slot = frame.args[1]
local template_title = 'PageRef'
        min_souls = frame.args[2]
for i, item_key in ipairs(hero["RecommendedItems"]) do
        max_souls = frame.args[3]
template_args = {}
        debug_mode = frame.args["debug_mode"]
template_args[1] = lang_module.get_string(item_key, 'en')
        filter_mode = frame.args["filter"] -- NEW: grab filter from template args
template_args['alt_name'] = localize(item_key, item_key)
    end
local expanded_template = mw.getCurrentFrame():expandTemplate{ title = template_title, args = template_args }
str = str .. "* " .. expanded_template .. "\n"
end
return str
end
 
--If the hero scales with the stat, it returns {{Ss|value}} or {{Ls|value}}, else blank string
--{{#invoke:HeroData|get_hero_scalar|HERO_NAME|SCALING_TYPE|STAT_NAME|sig_figs_or_localize}}--
p.get_hero_scalar = function(frame)
local hero_key = frame.args[1]
local scaling_type = frame.args[2]
local hero_stat_key = frame.args[3]
local sig_figs_or_localize = frame.args[4]
    local sep = ' '
local hero_data = heroes_data[hero_key]
if(hero_data == nil) then hero_data = p.get_json_item(hero_key) end
if(hero_data == nil) then return "Hero not found." end
    local item_list = write_wrapped_item_list(slot, min_souls, max_souls, "ItemBox", sep, filter_mode)
local scaling_data = hero_data[scaling_type .. "Scaling"]
if scaling_data == nil then return scaling_type .. "Scaling data not found for hero" .. hero_key end
    return process_debug_mode(item_list, debug_mode)
local scaling_value = scaling_data[hero_stat_key]
if scaling_value == nil then return scaling_type .. "Scaling data does not have key " .. hero_stat_key .. " for hero " .. hero_key end
 
--round
if (sig_figs_or_localize ~= nil and tonumber(sig_figs_or_localize) ~= nil) then
scaling_value = util_module.round_to_sig_fig(scaling_value, sig_figs_or_localize)
if (scaling_value == nil) then return "get_hero_scalar() error with rounding" end
end
--localize
if (sig_figs_or_localize == "true") then
return lang_module.get_string(scaling_value)
end
local scaling_str = p.write_scalar_str(scaling_value, scaling_type)
 
return scaling_str
end
end


-- for [[Template:Item Navbox]] subgroup rows
-- Retrieve scaling string of a hero's given stat, if it has scaling, else return blank
function p.write_item_slot_subgroup(frame)
-- Scaling string meaning the expanded template {{Ss|scalar}} or {{Ls|scalar}}
local slot = frame.args[1]
function p.write_scalar_str(scaling_value, scaling_type)
local type = frame.args[2]
local scaling_abbrevs = {Spirit = "Ss", Level = "PI"}
local debug_mode = frame.args['debug_mode']
local street_brawl_label = frame.args['street_brawl_label'] or "Street Brawl" -- Allow custom label
if slot == nil then return "'slot' parameter is required" end
-- Return blank if it doesnt scale
if (scaling_value == 0) then return "" end
-- Define base args
-- Round it
local template_title = "Navbox subgroup"
scaling_value = util_module.round_to_sig_fig(scaling_value, 3)
local template_args = {
["groupstyle"] = "background-color:" .. util_module.get_slot_color(slot) .. ";width:10%;min-width:70px;border-radius: 8px 0 0 8px",
--The hero has a scaling value with this stat
["grouppadding"] = "5px",
local template_title = "Template:" .. scaling_abbrevs[scaling_type] --scaling type's abbreviation
["listpadding"] = "0 0.25rem",
}
local soul_style = "font-size: 12px; text-shadow: 1px 1px rgba(0, 0, 0, 0.3);"
local template_args = {}
local prices = generic_module.get_item_price_per_tier()
template_args["1"] = scaling_value --store in 1st arg for {{{1}}} to grab it from {{SS}} or {{LS}} template
local group_index = 1 -- Manual index to handle skipped empty groups
for i, souls in ipairs(prices) do
local template_call = mw.getCurrentFrame():expandTemplate{ title = template_title, args = template_args }
--Determine lower bound for soul
return template_call
min_souls = souls
end
 
-- Retrieve scaling value and type of a hero's given stat, if it has scaling, else return 0
function p.get_hero_scaling_data(hero_data, hero_stat_key)
local scaling_type_full
local scaling_data
local scaling_value
local scaling_types = {"Spirit", "Level"}
local scaling_data_returned = {}
for index, scaling_type in ipairs(scaling_types) do
scaling_type_full = scaling_type .. "Scaling"
scaling_data = hero_data[scaling_type_full]
--Skip 0 to i1 as no items cost less than 500
--If the scaling data exists
if min_souls ~= 0 then  
if (scaling_data ~= nil) then
scaling_value = scaling_data[hero_stat_key]
--If the stat scales
if (scaling_value ~= nil) then
scaling_data_returned[scaling_value] = scaling_type
end
end
end
return scaling_data_returned
end
 
-- Checks if a hero has a non-zero base stat OR scaling data for that stat
-- {{#invoke:HeroData|has_stat_or_scaling|HERO_KEY|STAT_NAME}} returns "1" if true, empty if false
p.has_stat_or_scaling = function(frame)
    local hero_key = frame.args[1]
    local stat_key = frame.args[2]
   
    if not hero_key or not stat_key then return "" end
   
    local hero_data = heroes_data[hero_key]
    if hero_data == nil then hero_data = p.get_json_item(hero_key) end
    if hero_data == nil then return "" end
   
    -- Check base value (uses existing helper function)
    local base_value = get_nested_stat_value(hero_data, stat_key)
    if base_value ~= 0 then
        return "1"  --Truthy value for #if
    end
   
    -- Check scaling data (both Level and Spirit scaling)
    local scaling_data = p.get_hero_scaling_data(hero_data, stat_key)
    if scaling_data ~= nil and next(scaling_data) ~= nil then
        return "1"  --Has scaling data
    end
   
    return ""  --Falsy value for #if
end
 
--HERO_NAME in english
--{{#invoke:HeroData|write_infobox|HERO_NAME}}--
p.write_infobox = function(frame)
-- Get hero data
    hero_key = frame.args[1]
    hero_data = heroes_data[hero_key]
    if(hero_data == nil) then return "Hero " .. hero_key .. " Not Found" end
   
    local infobox_attributes = {
        Weapon = {'DPS','ClipSize','RoundsPerSecond','ReloadTime'},
        Vitality = {'MaxHealth','BulletResist','TechResist','MaxMoveSpeed'}
    }
   
    -- Declarations and initializations
    local category_data = attribute_module.get_category_data()
    local stats
    local stat_data
    local stat_value
    local stat_text
    local label
    local postfix
    local should_display
    local image_file_name
    local image_file
    local icon_and_value_str
    local template_args = {}
    local stat_values = {Weapon = "", Vitality = ""}
   
    -- Add the main parameters
    template_args["name_english"] = lang_module.get_string(hero_key, 'en')
    template_args["name_localized"] = localize(hero_key, hero_key)
   
    -- Iterate attribute categories
    for category, stats in pairs(infobox_attributes) do
-- Iterate stats
for _, stat_name in ipairs(stats) do
-- Confirm its in attribute data and retrieve it
attribute_data = attributes_data[category]
if (attribute_data == nil) then return "Category " .. category .. " in infobox_attributes is not in Data:AttributeData" end
stat_data = attribute_data[stat_name]
if (stat_data == nil) then return "Attribute " .. stat_name .. " in infobox_attributes is not in Data:AttributeData" end
-- Determine upper bound
-- gets the stat's value
max_souls = prices[i+1]
stat_value = hero_data[stat_name]
if max_souls == nil then  
if (stat_value == nil) then
max_souls = min_souls * 10 --essentially have no upper bound
    -- Check nested weapon stats
    if hero_data.Weapon and hero_data.Weapon[stat_name] ~= nil then
        stat_value = hero_data.Weapon[stat_name]
    elseif hero_data.Weapon and hero_data.Weapon.AltFire and hero_data.Weapon.AltFire[stat_name] ~= nil then
        stat_value = hero_data.Weapon.AltFire[stat_name]
    else
        stat_value = 0 --default to 0 if not present
    end
end
end
--Round value to 3 significant figures
stat_value = util_module.round_to_sig_fig(stat_value, 3)
-- Generate list for this price tier, EXCLUDING Street Brawl items
-- get label and postfix
local list
label = localize(stat_data["label"], stat_name)
if type=='get_item_nav_cards' then
postfix = stat_data["postfix"]
list = p.get_item_nav_cards(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
if (postfix == nil) then  
elseif type=='get_item_nav_bulletpoints' then
postfix = ""
list = p.get_item_nav_bulletpoints(slot, min_souls, max_souls, debug_mode, "exclude_street_brawl")
else
else
return "'type' should be get_item_nav_cards or get_item_nav_bulletpoints"
-- light grey for postfixes
postfix = lang_module.get_string(postfix)
if (postfix == nil) then
postfix = ""
end
postfix = '<span style="color: #666666;">' .. postfix .. "</span>"
end
end
-- if a language is missing the postfix, use no postfix
-- Check if icon file exists, and if not, don't use any image
image_file_name = 'File:AttributeIcon' .. stat_name .. '.png'
image_file = util_module.get_image_file(image_file_name, 15, stat_name)
-- Only add the group if there are items in this tier (prevents empty "$9999" row if all are Street Brawl)
-- Create the template'd icon
if list and list ~= "" then
local icon_color = attribute_module.get_attr_icon_color(stat_name)
template_args["group" .. group_index] = frame:expandTemplate{title="Souls", args={[1] = min_souls, ["Shadow"] = soul_style}}
icon_template_title = mw.title.new("Template:Icon/" .. icon_color)
template_args["list" .. group_index] = list
icon_template_args = {}
group_index = group_index + 1
icon_template_args[1] = image_file
icon_template_args[2] = stat_value .. postfix
icon_and_value_str = mw.getCurrentFrame():expandTemplate{ title = icon_template_title, args = icon_template_args }
label =  ',<span style="color: #999999; background-color: #2F2F2F; display: inline-flex; width: 100%; height: 100%; justify-content: center; align-items: center;">' .. label .. '</span>'
-- First add localized stat name for left column
stat_values[category] = stat_values[category] .. label
-- Then add icon and stat value for right column
stat_values[category] = stat_values[category] .. ',' .. icon_and_value_str
end
-- Add the stat values in the category to i.e weapon_values and vitality_values parameters
template_args[string.lower(category) .. "_values"] = stat_values[category]
end
   
    -- Use expandTemplate to evaluate the Infobox_hero template
    local template_title = mw.title.new("User:Sur")
    local expanded_template = mw.getCurrentFrame():expandTemplate{ title = template_title, args = template_args }
   
    return expanded_template
end
 
 
--{{#invoke:HeroData|write_stat_infoboxes|HERO_KEY}}
--Creates {{Infobox_stat}}'s' for the 3 categories Weapon, Vitality, Spirit
p.write_stat_infoboxes = function(frame)
local hero_key = frame.args[1]
if(hero_key == nil) then return "Hero parameter missing" end
-- Use expandTemplate to evaluate the Infobox_hero template
    local template_title = mw.title.new("Template:Infobox_stat") --name of the template
    local template_calls = '<div style="display: flex; flex-direction: column;">' --all template calls concatenated
    local template_call --current template call
local template_args = {} --current template arguments
local cell_values --current cell values
local cell_value --current cell value
local label --current stat's label
local postfix --current stat's postfix
local stat_value --current stat's numerical value in the hero data
local hero_data = heroes_data[hero_key]
local stats --stats of the current category
local image_file_name --name of the image_file to check
local image_file --mw returned image file
local extra_blank_cell --add a blank cell after certain stats
local stats_to_add_blank_after = {CritDamageReceivedPercent = true}
if (hero_data == nil) then return "Hero Not Found" end
local category_data = attribute_module.get_category_data()
local should_display
for _, category in ipairs(attribute_orders["category_order"]) do
if (category ~= "Spirit") then --hide Spirit section for now
stats = attributes_data[category]
local category_values = category_data[category]
template_args["box_name"] = category_values.unlocalized_name
template_args["box_rgb"] = category_values.rgb
template_args["num_cols"] = 2
cell_values = ""
-- Determine cell values
for _, stat_name in ipairs(attribute_orders[category]["attribute_order"]) do
local stat_data = stats[stat_name]
if stat_data == nil then return "Stat " .. stat_name .. " from StatInfoboxOrder has no data in AttributeData" end
-- gets the stat's value if it has that stat, default to 0 if not
stat_value = hero_data[stat_name]
if (stat_value == nil) then
    -- Check nested weapon stats
    if hero_data.Weapon and hero_data.Weapon[stat_name] ~= nil then
        stat_value = hero_data.Weapon[stat_name]
    elseif hero_data.Weapon and hero_data.Weapon.AltFire and hero_data.Weapon.AltFire[stat_name] ~= nil then
        stat_value = hero_data.Weapon.AltFire[stat_name]
    else
        stat_value = 0 --default to 0 if not present
    end
end
--Round value to 3 significant figures
stat_value = util_module.round_to_sig_fig(stat_value, 3)
-- get label and postfix
label = localize(stat_data["label"], stat_name)
postfix = stat_data["postfix"]
if (postfix == nil) then
postfix = ""
else
-- light grey for postfixes
postfix = '<span style="color: #666666;">' .. lang_module.get_string(postfix) .. "</span>"
end
-- if a language is missing the postfix, use no postfix
if (postfix == nil) then
postfix = ""
end
-- Check if icon file exists, and if not, don't use any image
image_file_name = 'File:AttributeIcon' .. stat_name .. '.png'
-- 15px and link to stat name (page name might not match perfectly yet)
image_file = util_module.get_image_file(image_file_name, 15, stat_name)
-- Create the template'd icon
local icon_color = attribute_module.get_attr_icon_color(stat_name)
if (icon_color == "Brown") then
image_file = '<span style="position: relative; bottom: 2px; filter: invert(42%) sepia(10%) saturate(2912%) hue-rotate(351deg) brightness(90%) contrast(87%);">' .. image_file .. '</span>'
end
-- use white instead of grey if grey is returned
-- Add an empty cell following some stats to align them correctly as seen in game
if (stats_to_add_blank_after[stat_name]) then
extra_blank_cell = " ," --prefixed space is needed
else
extra_blank_cell = ""
end
-- slightly lighter color for stat name
label = '<span style="color: #3d3d3d;">' .. label .. '</span>'
-- Add the scaling str if it scales
local scaling_data = p.get_hero_scaling_data(hero_data, stat_name)
local scaling_strs = ""
if (scaling_data ~= nil) then
for scaling_value, scaling_type in pairs(scaling_data) do
local scaling_str = p.write_scalar_str(scaling_value, scaling_type)
if (scaling_str ~= "") then scaling_str = " " .. scaling_str end
scaling_strs = scaling_strs .. scaling_str
end
end
-- Set cell value as "Icon StatvaluePostfix Statname Scaling,"
-- If icon file already exists, set it to #REDIRECT to the duplicate file page
cell_value = image_file .. " " .. stat_value  .. postfix .. " " .. label  .. scaling_strs .. "," .. extra_blank_cell
cell_values = cell_values .. cell_value --add value to values list
end
end
template_args["cell_values"] = cell_values
-- Write current call
template_call = mw.getCurrentFrame():expandTemplate{ title = template_title, args = template_args }
-- Add call to the set of calls
template_calls = template_calls .. "\n" .. template_call
end
end
end
end
-- Query all Street Brawl items for this slot (regardless of cost)
return template_calls .. "</div>"
local sb_min = 0
end
local sb_max = 999999 -- Wide range to catch all Street Brawl items
 
local function get_nested_stat_value(hero_data, stat_key)
    -- Check top-level, then Weapon, then AltFire
    if hero_data[stat_key] ~= nil then
        return hero_data[stat_key]
    elseif hero_data.Weapon and hero_data.Weapon[stat_key] ~= nil then
        return hero_data.Weapon[stat_key]
    elseif hero_data.Weapon and hero_data.Weapon.AltFire and hero_data.Weapon.AltFire[stat_key] ~= nil then
        return hero_data.Weapon.AltFire[stat_key]
    end
    return 0
end
 
--writes the massive hero comparison table for a specific PI and SP
-- scaling icons are shown only if PI and SP are both 0 or both not provided
--{{#invoke:HeroData|write_hero_comparison_table|POWER_INCREASES|SPIRIT_POWER}}
p.write_hero_comparison_table = function(frame)
-- process inputs
local power_increases = frame.args[1]
if (power_increases == nil) then power_increases = 0 end
local spirit_power = frame.args[2]
if (spirit_power == nil) then spirit_power = 0 end
local sb_list
-- Show scaling icons if power/increases/spirit power are 0/not specified
if type=='get_item_nav_cards' then
local display_scaling_icons = false
sb_list = p.get_item_nav_cards(slot, sb_min, sb_max, debug_mode, "street_brawl_only")
if (power_increases == 0 and spirit_power == 0) then
elseif type=='get_item_nav_bulletpoints' then
display_scaling_icons = true
sb_list = p.get_item_nav_bulletpoints(slot, sb_min, sb_max, debug_mode, "street_brawl_only")
end
end
-- Only add Street Brawl group if there are items
-- Initializations and declarations
if sb_list and sb_list ~= "" then
local row_str = ""
template_args["group" .. group_index] = street_brawl_label
local body_str = ""
template_args["list" .. group_index] = sb_list
local in_development
local is_disabled
local template_title = ""
local template_args = {}
local hero_icon
local hero_td_style
local scalar_str
-- Add hero comp stats to
local stats_to_include = {
Weapon = {
"DPS",
            "SustainedDPS",
            "BulletDamage",
            "RoundsPerSecond",
            "FireRate",
            "ClipSize",
            "ReloadTime",
            "ReloadDelay",
            "BulletsPerShot",
            "BulletsPerBurst",
            "BurstInterShotInterval",
            "LightMeleeDamage",
            "HeavyMeleeDamage",
            "ReloadSingle",
            "BulletSpeed",
            "BulletGravityScale",
            "FalloffStartRange",
            "FalloffEndRange",
            "BonusAttackRange",
            "CritDamageBonusPercent",
            "RoundsPerSecondAtMaxSpin",
            "SpinAcceleration",
            "SpinDeceleration"
},
Vitality = {
"MaxHealth",
            "BaseHealthRegen",
            "BulletResist",
            "TechResist",
            "MeleeResist",
            "BulletLifesteal",
            "CritDamageReceivedPercent",
            "MaxMoveSpeed",
            "SprintSpeed",
            "StaminaCooldown",
            "Stamina"
},
    Spirit = {
"TechPower"
}
}
-- Iterate heroes
for hero_key, hero_data in pairs(heroes_data) do
-- Ensure they are not in development and they are an active hero
in_development = hero_data["InDevelopment"]
if (not in_development) then
is_disabled = hero_data["IsDisabled"]
if (not is_disabled) then
--Add the row's stats
row_str = ""
-- Retrieve hero's localized name
hero_name = localize(hero_key, hero_key)
-- Retrieve hero's english name, used for hero icon
hero_name_en = hero_data["Name"]
-- Expand hero icon
template_title = "Template:HeroIcon"
template_args[1] = hero_name_en
template_args[2] = hero_name
hero_icon = mw.getCurrentFrame():expandTemplate{ title = template_title, args = template_args }
-- First column in each row is hero name
row_str = row_str .. "<td>" .. hero_icon .. "</td>"
-- Consecutive columns are then stats
-- Iterate categories
for _, category in ipairs(attribute_orders["category_order"]) do
category_attrs = attributes_data[category]
-- Iterate attributes within the category
if (stats_to_include[category] ~= nil) then
for _, attr_key in ipairs(stats_to_include[category]) do
--Retrieve the stats value from hero data
stat_value = get_nested_stat_value(hero_data, attr_key)
-- Retrieve scaling val and str if it scales
local scaling_data = p.get_hero_scaling_data(hero_data, attr_key)
local scaling_strs = ""
if (scaling_data ~= nil) then
for scaling_value, scaling_type in pairs(scaling_data) do
local scaling_str = p.write_scalar_str(scaling_value, scaling_type)
if (scaling_str ~= "") then scaling_str = " " .. scaling_str end
if (scaling_str ~= nil) then
scaling_strs = scaling_strs .. scaling_str
end
-- Scale the stat value
if (scaling_type == "Spirit") then
stat_value = stat_value + (spirit_power * scaling_value)
elseif (scaling_type == "Level") then
if attr_key == 'TechResist' or attr_key == 'BulletResist' then
-- each PI for resists is multiplicative
stat_value = (stat_value/100 + 1 - (1-scaling_value/100)^power_increases)*100
else
stat_value = stat_value + (power_increases * scaling_value)
end
end
end
end
if (not display_scaling_icons) then scaling_strs = "" end
-- Convert from boolean to string, or round it
if (type(stat_value)) == 'boolean' then
stat_value = tostring(stat_value)
else
stat_value = util_module.round_to_sig_fig(stat_value, 3)
end
-- Add it to the row
row_str = row_str .. "<td>" .. stat_value .. scaling_strs .. "</td>"
end
end
end
-- Add row to the body
row_str = "<tr>" .. row_str .. "</tr>"
body_str = body_str .. row_str
first_hero = false
end
end
end
end
return frame:expandTemplate{title=template_title, args=template_args}
-- First header is Hero
local headers_str = "<th>" .. "Hero" .. "</th>"
local header_style = ""
local category_data = attribute_module.get_category_data()
local postfix
-- Used for keys that are not localized by Valve
local postfix_key_map = {
["ReloadDelay"] = "StatDesc_ReloadTime_postfix",
["BulletsPerShot"] = "",
["BulletsPerBurst"] = "",
["BurstInterShotInterval"] = "StatDesc_ReloadTime_postfix",
["ReloadSingle"] = "",
["BonusAttackRange"] = "StatDesc_WeaponRangeFalloffMax_postfix",
["SustainedDPS"] = "DPS_postfix",
["RoundsPerSecondAtMaxSpin"] = "",
["CritDamageBonusScale"] = "StatDesc_CritDamageBonusScale_postfix",
["BonusCritDamagePercent"] = "BonusCritDamagePercent_postfix",
["BulletLifesteal"] = "BulletLifestealPercentHero_postfix",
}
-- Iterate stats again for displaying headers with their respective color
for _, category in ipairs(attribute_orders["category_order"]) do
category_attrs = attributes_data[category]
category_rgb = category_data[category]["rgb"]
-- Iterate attributes within the category
if (stats_to_include[category] ~= nil) then
for _, attr_key in ipairs(stats_to_include[category]) do
attr_data = category_attrs[attr_key]
if (attr_data ~= nil) then
-- Localize, fallback to attr_key with proper spaces
attr_localized = lang_module.get_string(attr_data["label"])
if (attr_localized == nil or attr_localized == "") then attr_localized = util_module.add_space_before_cap(attr_key) end
-- Get postfix
postfix = lang_module.get_string(attr_data["postfix"])
if (postfix == nil or postfix == "") then
postfix = ""
else
postfix = " (" .. postfix .. ")"
end
else -- If not in attributes data, use dictionary translate and postfix
attr_localized = dictionary_module.translate(attr_key)
postfix = lang_module.get_string(postfix_key_map[attr_key])
if postfix == nil then
return "attr_key " .. attr_key .. " must be added to postfix_key_map"
end
if postfix ~= "" then
postfix = " (" .. postfix .. ")"
end
end
header_style = ' style="background-color: ' .. "rgb(" .. category_rgb .. ') ;"'
headers_str = headers_str .. "<th" .. header_style .. ">" .. attr_localized .. postfix .. "</th>"
end
end
end
headers_str = "<tr>" .. headers_str .. "</tr>"
 
local table_str = '<table class="wikitable sortable" style="table-layout: auto; width: 100%;">' .. headers_str .. body_str .. "</table>"
local output_str = '<div style="overflow-x: auto; width: 100%;">' .. table_str .. '</div>'
return output_str
end
 
function localize(key, fallback)
local result = lang_module.get_string(key)
if (result == "") or (result == nil) then
result = util_module.add_space_before_cap(fallback) .. mw.getCurrentFrame():expandTemplate{title="MissingValveTranslationTooltip"}
end
return result
end
 
-- Mapping from hero name to internal tag name
local TAG_NAME_MAP = {
["Abrams"] = "Abrams",
["Bebop"] = "Bebop",
["Billy"] = "Punkgoat",
["Calico"] = "Nano",
["The Doorman"] = "Doorman",
["Drifter"] = "Drifter",
["Dynamo"] = "Dynamo",
["Apollo"] = "Fencer",
["Graves"] = "Necro",
["Grey Talon"] = "Orion",
["Haze"] = "Haze",
    ["Holliday"] = "Astro",
    ["Infernus"] = "Inferno",
    ["Ivy"] = "Tengu",
    ["Kelvin"] = "Kelvin",
    ["Lady Geist"] = "Geist",
    ["Lash"] = "Lash",
    ["McGinnis"] = "Engineer",
    ["Mina"] = "VampireBat",
    ["Mirage"] = "Mirage",
    ["Mo & Krill"] = "Digger",
    ["Paige"] = "Bookworm",
    ["Paradox"] = "Chrono",
    ["Celeste"] = "Unicorn",
    ["Pocket"] = "Synth",
    ["Rem"] = "Familiar",
    ["Seven"] = "Gigawatt",
    ["Shiv"] = "Shiv",
    ["Silver"] = "Werewolf",
    ["Sinclair"] = "Magician",
    ["Venator"] = "Priest",
    ["Victor"] = "Frank",
    ["Vindicta"] = "Vindicta",
    ["Viscous"] = "Viscous",
    ["Vyper"] = "Viper",
    ["Warden"] = "Warden",
    ["Wraith"] = "Wraith",
    ["Yamato"] = "Yamato",
}
 
-- Function to call hero tags based on name
p.get_hero_tag = function (frame)
    local name = frame.args[1]
    local number = tonumber(frame.args[2])
 
    -- Validate input
    if not name then
        return "Error: Missing name input."
    end
 
    if number ~= 1 and number ~= 2 and number ~= 3 then
        return string.format("Error: Invalid number '%s'. Must be 1, 2, or 3.", tostring(frame.args[2]))
    end
 
    local tagname = TAG_NAME_MAP[name]
    if not tagname then
        return string.format("Error: Unknown name '%s'.", name)
    end
 
    -- Build localization key
    local key = string.format("Citadel_%s_HeroTag_%d", tagname, number)
 
    -- Call Lang.get_string
    local result = lang_module.get_string(key)
 
    return result or ("[Missing string for key: " .. key .. "]")
end
end


-- for [[Template:Active Items]]
-- Outputs a wikitable of heroes grouped by GroundDashDuration using {{HeroIcon|hero_name}}
function p.generate_active_items_table(frame)
-- {{#invoke:HeroData|write_ground_dash_buckets}}
     local active_items = {}
p.write_ground_dash_buckets = function(frame)
      
     local buckets = {
     -- 1. Collect active items and their cost
        [0.62] = {},
     for item_key, item_data in pairs(items_data) do
        [0.68] = {},
         -- Convert cost to a number; will be nil if the JSON value is null or missing
        [0.70] = {},
        local cost = tonumber(item_data["Cost"])
     }
       
 
        if item_data["Name"] and
    local get_dash = function(hero)
          item_data["IsDisabled"] == false and
        return hero.GroundDashDuration
          cost ~= nil and cost > 0 and            -- FILTER: Must have a cost greater than 0
            or (hero.Weapon and hero.Weapon.GroundDashDuration)
          item_data["Activation"] and  
            or (hero.Weapon and hero.Weapon.AltFire and hero.Weapon.AltFire.GroundDashDuration)
          item_data["Activation"] ~= "Passive" then
    end
           
 
            table.insert(active_items, {
     -- Collect heroes
                name = item_data["Name"],
     for hero_key, hero_data in pairs(heroes_data) do
                key = item_key,
         if not hero_data.InDevelopment and not hero_data.IsDisabled then
                cost = cost,
            local dash = get_dash(hero_data)
                slot = item_data["Slot"] or "Weapon",
            if dash and buckets[dash] then
                has_active_desc = item_data["ActiveDescription"] ~= nil
                table.insert(buckets[dash], hero_data.Name or hero_key)
             })
             end
         end
         end
     end
     end
   
 
     -- 2. Sort by name
     -- Sort alphabetically
     table.sort(active_items, function(a, b) return a.name < b.name end)
     for _, list in pairs(buckets) do
   
        table.sort(list)
     -- 3. Generate wiki markup
    end
     local wikitext = [=[
 
{| class="wikitable sortable" style="width:100%"
     -- Determine max rows dynamically
|+{{#invoke:Dictionary|translate|Active Items}}
     local max_rows = 0
! colspan="2" | {{#invoke:Lang|get_string|Citadel_HeroBuilds_CategoryNameLabel}}
    for _, list in pairs(buckets) do
! {{#invoke:Lang|get_string|Citadel_UserFeedback_TypeLabel}}
        if #list > max_rows then max_rows = #list end
! {{Souls|{{#invoke:Dictionary|translate|Cost}}}}
    end
! {{#invoke:Lang|get_string|Citadel_Mod_Tooltip_Active}}
 
! {{#invoke:Lang|get_string|AbilityCooldown_label}}
    local output = {"{| class='wikitable'", "! Bucket 1 !! Bucket 2 !! Bucket 3"}
]=]
    local current_frame = frame or mw.getCurrentFrame()
   
 
     -- 4. Add rows for each item
     for i = 1, max_rows do
    for _, item in ipairs(active_items) do
        local row = {}
        -- Determine background color and item type
        for _, bucket in ipairs({0.62, 0.68, 0.70}) do
        local bg_color, item_type
            local hero_name = buckets[bucket][i]
        if item.slot == "Armor" then
             table.insert(row, hero_name and current_frame:expandTemplate{title = "HeroIcon", args = {hero_name}} or "")
             bg_color = "#86C921"
            item_type = "Armor"
        elseif item.slot == "Tech" then
            bg_color = "#DE9CFF"
            item_type = "Tech"
        else
            bg_color = "#FCAC4D"
            item_type = "Weapon"
         end
         end
          
         table.insert(output, "|-\n| " .. table.concat(row, " || "))
        -- The cost cell uses 'data-sort-value' to provide a clean number for the client-side sorter,
        -- while the cell's visible content is formatted by the {{Souls}} template.
        wikitext = wikitext .. "\n" .. 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}}
| style="text-align:center;font-size:16px" | {{#invoke:ItemData|get_prop|%s|AbilityCooldown}}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,
            item.name)
     end
     end
   
 
     wikitext = wikitext .. "\n|}"
     table.insert(output, "|}")
   
     return table.concat(output, "\n")
     return frame:preprocess(wikitext)
end
end


return p
return p
Retrieved from "https://deadlock.wiki/Module:Sandbox/LVL"