Items, Materialien und Crafting verstehen

core.register_craftitem("school_materials:kristallsplitter", {
    -- description ist der sichtbare Name im Inventar.
    description = "Kristallsplitter",

    -- inventory_image bestimmt das Icon im Inventar und in Listen.
    inventory_image = "school_kristallsplitter.png",

    -- stack_max begrenzt, wie viele Exemplare in einen Stapel passen.
    stack_max = 99,

    -- groups macht das Item für Rezepte und Spielregeln auffindbar.
    groups = {crystal = 1, magic = 1},
})

core.register_craftitem("school_materials:copper_ingot", {
    -- Ein einfacher Barren: gut als Zutat für weitere Rezepte.
    description = "Kupferbarren",
    inventory_image = "school_copper_ingot.png",
    groups = {metal = 1},
})

core.register_craftitem("school_materials:field_ration", {
    description = "Feldration",
    inventory_image = "school_ration.png",

    -- core.item_eat(4) stellt 4 Hungerpunkte wieder her.
    on_use = core.item_eat(4),

    -- Das Item ist Nahrung und kann zusätzlich als brennbares Material gelten.
    groups = {food = 1, flammable = 1},
})

core.register_tool("school_materials:lehrlingshammer", {
    description = "Lehrlingshammer",
    inventory_image = "school_lehrlingshammer.png",

    tool_capabilities = {
        -- full_punch_interval steuert das Tempo zwischen zwei Schlägen.
        full_punch_interval = 1.1,

        -- max_drop_level beeinflusst, welche härteren Blöcke noch Beute abwerfen.
        max_drop_level = 1,

        groupcaps = {
            -- cracky steht typischerweise für Stein, Erz und ähnliche Materialien.
            cracky = {
                -- times enthält die Abbauzeit für verschiedene Härtestufen.
                times = {[1] = 3.8, [2] = 2.0, [3] = 1.0},

                -- uses ist grob die Anzahl sinnvoller Einsätze vor starkem Verschleiß.
                uses = 20,

                -- maxlevel begrenzt, wie harte Materialien das Tool noch schafft.
                maxlevel = 1,
            },
        },

        -- damage_groups betrifft Treffer auf Wesen, nicht das Abbauen von Nodes.
        damage_groups = {fleshy = 3},
    },
})

core.register_craft({
    -- Kein type nötig: shaped ist die Standardform.
    output = "school_materials:kristallstab",

    recipe = {
        -- Leere Strings markieren freie Felder im Raster.
        {"", "school_materials:kristallsplitter", ""},

        -- In der Mitte steckt hier ein vorhandener Stock aus dem Spiel.
        {"", "default:stick", ""},

        -- Nur dieses genaue Muster ergibt den Kristallstab.
        {"", "school_materials:kristallsplitter", ""},
    },
})

core.register_craft({
    type = "shapeless",

    -- Drei Splitter ergeben hier drei Portionen Kristallstaub.
    output = "school_materials:kristallstaub 3",

    recipe = {
        -- Die Reihenfolge im Crafting-Feld spielt jetzt keine Rolle.
        "school_materials:kristallsplitter",
        "school_materials:kristallsplitter",
        "school_materials:kristallsplitter",
    },
})

core.register_craft({
    type = "cooking",

    -- Aus Staub wird im Ofen ein härteres Zwischenprodukt.
    output = "school_materials:gehaerteter_kristall",
    recipe = "school_materials:kristallstaub",

    -- cooktime gibt an, wie lange der Ofen daran arbeitet.
    cooktime = 8,
})

core.register_craft({
    type = "fuel",

    -- Dieses Item darf als Brennstoff in den Ofen gelegt werden.
    recipe = "school_materials:holzspan",

    -- burntime ist die Brenndauer in Spielzeit-Einheiten.
    burntime = 5,
})

core.register_craft({
    output = "school_materials:glitzertrank",
    recipe = {
        {"school_materials:magisches_wasser", "school_materials:kristallstaub"},
    },

    -- replacements gibt Behälter oder Werkzeuge nach dem Craften zurück.
    replacements = {
        {"school_materials:magisches_wasser", "school_materials:leere_flasche"},
    },
})

core.register_node("school_materials:zauberholz", {
    description = "Zauberholz",
    tiles = {"school_zauberholz.png"},

    -- Der Block gehört zu mehreren Gruppen gleichzeitig.
    groups = {choppy = 2, wood = 1, flammable = 2},
})

core.register_craft({
    output = "school_materials:holzgriff",
    recipe = {
        -- group:wood akzeptiert jedes Item mit groups = {wood = 1}.
        {"group:wood"},
        {"group:wood"},
    },
})

local einzelner_splitter = ItemStack("school_materials:kristallsplitter")

local zehn_splitter = ItemStack("school_materials:kristallsplitter 10")

local genauer_stack = ItemStack({
    -- name ist das registrierte Item.
    name = "school_materials:kristallstaub",

    -- count ist die Anzahl im Stapel.
    count = 5,

    -- wear wäre vor allem bei Tools relevant.
    wear = 0,
})

core.register_craftitem("school_materials:zauberapfel", {
    description = "Zauberapfel",
    inventory_image = "school_zauberapfel.png",

    on_use = function(itemstack, user, pointed_thing)
        -- Prüfen, ob wirklich ein Spieler das Item benutzt hat.
        if user then
            core.chat_send_player(user:get_player_name(), "Du fühlst magische Energie!")
        end

        -- Genau ein Exemplar aus dem Stack verbrauchen.
        itemstack:take_item()

        -- Der aktualisierte Stack muss zurückgegeben werden.
        return itemstack
    end,
})

core.register_craftitem("school_materials:kristallsplitter", {
    -- Rohstoff, den Spielende finden oder als Beute erhalten.
    description = "Kristallsplitter",
    inventory_image = "school_kristallsplitter.png",
})

core.register_craftitem("school_materials:kristallstaub", {
    -- Zwischenprodukt: entsteht erst durch ein Rezept.
    description = "Kristallstaub",
    inventory_image = "school_kristallstaub.png",
})

core.register_craftitem("school_materials:gehaerteter_kristall", {
    -- Zweites Zwischenprodukt: muss im Ofen verarbeitet werden.
    description = "Gehärteter Kristall",
    inventory_image = "school_gehaerteter_kristall.png",
})

core.register_craftitem("school_materials:zauberstab", {
    description = "Zauberstab",
    inventory_image = "school_zauberstab.png",

    on_use = function(itemstack, user, pointed_thing)
        -- Das Endprodukt darf beim Benutzen eine sichtbare Reaktion auslösen.
        if user then
            core.chat_send_player(user:get_player_name(), "Der Zauberstab funkelt hell!")
        end

        -- Der Stab wird hier nicht verbraucht, deshalb unverändert zurückgeben.
        return itemstack
    end,
})

core.register_craft({
    type = "shapeless",
    output = "school_materials:kristallstaub 2",
    recipe = {
        -- Drei Rohstoffe werden zu feinem Material zermahlen.
        "school_materials:kristallsplitter",
        "school_materials:kristallsplitter",
        "school_materials:kristallsplitter",
    },
})

core.register_craft({
    type = "cooking",
    output = "school_materials:gehaerteter_kristall",
    recipe = "school_materials:kristallstaub",
    cooktime = 6,
})

core.register_craft({
    output = "school_materials:zauberstab",
    recipe = {
        -- Oben steckt der wertvolle Kristallkern.
        {"", "school_materials:gehaerteter_kristall", ""},

        -- Unten bildet ein einfacher Stock den Griff.
        {"", "default:stick", ""},
        {"", "default:stick", ""},
    },
})