Module:RaceData

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

local p = {}

local categoryColors = {
    ["Standard"] = "#4CAF50",      
    ["Elven"] = "#9C27B0",         
    ["Minx"] = "#FF9800",          
    ["Feline"] = "#795548",        
    ["Dwarven"] = "#607D8B",       
    ["Banished"] = "#F44336",      
    ["Demonic"] = "#9C27B0",       
    ["Aquatic"] = "#2196F3",       
    ["Hybrid"] = "#FF5722",        
}

local raceData = {
    ["Banished (Frog)"] = {
        displayName = "Banished (Frog)",
        category = "Banished",
        subrace = "Frog",
        color = "#F44336",
        description = "Frog-like banished creatures with amphibious abilities."
    },
    
    ["Human"] = {
        displayName = "Human",
        category = "Standard",
        color = "#4CAF50",
        description = "Standard human race with versatile capabilities."
    },
    
    ["Banished (Armor Spirit)"] = {
        displayName = "Banished (Armor Spirit)",
        category = "Banished",
        subrace = "Armor Spirit",
        color = "#F44336",
        description = "Spiritual beings bound to armor, cast out from their realm."
    },
    
    ["Minx (Dragon-kin)"] = {
        displayName = "Minx (Dragon-kin)",
        category = "Minx",
        subrace = "Dragon-kin",
        color = "#FF9800",
        description = "Dragon-blooded minx with draconic features."
    },
    
    ["Mortal"] = {
        displayName = "Mortal",
        category = "Standard",
        color = "#4CAF50",
        description = "Mortal beings with finite lifespans and diverse backgrounds."
    },
    
    ["Minx"] = {
        displayName = "Minx",
        category = "Minx",
        subrace = "Base",
        color = "#FF9800",
        description = "Base minx race with feline characteristics."
    },
    
    ["Elf"] = {
        displayName = "Elf",
        category = "Elven",
        color = "#9C27B0",
        description = "Elegant, long-lived beings with affinity for nature and magic."
    },
    
    ["Banished (Giant)"] = {
        displayName = "Banished (Giant)",
        category = "Banished",
        subrace = "Giant",
        color = "#F44336",
        description = "Gigantic banished beings with immense strength."
    },
    
    ["Minx (Tiger)"] = {
        displayName = "Minx (Tiger)",
        category = "Minx",
        subrace = "Tiger",
        color = "#FF9800",
        description = "Tiger-striped minx with predatory instincts."
    },
    
    ["Minx (Moon Cat)"] = {
        displayName = "Minx (Moon Cat)",
        category = "Minx",
        subrace = "Moon Cat",
        color = "#FF9800",
        description = "Lunar-aligned minx with mystical abilities."
    },
    
    ["Minx-Giant"] = {
        displayName = "Minx-Giant",
        category = "Hybrid",
        subrace = "Minx-Giant",
        color = "#FF5722",
        description = "Hybrid of Minx and Giant characteristics."
    },
    
    ["Mortal/Vampire"] = {
        displayName = "Mortal/Vampire",
        category = "Hybrid",
        subrace = "Mortal-Vampire",
        color = "#FF5722",
        description = "Hybrid beings with both mortal and vampiric traits."
    },
    
    ["Fox Minx"] = {
        displayName = "Fox Minx",
        category = "Minx",
        subrace = "Fox",
        color = "#FF9800",
        description = "Fox-like minx with cunning and agility."
    },
    
    ["Gothic Demon"] = {
        displayName = "Gothic Demon",
        category = "Demonic",
        subrace = "Gothic",
        color = "#9C27B0",
        description = "Dark, gothic-themed demonic beings."
    },
    
    ["Felinyan"] = {
        displayName = "Felinyan",
        category = "Feline",
        color = "#795548",
        description = "Feline humanoids with graceful movements."
    },
    
    ["Dwarf"] = {
        displayName = "Dwarf",
        category = "Dwarven",
        color = "#607D8B",
        description = "Stout, sturdy beings skilled in craftsmanship."
    },
    
    ["Banished"] = {
        displayName = "Banished",
        category = "Banished",
        color = "#F44336",
        description = "Beings cast out from their original realms."
    },
    
    ["Demonkind"] = {
        displayName = "Demonkind",
        category = "Demonic",
        color = "#9C27B0",
        description = "Demonic beings with infernal powers."
    },
    
    ["Siren"] = {
        displayName = "Siren",
        category = "Aquatic",
        subrace = "Moon Priestess",
        color = "#2196F3",
        description = "Aquatic beings with enchanting voices and lunar connections."
    }
}

