Module:MapObjectsData

Description

The BuildingsData module provides a centralized interface to retrieve adventure map object data from the MapObject Cargo table and their localized strings from the Translation Cargo table.

It is designed to be "page-aware," meaning it can automatically identify the correct object ID and language based on the current page title (e.g., handling subpages and language suffixes).

Syntax

{{#invoke:BuildingsData|get|id=|field=|language=}}

Parameters

• id (optional): The unique object ID (e.g., barracks_unfrozen_6) or english building name (e.g., Bloated Mansion). If omitted, the module attempts to detect it from the current page title.
• field (required): The specific data field to retrieve.
• language (optional): The language code (e.g., fr, de). If omitted, the module attempts to detect it from the page title suffix (e.g., /fr).

Available Fields

Localization (from Translation table)

• name, description (using type map_object)
• narrative (using type map_object_narrative)

Technical (from MapObject table)

• category, goods_value, ai_value, custom_guard_value, view_radius, guard_units, fraction, tier, resource_name, resource_value, source_path

Examples

Automatic Mode

If you are currently viewing the page Bloated Mansion/fr, the module automatically identifies the object and the language:

{{#invoke:BuildingsData|get|field=name}}

• Result:

{{#invoke:BuildingsData|get|field=narrative}}

• Result:

Manual Mode

To fetch specific data regardless of the current page:

{{#invoke:BuildingsData|get|id=barracks_unfrozen_6|field=tier}}

• Result:

Technical Notes

• ID Detection: The module cleans the page title by removing subpages (text after /) and parenthetical text to match the entity name in the database.
• Fallback: If a name request returns no data, the system relies on the object's category field for identification.

---

local p = {}

-- Fonction utilitaire robuste avec valeur par défaut
local function getTrans(target_id, type, lang, field, variant, default)
    local query_where = string.format("target_id = '%s' AND type = '%s' AND language = '%s'", target_id, type, lang)
    if variant then query_where = query_where .. string.format(" AND variant = '%s'", variant) end
    
    local res = mw.ext.cargo.query("Translation", field, { where = query_where, limit = 1 })
    local result = (res and #res > 0) and res[1][field] or ""
    
    return (result ~= "") and result or (default or "")
end

-- Fonction pour créer la carte des liens (Nom -> ID)
local function getSkillLinkMap(lang)
    local results = mw.ext.cargo.query('Translation', 'target_id, name', {
        where = "type = 'skill' AND language = '" .. lang .. "' AND variant = 'production'",
        limit = 500
    })
    local map = {}
    for _, row in ipairs(results) do
        map[row.name] = row.target_id
    end
    return map
end

-- Fonction pour remplacer les noms de skills par des liens wiki
local function linkSkillsInText(text, lang, linkMap)
    -- On crée une table pour le remplacement sensible à la casse
    -- On trie les noms par longueur décroissante pour traiter "Advanced Offense" avant "Offense"
    local sortedNames = {}
    for name, id in pairs(linkMap) do
        table.insert(sortedNames, name)
    end
    table.sort(sortedNames, function(a, b) return #a > #b end)
    
    -- On utilise un remplacement global en une seule passe
    for _, name in ipairs(sortedNames) do
        local id = linkMap[name]
        local replacement = "[[" .. id .. "/" .. lang .. "|" .. name .. "]]"
        
        -- Pattern : %f[%a] (frontière de mot), ensuite le nom, puis %f[%A]
        -- On utilise mw.ustring.gsub
        -- Le flag '1' dans le gsub précédent était le problème : il n'en remplaçait qu'un seul.
        -- Ici, on fait un remplacement global sans le '1'.
        local pattern = "(%f[%a])" .. mw.ustring.escapePattern(name) .. "(%f[%A])"
        
        -- On ajoute une condition pour ne pas remplacer si le nom est DÉJÀ dans un lien
        -- On cherche si le texte n'est pas précédé de "[[".
        text = mw.ustring.gsub(text, "([^%[])" .. pattern, function(prefix, p1, p2)
            -- prefix est le caractère avant, p1 la frontière, p2 la frontière après
            return prefix .. p1 .. replacement .. p2
        end)
    end
    
    return text
end

-- Fonction pour récupérer les infos d'un SubSkill
local function getSubSkillInfo(sub_id, lang, linkMap)
    local sub_def = mw.ext.cargo.query("SubSkill", "icon", { where = string.format("id = '%s'", sub_id), limit = 1 })
    local icon = (sub_def and #sub_def > 0) and sub_def[1].icon or "Placeholder"
    local name = getTrans(sub_id, "sub_skill", lang, "name")
    local desc = getTrans(sub_id, "sub_skill", lang, "description")
    -- Application des liens
    desc = linkSkillsInText(desc, lang, linkMap)
    return { name = name, desc = desc, icon = icon }
end

function p.display(frame)
    local skill_id = frame.args["id"] or frame.args[1]
    if not skill_id then return "ID requis" end
    local lang = frame.args.language or "en"
    
    -- Préparation de la carte des liens
    local linkMap = getSkillLinkMap(lang)
    
    local hSkill = getTrans("wiki_skills", "wiki", lang, "name", nil, "Skills")
    local hSub = getTrans("wiki_sub_skills", "wiki", lang, "name", nil, "Subskills")
    
    local levels = mw.ext.cargo.query("SkillLevel", "level, icon, offered_sub_skills", {
        where = string.format("skill_id = '%s'", skill_id),
        orderBy = "level ASC"
    })
    
    if not levels or #levels == 0 then return "Aucun niveau trouvé." end
    
    local html = {'{| class="wikitable" style="width:100%; border-collapse:collapse;"'}
    table.insert(html, '! colspan=2 | ' .. hSkill .. ' !! colspan=6 | ' .. hSub)

    for _, lvl in ipairs(levels) do
        local name = getTrans(skill_id, "skill_level", lang, "name", lvl.level)
        local desc = getTrans(skill_id, "skill_level", lang, "description", lvl.level)
        -- Application des liens sur la description principale
        desc = linkSkillsInText(desc, lang, linkMap)
        
        local icon = (lvl.icon and lvl.icon ~= "") and lvl.icon or "Placeholder"
        
        table.insert(html, '|- style="vertical-align:top;"')
        table.insert(html, '| style="width:70px; border-right:0px;" | [[File:' .. icon .. '.png|70px]]')
        table.insert(html, '| style="border-left:0px; width:200px;" | \'\'\'' .. name .. '\'\'\' <br /><br />' .. desc .. '')
        
        local subs = {}
        if lvl.offered_sub_skills then
            for s in string.gmatch(lvl.offered_sub_skills, "([^,]+)") do table.insert(subs, s) end
        end
        
        for i = 1, 3 do
            if subs[i] then
                local info = getSubSkillInfo(subs[i], lang, linkMap)
                table.insert(html, '| style="width:30px; border-right:0px; padding-left:10px;" | [[File:' .. info.icon .. '.png|30px]]')
                table.insert(html, '| style="width:180px; border-left:0px;" | \'\'\'' .. info.name .. '\'\'\'<br /><br />' .. info.desc .. '')
            else
                table.insert(html, '| colspan=2 style="border-left:1px solid #ccc;" | &nbsp;')
            end
        end
    end
    
    table.insert(html, "|}")
    return table.concat(html, "\n")
end

return p