Jump to content

Module:Recipe

From Apogea Wiki
Revision as of 21:31, 27 January 2026 by Jayarrowz (talk | contribs) (Created page with "-- Module:Recipe -- Displays crafting recipes showing items combining into results -- Usage: {{#invoke:Recipe|display|input1=Item1|input2=Item2|output=Result}} local p = {} -- Format a single item slot local function formatSlot(itemName, quantity, spriteSize) if not itemName or itemName == "" then return '<div class="recipe-slot recipe-slot-empty"></div>' end local qty = tonumber(quantity) or 1 local qtyDisplay = "" if qty > 1 then...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Module:Recipe Documentation

This module displays crafting recipes showing how items combine to create new items.

Single Recipe

Display a single crafting recipe:

{{#invoke:Recipe|display
|input1=Pumpkin_Slice
|input2=Empty_Bowl
|output=Pumpkin_Puree
}}

With quantities:

{{#invoke:Recipe|display
|input1=Pumpkin_Slice
|input1qty=3
|input2=Empty_Bowl
|input2qty=2
|output=Pumpkin_Puree
}}

Recipe Parameters

Parameter Description
input1, input2, ... input6 Input item names (up to 6 inputs)
input1qty, input2qty, etc. Quantity for each input (default: 1)
output The resulting item name
outputqty Quantity produced (default: 1)
station Required crafting station (optional)
spriteSize Size of item sprites (default: 32)

Recipe List

Display multiple recipes in a table:

{{#invoke:Recipe|list
|title=Weapon Recipes
|recipe1=Wood+Stone=Stone Axe
|recipe2=Wood+Iron Bar=Iron Sword@Anvil
|recipe3=2xLeather+Iron Bar=Leather Armor@Workbench
|recipe4=3xWood+2xRope=Raft
}}

Recipe String Format

Each recipe uses the format:

[qty]xItem1+[qty]xItem2=Output[@Station]

Examples:

  • Wood+Stone=Axe - Simple recipe
  • Wood+Iron Bar=Sword@Anvil - Recipe with station
  • 2xWood+3xStone=Wall - Recipe with quantities
  • 2xIron Bar=4xNails@Anvil - Multiple output

Inline Recipe

For showing a recipe within text:

Combine {{#invoke:Recipe|inline|Wood|Stone|Axe}} to make your first tool.

Examples

Cooking Recipes

{{#invoke:Recipe|list
|title=Cooking Recipes
|recipe1=Raw Meat+Salt=Cooked Meat@Campfire
|recipe2=Flour+Water+Egg=Dough@Kitchen
|recipe3=Dough+Blueberry=Blueberry Muffin@Oven
|recipe4=2xFish+Lemon=Fish Dinner@Campfire
}}

Weapon Crafting

{{#invoke:Recipe|list
|title=Weapons
|recipe1=2xWood+Silver Bar=Silver Dagger@Anvil
|recipe2=3xWood+2xString+Iron Bar=Crossbow@Workbench
|recipe3=Wood+4xIron Bar=Battle Axe@Anvil
|recipe4=2xWood+Iron Bar=Shovel@Workbench
}}
{{#invoke:Recipe|display
|input1=Silver Bar
|input1qty=2
|input2=Wood
|input3=Magic Gem
|output=Silver Dagger
|station=Enchanting Table
|spriteSize=48
}}

Required CSS

Add this to your wiki's Common.css:

/* Recipe Container */
.recipe-container {
    display: flex;
    align-items: center;
    gap: 10px;
    padding: 10px;
    background-color: #1a1a2e;
    border: 2px solid #4a4a6a;
    border-radius: 5px;
    margin: 10px 0;
    width: fit-content;
}

.recipe-inputs {
    display: flex;
    align-items: center;
    gap: 5px;
}

.recipe-slot {
    display: flex;
    flex-direction: column;
    align-items: center;
    padding: 5px;
    background-color: #2a2a4e;
    border: 1px solid #3a3a5a;
    border-radius: 3px;
    position: relative;
    min-width: 50px;
}

.recipe-slot-empty {
    background-color: #1a1a2e;
    min-width: 50px;
    min-height: 50px;
}

.recipe-quantity {
    position: absolute;
    bottom: 2px;
    right: 2px;
    background-color: #000;
    color: #fff;
    font-size: 12px;
    padding: 1px 4px;
    border-radius: 2px;
}

.recipe-item-name {
    font-size: 10px;
    color: #aaa;
    margin-top: 3px;
    text-align: center;
}

.recipe-plus {
    font-size: 24px;
    color: #888;
    padding: 0 5px;
}

.recipe-arrow {
    font-size: 28px;
    color: #9edc60;
    padding: 0 10px;
}

.recipe-output {
    display: flex;
    align-items: center;
}

.recipe-station {
    font-size: 12px;
    color: #9bddff;
    margin-top: 5px;
    font-style: italic;
}

/* Recipe List/Table */
.recipe-list {
    background-color: #1a1a2e;
    border: 2px solid #4a4a6a;
    border-radius: 5px;
    padding: 10px;
    margin: 10px 0;
}

.recipe-list-title {
    font-size: 18px;
    font-weight: bold;
    color: #ffd700;
    margin-bottom: 10px;
    padding-bottom: 5px;
    border-bottom: 1px solid #4a4a6a;
}

.recipe-table {
    width: 100%;
    border-collapse: collapse;
}

.recipe-table-header th {
    text-align: left;
    padding: 8px;
    color: #aaa;
    border-bottom: 1px solid #4a4a6a;
}

.recipe-row td {
    padding: 8px;
    border-bottom: 1px solid #2a2a4e;
}

.recipe-cell-arrow {
    color: #9edc60;
    font-size: 20px;
    text-align: center;
    width: 40px;
}

.recipe-cell-station {
    color: #9bddff;
}

.recipe-inline-item {
    display: inline-flex;
    align-items: center;
    gap: 4px;
}

/* Inline recipe */
.recipe-inline {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    background-color: #2a2a4e;
    padding: 2px 6px;
    border-radius: 3px;
}

-- Module:Recipe
-- Displays crafting recipes showing items combining into results
-- Usage: {{#invoke:Recipe|display|input1=Item1|input2=Item2|output=Result}}

local p = {}

-- Format a single item slot
local function formatSlot(itemName, quantity, spriteSize)
    if not itemName or itemName == "" then
        return '<div class="recipe-slot recipe-slot-empty"></div>'
    end
    
    local qty = tonumber(quantity) or 1
    local qtyDisplay = ""
    if qty > 1 then
        qtyDisplay = string.format('<span class="recipe-quantity">%d</span>', qty)
    end
    
    return string.format(
        '<div class="recipe-slot">{{Sprite|%s|%s}}%s<span class="recipe-item-name">%s</span></div>',
        itemName, spriteSize, qtyDisplay, itemName
    )
end

-- Main display function for a single recipe
function p.display(frame)
    local args = frame.args
    local spriteSize = args.spriteSize or "32"
    local showLabels = args.showLabels ~= "false"
    
    -- Collect inputs (support up to 6 inputs)
    local inputs = {}
    for i = 1, 6 do
        local item = args["input" .. i] or args["in" .. i]
        local qty = args["input" .. i .. "qty"] or args["in" .. i .. "qty"] or "1"
        if item and item ~= "" then
            table.insert(inputs, {name = item, quantity = qty})
        end
    end
    
    -- Legacy support for simple input1, input2
    if #inputs == 0 then
        if args.input1 then
            table.insert(inputs, {name = args.input1, quantity = args.input1qty or "1"})
        end
        if args.input2 then
            table.insert(inputs, {name = args.input2, quantity = args.input2qty or "1"})
        end
    end
    
    -- Output
    local output = args.output or args.out or "Unknown"
    local outputQty = args.outputqty or args.outqty or "1"
    
    -- Station/workbench (optional)
    local station = args.station or args.workbench or ""
    
    -- Build HTML
    local html = {}
    
    table.insert(html, '<div class="recipe-container">')
    
    -- Inputs section
    table.insert(html, '<div class="recipe-inputs">')
    for i, input in ipairs(inputs) do
        table.insert(html, formatSlot(input.name, input.quantity, spriteSize))
        if i < #inputs then
            table.insert(html, '<span class="recipe-plus">+</span>')
        end
    end
    table.insert(html, '</div>')
    
    -- Arrow
    table.insert(html, '<div class="recipe-arrow">→</div>')
    
    -- Output section
    table.insert(html, '<div class="recipe-output">')
    table.insert(html, formatSlot(output, outputQty, spriteSize))
    table.insert(html, '</div>')
    
    table.insert(html, '</div>')
    
    -- Station requirement (if specified)
    if station ~= "" then
        table.insert(html, string.format('<div class="recipe-station">Requires: %s</div>', station))
    end
    
    return frame:preprocess(table.concat(html, '\n'))
end

-- Display a list of multiple recipes
function p.list(frame)
    local args = frame.args
    local title = args.title or "Recipes"
    local spriteSize = args.spriteSize or "32"
    
    local html = {}
    
    table.insert(html, '<div class="recipe-list">')
    table.insert(html, string.format('<div class="recipe-list-title">%s</div>', title))
    table.insert(html, '<table class="recipe-table">')
    table.insert(html, '<tr class="recipe-table-header"><th>Ingredients</th><th></th><th>Result</th><th>Station</th></tr>')
    
    -- Parse recipes (format: input1+input2=output@station)
    local i = 1
    while args["recipe" .. i] or args["r" .. i] do
        local recipeStr = args["recipe" .. i] or args["r" .. i]
        
        -- Parse: "Item1+Item2=Output" or "Item1+Item2=Output@Station"
        local inputPart, outputPart = recipeStr:match("^(.+)=(.+)$")
        if inputPart and outputPart then
            local station = ""
            local output = outputPart
            
            -- Check for station
            if outputPart:find("@") then
                output, station = outputPart:match("^(.+)@(.+)$")
            end
            
            -- Parse inputs
            local inputItems = {}
            for item in inputPart:gmatch("[^+]+") do
                item = item:match("^%s*(.-)%s*$") -- trim
                if item ~= "" then
                    -- Check for quantity (e.g., "2xWood")
                    local qty, name = item:match("^(%d+)x(.+)$")
                    if qty then
                        table.insert(inputItems, {name = name, quantity = qty})
                    else
                        table.insert(inputItems, {name = item, quantity = "1"})
                    end
                end
            end
            
            -- Parse output quantity
            local outQty, outName = output:match("^(%d+)x(.+)$")
            if not outQty then
                outQty = "1"
                outName = output
            end
            
            -- Build table row
            table.insert(html, '<tr class="recipe-row">')
            
            -- Ingredients cell
            table.insert(html, '<td class="recipe-cell-inputs">')
            for j, inp in ipairs(inputItems) do
                local qtyStr = ""
                if tonumber(inp.quantity) > 1 then
                    qtyStr = inp.quantity .. "x "
                end
                table.insert(html, string.format(
                    '<span class="recipe-inline-item">{{Sprite|%s|%s}} %s%s</span>',
                    inp.name, spriteSize, qtyStr, inp.name
                ))
                if j < #inputItems then
                    table.insert(html, ' + ')
                end
            end
            table.insert(html, '</td>')
            
            -- Arrow cell
            table.insert(html, '<td class="recipe-cell-arrow">→</td>')
            
            -- Output cell
            local outQtyStr = ""
            if tonumber(outQty) > 1 then
                outQtyStr = outQty .. "x "
            end
            table.insert(html, string.format(
                '<td class="recipe-cell-output"><span class="recipe-inline-item">{{Sprite|%s|%s}} %s%s</span></td>',
                outName, spriteSize, outQtyStr, outName
            ))
            
            -- Station cell
            if station ~= "" then
                table.insert(html, string.format(
                    '<td class="recipe-cell-station">{{Sprite|%s|%s}} %s</td>',
                    station, spriteSize, station
                ))
            else
                table.insert(html, '<td class="recipe-cell-station">-</td>')
            end
            
            table.insert(html, '</tr>')
        end
        
        i = i + 1
    end
    
    table.insert(html, '</table>')
    table.insert(html, '</div>')
    
    return frame:preprocess(table.concat(html, '\n'))
end

-- Simple inline recipe (for use within text)
function p.inline(frame)
    local args = frame.args
    local spriteSize = args.spriteSize or "16"
    
    local input1 = args[1] or args.input1 or ""
    local input2 = args[2] or args.input2 or ""
    local output = args[3] or args.output or ""
    
    local html = string.format(
        '<span class="recipe-inline">{{Sprite|%s|%s}} + {{Sprite|%s|%s}} → {{Sprite|%s|%s}}</span>',
        input1, spriteSize, input2, spriteSize, output, spriteSize
    )
    
    return frame:preprocess(html)
end

return p