-- Helper function to get light color variant
function p.getLightColor(hexColor)
    if not hexColor or hexColor:len() ~= 7 then
        return "#F8F9FA"
    end
    
    local r = tonumber(hexColor:sub(2, 3), 16)
    local g = tonumber(hexColor:sub(4, 5), 16)
    local b = tonumber(hexColor:sub(6, 7), 16)
    
    if not r or not g or not b then
        return "#F8F9FA"
    end
    
    r = math.floor(r * 0.2 + 255 * 0.8)
    g = math.floor(g * 0.2 + 255 * 0.8)
    b = math.floor(b * 0.2 + 255 * 0.8)
    
    return string.format("#%02X%02X%02X", r, g, b)
end

-- Helper function to darken color
function p.darkenColor(hexColor, percent)
    percent = percent or 20
    
    if not hexColor or hexColor:len() ~= 7 then
        return "#333333"
    end
    
    local r = tonumber(hexColor:sub(2, 3), 16)
    local g = tonumber(hexColor:sub(4, 5), 16)
    local b = tonumber(hexColor:sub(6, 7), 16)
    
    if not r or not g or not b then
        return "#333333"
    end
    
    r = math.floor(r * (100 - percent) / 100)
    g = math.floor(g * (100 - percent) / 100)
    b = math.floor(b * (100 - percent) / 100)
    
    return string.format("#%02X%02X%02X", r, g, b)
end

-- Function to get race data
function p.getRace(frame)
    local raceName = frame.args[1] or mw.text.trim(frame:getParent().args[1] or "")
    
    if raceName == "" then
        return "Error: No race name provided"
    end
    
    local race = raceData[raceName]
    
    if not race then
        return "Error: Race '" .. raceName .. "' not found in database"
    end
    
    return race
end

-- Function to get race info with hover infobox (for Template:RaceInfo)
function p.getRaceInfo(frame)
    local raceName = frame.args[1] or mw.text.trim(frame:getParent().args[1] or "")
    
    if raceName == "" then
        return '<span class="race-error">Unknown Race</span>[[Category:Unknown Race]]'
    end
    
    local race = raceData[raceName]
    
    if not race then
        return '<span class="race-error">Race Not Found</span>[[Category:Unknown Race]]'
    end
    
    local color = race.color or categoryColors[race.category] or "#666666"
    local lightColor = p.getLightColor(color)
    local darkColor = p.darkenColor(color, 20)
    
    local output = {}
    
    table.insert(output, '<div class="race-hover-container">')
    
    -- The clickable race link
    table.insert(output, '<span class="race-hover-trigger">')
    table.insert(output, '<a href="/wiki/' .. mw.uri.encode(race.displayName) .. ' (Race)" class="race-link-inline" style="color: ' .. color .. ';">')
    table.insert(output, race.displayName)
    table.insert(output, '</a>')
    table.insert(output, '</span>')
    
    -- The hidden infobox
    table.insert(output, '<div class="race-hover-infobox" style="border-color: ' .. color .. ';">')
    
    -- Header
    table.insert(output, '<div class="race-hover-header" style="background: linear-gradient(135deg, ' .. color .. ' 0%, ' .. darkColor .. ' 100%);">')
    table.insert(output, '<h4>' .. race.displayName .. '</h4>')
    table.insert(output, '</div>')
    
    -- Content
    table.insert(output, '<div class="race-hover-content" style="background-color: ' .. lightColor .. ';">')
    table.insert(output, '<table class="race-hover-table">')
    
    -- Category row
    table.insert(output, '<tr><td><strong>Category:</strong></td><td><span class="category-badge-small" style="background-color: ' .. color .. ';">' .. race.category .. '</span></td></tr>')
    
    -- Subrace row (if exists)
    if race.subrace then
        table.insert(output, '<tr><td><strong>Subrace:</strong></td><td>' .. race.subrace .. '</td></tr>')
    end
    
    -- Description row (if exists)
    if race.description then
        table.insert(output, '<tr><td colspan="2" style="padding-top: 10px; font-size: 0.9em; line-height: 1.4; color: #555;">' .. race.description .. '</td></tr>')
    end
    
    table.insert(output, '</table>')
    
    -- Footer
    table.insert(output, '<div class="race-hover-footer">')
    table.insert(output, '<a href="/wiki/' .. mw.uri.encode(race.displayName) .. ' (Race)" class="view-full-link" style="background-color: ' .. color .. ';">View Full Race Page</a>')
    table.insert(output, '</div>')
    
    table.insert(output, '</div>') -- Close content
    table.insert(output, '</div>') -- Close infobox
    table.insert(output, '</div>') -- Close container
    
    -- Add categories
    table.insert(output, '\n[[Category:' .. race.category .. ' Characters]]')
    table.insert(output, '\n[[Category:' .. race.displayName .. ' Characters]]')
    
    return table.concat(output, '')
end

