Module:RandomItemSequence

Documentation for this module may be created at Module:RandomItemSequence/doc

local p = {}
local Random = require('Module:Random')

-- Seed once per page parse
Random.seed(os.time())

-- Fisher–Yates shuffle
local function shuffle(t)
    for i = #t, 2, -1 do
        local j = Random.random(i)
        t[i], t[j] = t[j], t[i]
    end
end

-- render function
-- `frame` is the standard MediaWiki frame object
-- `args.items` is a semicolon-separated list of item names
function p.render(frame)
    local args = frame:getParent().args
    local itemsParam = args.items or ""
    local tooltip = args.tooltip or ""
    local link = args.link or ""

    -- Split items
    local items = {}
    for item in string.gmatch(itemsParam, "([^;]+)") do
        item = item:gsub("^%s*(.-)%s*$", "%1") -- trim whitespace
        table.insert(items, item)
    end

    if #items == 0 then
        return ""
    end

    -- Shuffle items
    shuffle(items)

    -- Render each ItemSlot individually via expandTemplate
    -- This is one call per item, fully processed by MediaWiki
    local output = {}
    for _, item in ipairs(items) do
        table.insert(output, frame:expandTemplate{
            title = "ItemSlot",
            args = {
                item = item,
                tooltip = tooltip,
                link = link
            }
        })
    end

    -- Concatenate all ItemSlots into one HTML block
    return table.concat(output, "\n")
end

return p