Module:AbilityHints

2026-07-16T06:48:01Z

~2026-CoverMirageLifesteal670: update tooltip for stealth (it's vergir)

-- Small item icons on ability cards showing how an ability interacts with items (dispellable, reduced, blocked, etc.).
-- Used by Template:AbilitySection. Styles are there too.

local AbilityTable = require("Module:AbilityTable")
local ability_data = mw.loadJsonData("Data:AbilityData.json")
local resource_lookup = mw.loadJsonData("Data:ResourceLookup.json")
local item_data = mw.loadJsonData("Data:ItemData.json")

local p = {}

-- Automatic hints that get shown without corresponding {{AbilityInteraction}}. Powered by Module:AbilityTable
local CONFIG = {
{ list = "melee", file = "Melee Lifesteal.png", tip = "Benefits from melee items (e.g. [[Melee Lifesteal]])" },
{ list = "dontbreakstealth", file = "Veil Walker.png", tip = "Casting does not break stealth from [[Veil Walker]] or [[Shadow Weave]]" },
{ list = "movementbased", file = "Slowing Hex.png", tip = "Disabled by [[Slowing Hex]]" },
{ list = "debuffresist", file = "Debuff Reducer.png", tip = "Debuff duration reduced by [[Debuff Resist]]" },
{ list = "heal", file = "Healing Booster.png", tip = "[[Healing]] amplified by [[Healing Booster]] and affected by healing reduction" },
{ list = "reactivebarrier", file = "Reactive Barrier.png", tip = "Triggers [[Reactive Barrier]]" },
{ list = "dispelmagic", file = "Dispel Magic.png", tip = "Effect can be [[Dispel Magic|dispelled]]" },
{ list = "indomitable", file = "Indomitable.png", tip = "Disable prevented by [[Indomitable]]" },
{ list = "unstoppable", file = "Unstoppable.png", tip = "Negative status effects suppressed by [[Unstoppable]]" },
{ list = "platedarmor", file = "Plated Armor.png", tip = "On-shot effect prevented by [[Plated Armor]]" },
{ list = "summons", file = "Monster Rounds.png", tip = "Summons affected by [[Monster Rounds]] and [[Heroic Aura]]" },
}

-- Display order: item slot (Weapon, then Vitality, then Spirit), then cost, then name.
local function sort_key(file)
local base = mw.ustring.lower((file:gsub('%.%w+$', '')))
local entry = resource_lookup[base]
local item = (entry ~= nil and entry.type == 'item') and item_data[entry.key] or nil
if item == nil then
return { 99, math.huge, base }
end
local slot = item["Slot"]
local slot_rank = (slot == "Weapon" and 1) or (slot == "Armor" and 2) or (slot == "Tech" and 3) or 98
return {
slot_rank,
tonumber(item["Cost"]) or math.huge,
mw.ustring.lower(item["Name"] or base),
}
end

local function compare(a, b)
for i = 1, 3 do
if a.sort[i] ~= b.sort[i] then return a.sort[i] < b.sort[i] end
end
return false
end

-- partial: split the icon so the top-left half is grayscale (mirrors the iconbox-partial box icon).
-- An empty link makes the icon non-clickable; automatic hints link from their tooltip text instead.
local function icon_img(file, link, partial)
link = link or ''
if partial then
return ''
.. '[[File:' .. file .. '|24px|link=' .. link .. ']]'
.. '[[File:' .. file .. '|24px|link=]]'
.. ''
end
return '[[File:' .. file .. '|24px|link=' .. link .. ']]'
end

local function hint_icon(def)
return '' .. icon_img(def.file)
.. '' .. def.tip .. ''
end

local function manual_icon(m)
local cls = 'ability-hint'
local verb = 'Interacts with'
local partial = false
if m.state == 'disabled' then
cls = cls .. ' ability-hint--disabled'
verb = 'Does not interact with'
elseif m.state == 'partial' then
verb = 'Interacts partially with'
partial = true
end
return '' .. icon_img(m.file, '#' .. m.anchor, partial)
.. '' .. verb .. ' ' .. m.title .. '. Click to reveal more info.'
end

function p.get_icons(ability_key, ability_num, manual)
manual = manual or {}

local manual_by_file = {}
for _, m in ipairs(manual) do
manual_by_file[mw.ustring.lower(m.file)] = m
end

local entries = {}
local placed = {}

local record = ability_data[ability_key]
if record ~= nil then
local num = tonumber(ability_num)
for _, def in ipairs(CONFIG) do
if AbilityTable.is_member(def.list, record, num) then
local key = mw.ustring.lower(def.file)
local m = manual_by_file[key]
if m ~= nil then
table.insert(entries, { file = m.file, html = manual_icon(m) })
placed[key] = true
else
table.insert(entries, { file = def.file, html = hint_icon(def) })
end
end
end
end

for _, m in ipairs(manual) do
if not placed[mw.ustring.lower(m.file)] then
table.insert(entries, { file = m.file, html = manual_icon(m) })
end
end

if #entries == 0 then return '' end

for _, e in ipairs(entries) do e.sort = sort_key(e.file) end
table.sort(entries, compare)

local icons = {}
for _, e in ipairs(entries) do table.insert(icons, e.html) end

return '<div class="ability-section-hints">' .. table.concat(icons) .. '</div>'
end

return p

The Deadlock Wiki - User contributions [en]

Module:AbilityHints