-- Function to get race infobox for race pages
function p.getRaceInfobox(frame)
    local raceName = frame.args[1] or mw.text.trim(frame:getParent().args[1] or "")
    
    if raceName == "" then
        return "Error: No race name provided"
    end
    
    local race = raceData[raceName]
    
    if not race then
        return "Error: Race '" .. raceName .. "' not found"
    end
    
    local color = race.color or categoryColors[race.category] or "#666666"
    local lightColor = p.getLightColor(color)
    local darkColor = p.darkenColor(color, 20)
    
    local output = {}
    
    table.insert(output, '<div class="race-full-infobox" style="border-color: ' .. color .. ';">')
    table.insert(output, '<div class="race-full-header" style="background: linear-gradient(135deg, ' .. color .. ' 0%, ' .. darkColor .. ' 100%);">')
    table.insert(output, '<h2>Race Information</h2>')
    table.insert(output, '</div>')
    table.insert(output, '<div class="race-full-content" style="background-color: ' .. lightColor .. ';">')
    table.insert(output, '<div class="race-badge-large" style="background-color: ' .. color .. ';">' .. race.category .. '</div>')
    table.insert(output, '<table class="race-full-table">')
    table.insert(output, '<tr><td><strong>Race Name:</strong></td><td>' .. race.displayName .. '</td></tr>')
    table.insert(output, '<tr><td><strong>Category:</strong></td><td><span class="category-tag-large" style="background-color: ' .. color .. ';">' .. race.category .. '</span></td></tr>')
    
    if race.subrace then
        table.insert(output, '<tr><td><strong>Subrace:</strong></td><td>' .. race.subrace .. '</td></tr>')
    end
    
    if race.description then
        table.insert(output, '<tr><td><strong>Description:</strong></td><td>' .. race.description .. '</td></tr>')
    end
    
    table.insert(output, '</table>')
    table.insert(output, '<div class="race-characters-section">')
    table.insert(output, '<h3>Characters of this Race</h3>')
    table.insert(output, '<div class="category-list">')
    table.insert(output, '{{#categorytree:' .. race.displayName .. ' Characters|depth=1|mode=pages}}')
    table.insert(output, '</div>')
    table.insert(output, '</div>')
    table.insert(output, '</div>')
    table.insert(output, '</div>')
    
    return table.concat(output, '')
end

-- Function to get race link with colored badge
function p.getRaceLink(frame)
    local raceName = frame.args[1] or mw.text.trim(frame:getParent().args[1] or "")
    
    if raceName == "" then
        return "[[Category:Unknown Race]]"
    end
    
    local race = raceData[raceName]
    
    if not race then
        return "[[Category:Unknown Race]]"
    end
    
    local color = race.color or categoryColors[race.category] or "#666666"
    
    local output = '<span class="race-link-badge">'
    output = output .. '<a href="/wiki/' .. race.displayName .. ' (Race)" class="race-link" style="background-color: ' .. color .. ';">'
    output = output .. race.displayName
    output = output .. '</a>'
    output = output .. '</span>'
    output = output .. "\n[[Category:" .. race.category .. " Characters]]"
    
    return output
end

-- Function to get colored category list
function p.getColoredCategories()
    local output = "== Race Categories ==\n"
    
    -- Group races by category
    local categories = {}
    for _, race in pairs(raceData) do
        if not categories[race.category] then
            categories[race.category] = {
                color = race.color or categoryColors[race.category] or "#666666",
                races = {}
            }
        end
        table.insert(categories[race.category].races, race.displayName)
    end
    
    -- Display each category
    for categoryName, categoryData in pairs(categories) do
        output = output .. '\n=== <span style="color: ' .. categoryData.color .. ';">' .. categoryName .. '</span> ===\n'
        table.sort(categoryData.races)
        for _, raceName in ipairs(categoryData.races) do
            output = output .. '* [[' .. raceName .. ' (Race)|' .. raceName .. ']]\n'
        end
    end
    
    return output
end

-- Function to get all races in a category
function p.getRaceCategory(frame)
    local category = frame.args[1] or mw.text.trim(frame:getParent().args[1] or "")
    
    if category == "" then
        return "Error: No category specified"
    end
    
    local output = "== " .. category .. " Races ==\n\n"
    local found = false
    
    for raceName, race in pairs(raceData) do
        if race.category == category then
            found = true
            local color = race.color or categoryColors[race.category] or "#666666"
            output = output .. '=== <span style="color: ' .. color .. ';">' .. race.displayName .. '</span> ===\n'
            output = output .. '* [[' .. race.displayName .. ' (Race)|View Race Page]]\n'
            output = output .. '* [[:Category:' .. race.displayName .. ' Characters|View ' .. race.displayName .. ' Characters]]\n\n'
        end
    end
    
    if not found then
        return "Error: Category '" .. category .. "' not found or has no races"
    end
    
    return output
end

return p