Module:MapObjectsData: Difference between revisions

From Heroes of Might and Magic: Olden Era Official Wiki
No edit summary
No edit summary
Line 2: Line 2:


function p.testList(frame)
function p.testList(frame)
     local lang = frame.args.lang or "en"
    -- On demande à Cargo de nous donner tout ce qu'il trouve dans 'Skill'
    -- On ne demande aucun WHERE pour ne pas filtrer par erreur
     local results = mw.ext.cargo.query('Skill', '*', { limit = 20 })
      
      
     -- 1. On récupère les IDs depuis la table 'Skill'
     if #results == 0 then return "La table 'Skill' est vide ou inaccessible." end
    local skillIds = mw.ext.cargo.query('Skill', 'id', { limit = 500 })
      
      
     local output = {'=== Liste des compétences pour ' .. lang .. ' ==='}
     local output = {'=== Inspection brute de la table Skill ==='}
    output[#output+1] = "Nombre d'entrées trouvées : " .. #results
     output[#output+1] = '{| class="wikitable"'
     output[#output+1] = '{| class="wikitable"'
    output[#output+1] = '! ID !! Nom (' .. lang .. ')'
      
      
     for _, row in ipairs(skillIds) do
     -- On affiche les noms des colonnes dynamiquement
        local id = row.id
    output[#output+1] = '! Colonnes disponibles !!'
        -- 2. On récupère le nom traduit associé à cet ID
    for k, v in pairs(results[1]) do
        local trans = mw.ext.cargo.query('Translation', 'name', {
         output[#output+1] = '|- | ' .. k .. ' || ' .. tostring(v)
            where = "target_id = '" .. id .. "' AND language = '" .. lang .. "' AND type = 'skill'",
            limit = 1
        })
       
        local name = (trans and #trans > 0) and trans[1].name or "''Non traduit''"
         output[#output+1] = '|- | ' .. id .. ' || ' .. name
     end
     end
     output[#output+1] = "|}"
     output[#output+1] = "|}"

Revision as of 10:40, 6 June 2026


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: Script error: The function "get" does not exist.
{{#invoke:BuildingsData|get|field=narrative}}
  • Result: Script error: The function "get" does not exist.

Manual Mode

To fetch specific data regardless of the current page:

{{#invoke:BuildingsData|get|id=barracks_unfrozen_6|field=tier}}
  • Result: Script error: The function "get" does not exist.

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 = {}

function p.testList(frame)
    -- On demande à Cargo de nous donner tout ce qu'il trouve dans 'Skill'
    -- On ne demande aucun WHERE pour ne pas filtrer par erreur
    local results = mw.ext.cargo.query('Skill', '*', { limit = 20 })
    
    if #results == 0 then return "La table 'Skill' est vide ou inaccessible." end
    
    local output = {'=== Inspection brute de la table Skill ==='}
    output[#output+1] = "Nombre d'entrées trouvées : " .. #results
    output[#output+1] = '{| class="wikitable"'
    
    -- On affiche les noms des colonnes dynamiquement
    output[#output+1] = '! Colonnes disponibles !!'
    for k, v in pairs(results[1]) do
        output[#output+1] = '|- | ' .. k .. ' || ' .. tostring(v)
    end
    output[#output+1] = "|}"
    
    return table.concat(output, "\n")
end

return p