Difference between revisions of "Module:UnitData"

From Zero-K
Jump to navigation Jump to search
m (Handle nil properties)
(Refactor; weapon infobox printing attempt)
Line 6: Line 6:
 
if not frame then return '' end
 
if not frame then return '' end
 
     local unitDefName = frame.args[1]
 
     local unitDefName = frame.args[1]
     if not (unitData[unitDefName]) then return 'unitdef ' .. unitDefName .. ' not found' end
+
local ud = unitData[unitDefName]
 +
     if not (ud) then return 'unitdef ' .. unitDefName .. ' not found' end
 
     local property = frame.args[2]
 
     local property = frame.args[2]
     local result = unitData[unitDefName][property]
+
     local result = ud[property]
 +
    if not result then result = '' end
 +
    return frame:preprocess(result) or ''
 +
end
 +
 
 +
function unit.printWeaponInfoboxes(frame)
 +
if not frame then return '' end
 +
    local unitDefName = frame.args[1]
 +
local ud = unitData[unitDefName]
 +
    if not (ud) then return 'unitdef ' .. unitDefName .. ' not found' end
 +
   
 +
    local result = ''
 +
local weaponModule = require('Module:WeaponData')
 +
 +
for index,weaponID in ipairs(ud.weaponIDs or {}) do
 +
local frame = {args = {weaponID}}
 +
result = result .. weaponModule.printInfobox(frame)
 +
end
 +
   
 
     if not result then result = '' end
 
     if not result then result = '' end
 
     return frame:preprocess(result) or ''
 
     return frame:preprocess(result) or ''

Revision as of 22:30, 10 May 2024

Documentation

This module is used to autogenerate unit infoboxes by drawing data from Module:UnitData/data. The intent is to ease updating of unit infoboxes on the wiki; ideally, only the one data page needing to be changed every release. The concept is taken from e.g. the Combat Card Data module on the Library of Ruina Wiki.

This module is currently used with Template:Autoinfobox zkunit as follows:

{{Autoinfobox zkunit
|defname=striderdetriment
|name=Name override
}}

The module can also be invoked directly to generate an infobox (note that output may not be identical in some cases; observed with automatic detection of buildpic on Reef):

{{#invoke:UnitData|printInfobox|defname=striderdetriment|name=Name override}}

When invoking from module, defname may be passed as an anonymous parameter instead.

See also Module:WeaponData, which is used to generate the weapon infoboxes within the unit infoboxes.

Data page

Module:UnitData/data is a central store of data used by Module:UnitData to automatically populate unit infoboxes.

The page is a Lua table written to the local file temp/unitStats.lua by the Wiki Data Export (dbg_wiki_export.lua) widget in Zero-K. This widget should be run once each update and the data page on the wiki replaced accordingly. It should not be necessary to edit the data manually.


local getArgs = require('Module:Arguments').getArgs
local unit = {}
local unitData = mw.loadData('Module:UnitData/data')

function unit.getData(frame)
	if not frame then return '' end
    local unitDefName = frame.args[1]
	local ud = unitData[unitDefName]
    if not (ud) then return 'unitdef ' .. unitDefName .. ' not found' end
    local property = frame.args[2]
    local result = ud[property]
    if not result then result = '' end
    return frame:preprocess(result) or ''
end

function unit.printWeaponInfoboxes(frame)
	if not frame then return '' end
    local unitDefName = frame.args[1]
	local ud = unitData[unitDefName]
    if not (ud) then return 'unitdef ' .. unitDefName .. ' not found' end
    
    local result = ''
	local weaponModule = require('Module:WeaponData')
	
	for index,weaponID in ipairs(ud.weaponIDs or {}) do
		local frame = {args = {weaponID}}
		result = result .. weaponModule.printInfobox(frame)
	end
    
    if not result then result = '' end
    return frame:preprocess(result) or ''
end

return unit