Please note that some information on this wiki is still based on the demo version.
If you notice any errors, feel free to correct them.

Module:Abilities/Grid

From Super Fantasy Kingdom Official Wiki
Revision as of 23:46, 21 October 2025 by DCello (talk | contribs) (17 revisions imported)

Creates a grid where some cells can be highlighted. The center is always white unless highlighted by another color.

This module is used by Module:Abilities.

Arguments

  • mark: all or comma separated list of indices to highlight, e.g. 7,8,9.
  • markSource: comma separated list of indices to highlight as effect source, e.g. 7,8,9.

Indices

1 2 3 4 5
6 7 8 9 10
11 12 13 14 15
16 17 18 19 20
21 22 23 24 25

Examples

mark = 7,8,9,12,14

mark = 7,8,9,12,14 | markSource=18

mark = all


local p = {}

function p.grid(f)
	-- when called via a template calling invoke
	return p.create(f:getParent().args)
end

function p.gridInvoke(f)
	-- when called with {{#invoke:Abilities/Grid|gridInvoke|mark=1}}
	return p.create(f.args)
end
		             
function p.create(args)
    local columns = args.columns or 5
    local rows = args.rows or 5
    
    -- indexing fields: starting top left with 1, counting up row by row
    local centerIndex = math.floor(columns * rows / 2) + 1
    
    local classDefinitions = {
    	['center'] = 'influence-center',
    	['1'] = 'influence-blue',
    	['all'] = 'influence-red',
    	['source'] = 'influence-source'
    	}
    
    local mark = args['mark'] or ''
    local markSource = args['markSource'] or ''
    local markAllCells = string.find(mark, 'all') ~= nil
    local markCells = {}
    for i in string.gmatch(mark, '%d+') do
    	markCells[tonumber(i)] = true
    end
    local markCellsSource = {}
    for i in string.gmatch(markSource, '%d+') do
    	markCellsSource[tonumber(i)] = true
    end
	
    local rowsResult = {}
    local index = 0
    for x=1, columns do
    	local fieldsResult = {}
    	for y=1, rows do
    		index = index + 1
    		local classes = {}
    		local useCustomClasses = false
    		if index == centerIndex then
    			table.insert(classes, classDefinitions['center'])
    			useCustomClasses = true
    		end
			if markAllCells then
    			table.insert(classes, classDefinitions['all'])
    			useCustomClasses = true
    		end
			if markCells[index] then
    			table.insert(classes, classDefinitions['1'])
    			useCustomClasses = true
			end
			local classStyling = ''
			if useCustomClasses then
				classStyling = ' class="'..table.concat(classes, ' ')..'"'
			end
			
			local sourceMarker = ''
			if markCellsSource[index] then
				sourceMarker = '<span class="'..classDefinitions['source']..'"/>'
			end
			
			table.insert(fieldsResult, '<td'..classStyling..'>'..sourceMarker..'</td>')
    	end
    	table.insert(rowsResult, '<tr>'..table.concat(fieldsResult)..'</tr>')
    end
    return '<table class="influence-table" title="The center square represents the unit.&#010;Colored squares represent units affected by the effect&#010;Circles represent units needed for the effect.">'..table.concat(rowsResult)..'</table>'
end

return p