Level 2 – Nodes & Blöcke

API: core.register_node

Mit core.register_node (alias core.register_node) registrierst du neue Blocktypen („Nodes“) für deine Welt. Die Welt ist ein 3D-Gitter; jede Position ist eine Node, bestehend aus einem Typnamen und zwei Parametern (param1, param2).

Wichtig: register_node registriert den Typ der Node, nicht eine einzelne Node in der Welt. Einzelne Node-Instanzen speichern pro Block:

• name – Node-Typ, z. B. "default:stone"
• param1 – meist Lichtinformationen (Helligkeit)
• param2 – z. B. Rotation, Farbe oder Level, je nach paramtype2 in der Definition

1. Grundsyntax

Die Grundform der Funktion sieht so aus:

core.register_node("modname:itemname", {
    description = "Lesbarer Name",
    tiles       = {
        "block_top.png",    -- Oberseite (Y+)
        "block_bottom.png", -- Unterseite (Y-)
        "block_right.png",  -- Rechte Seite (X+)
        "block_left.png",   -- Linke Seite (X-)
        "block_back.png",   -- Rueckseite (Z+)
        "block_front.png",  -- Vorderseite (Z-)
    },
    -- weitere Felder ...
})

Namensschema:

• "modname:itemname" (nur Kleinbuchstaben, Zahlen, Unterstrich).
• description und tiles sind für sichtbare Blöcke praktisch Pflicht.

2. Nodes im Detail: name, param1, param2

Jede Node in der Welt speichert neben dem Typnamen zwei Zahlen:

Über core.registered_nodes[name] kannst du im Code später auf die Definition des Typs zugreifen, z.B. um den drawtype zu prüfen.

2.1 Drawtype-Uebersicht (Kurzreferenz)

drawtype bestimmt, wie eine Node gezeichnet wird. Die folgende Liste fasst die haeufigsten Varianten zusammen:

2.2 Gruppen: Werkzeug-Uebersicht

3. Einfacher Trainingsblock

Ein minimaler Block für Übungswelten – gut für Koordinaten- und Bauaufgaben:

core.register_node("school_blocks:training_block", {
    description = "Training Block",
    tiles       = {"school_training_block.png"},
    groups      = {cracky = 3, oddly_breakable_by_hand = 3},
    is_ground_content = false,
})

4. Wichtige Felder in Node-Definitionen

Die folgende Tabelle fasst die wichtigsten Felder zusammen, mit denen du im Unterricht am häufigsten arbeitest:

5. Rotation & paramtype2 (Kurzreferenz)

Viele spannende Effekte entstehen erst, wenn du paramtype2 setzt – dann speichert param2 z.B. die Rotation oder Farbe einzelner Blöcke.

Für den Unterricht reicht meist: „facedir ist Drehung, leveled ist Füllhöhe, color... ist Farbe.“

6. Wow-Block #1: Magic Light Glass

Ein halbtransparenter Glasblock, der die Umgebung hell erleuchtet – perfekt als „Magische Lampe“ oder High-Tech-Block.

core.register_node("school_magic:light_glass", {
    description       = "Magic Light Glass",
    drawtype          = "glasslike",
    tiles             = {"school_magic_light_glass.png"},
    use_texture_alpha = "blend",
    paramtype         = "light",
    sunlight_propagates = true,
    light_source      = 14,  -- Maximum-Lichtstärke
    groups            = {cracky = 3, oddly_breakable_by_hand = 3},
})

7. Wow-Block #2: Bouncy Trampoline

Ein Sprungblock, der Spieler:innen nach oben katapultiert – super für Parkour-Maps oder „Trampolin-Halle“.

core.register_node("school_fun:trampoline", {
    description = "Bouncy Trampoline",
    tiles       = {"school_trampoline_top.png",
                   "school_trampoline_bottom.png",
                   "school_trampoline_side.png"},
    groups      = {bouncy = 120, cracky = 1, oddly_breakable_by_hand = 3},
    -- bouncy: Prozentwert, wie stark man zurückkatapultiert wird
})

8. Wow-Block #3: Toxic Slime Floor

Ein giftiger Boden, der beim Draufstehen Schaden macht und den Bildschirm grünlich einfärbt – ideal für „Gefahrenzonen“ in Lernlevels.

core.register_node("school_fun:toxic_slime", {
    description = "Toxic Slime Floor",
    tiles       = {"school_toxic_slime.png"},
    groups      = {crumbly = 3},
    walkable    = true,
    damage_per_second = 4,  -- 4 HP Schaden pro Sekunde
    post_effect_color = { a = 180, r = 120, g = 255, b = 120 },
})

9. Wow-Block #4: Dünne Nodebox-Platte

Mit drawtype = "nodebox" kannst du Blöcke formen, die nicht voll 1×1×1 sind – z.B. dünne Platten, Treppen, Möbel.

core.register_node("school_build:metal_plate", {
    description = "Thin Metal Plate",
    drawtype    = "nodebox",
    tiles       = {"school_metal_plate.png"},
    paramtype   = "light",
    node_box    = {
        type  = "fixed",
        fixed = {
            -- x1, y1, z1, x2, y2, z2  (Koordinaten von -0.5 bis 0.5)
            {-0.5, -0.5, -0.5, 0.5, -0.4, 0.5},  -- sehr dünne Platte
        },
    },
    groups      = {cracky = 2},
})

10. Mini-Aufträge für Schüler:innen

1. Erstelle einen eigenen Block mit nur description und tiles.
2. Baue einen Lichtblock mit light_source und vergleiche ihn mit einer Fackel.
3. Experimentiere mit bouncy-Werten beim Trampolin.
4. Nutze paramtype2 = "facedir", um einen Block je nach Blickrichtung zu drehen.

11. Weiterführende Seiten

• Weitere Node-Beispiele (Ideensammlung)
• Basics: Coordinates & Positions
• API: core.register_chatcommand
• Externe Referenz: Luanti API & Beispiele