Baumdefinition

Dieser Inhalt ist nur für die Java Edition.

Bäume sind Merkmale, die aus einem Stamm und Laub sowie optional aus Wurzeln und Dekorationen bestehen. Sie werden mithilfe von Merkmaldefinitionen in Datenpaketen konfiguriert.

Datenstruktur

• : Der Wurzelverbundtyp.
  • type: minecraft:tree
  • config: Die Konfiguration des Baums.
    • ignore_vines: (Optional, standardmäßig auf „false“ eingestellt) Ermöglicht die Generierung des Baums, auch wenn ihn Ranken blockieren.
    • below_trunk_provider: (Optional) Ein regelbasierter Blockzustandsanbieter, der festlegt, wie der Block unterhalb des Stamms ersetzt wird. Den Standardwert findest du unter Standardmäßiger Blockzustandsanbieter unterhalb des Stamms.
      • Ein regelbasierter Blockzustandsanbieter mit dem Feld rule_based.
    • trunk_provider: Der Block, der für den Stamm verwendet wird. Beachte, dass der Block die Eigenschaft axis besitzen muss, wenn der Stammplatzierer fancy_trunk_placer ist, beispielsweise Baumstämme.
      • Ein Blockzustandsanbieter.
    • foliage_provider: Der Block, der für das Laub verwendet wird.
      • Ein Blockzustandsanbieter.
    • minimum_size: Definiert die Breite des Baums in verschiedenen Höhen relativ zum untersten Stammblock. Weitere Informationen findest du unter Mindestgröße.
    • trunk_placer: Legt fest, wie der Stamm generiert wird. Weitere Informationen findest du unter Stammplatzierer.
    • foliage_placer: Legt fest, wie das Laub generiert wird. Weitere Informationen findest du unter Laubplatzierer.
    • root_placer: (Optional) Steuert, wie die Wurzeln generiert werden und welche Blöcke dafür verwendet werden. Weitere Informationen findest du unter Wurzelplatzierer.
    • decorators: (Erforderlich, kann aber leer sein) Dekorationen, die dem Baum zusätzlich zum Stamm und Laub hinzugefügt werden.
      • : Ein Dekorator. Weitere Informationen findest du unter Dekoratoren.

Standardmäßiger Blockzustandsanbieter unterhalb des Stamms

Wenn kein Blockzustandsanbieter unterhalb des Stamms angegeben wird, wird standardmäßig der folgende regelbasierte Blockzustandsanbieter verwendet:

{
    "rules": [
        {
            "if_true": {
                "type": "minecraft:not",
                "predicate": {
                    "type": "minecraft:matching_block_tag",
                    "tag": "minecraft:cannot_replace_below_tree_trunk"
                }
            },
            "then": {
                "type": "minecraft:simple_state_provider",
                "state": {
                    "Name": "minecraft:dirt"
                }
            }
        }
    ]
}

Mindestgröße

Die Mindestgröße bestimmt, wie viel Platz vorhanden sein muss, damit der Baum generiert werden kann. Dazu wird auf jeder Höhe des Baums eine quadratische Fläche mit einer je nach Höhe unterschiedlichen Breite überprüft. Die verfügbare freie Höhe entspricht der Höhe, bis zu der alle überprüften Flächen frei sind.

• minimum_size: Die Mindestgröße des Baums.
  • type: Einer der Werte two_layers_feature_size oder three_layers_feature_size.
  • min_clipped_height: (Optional) Wert zwischen 0 und 80 (einschließlich). Wenn dieser Wert angegeben ist und niedriger als die Stammhöhe ist, legt er die mindestens erforderliche freie Höhe fest, bei der der Baum generiert werden kann. Andernfalls wird stattdessen die Stammhöhe verwendet.
  • Die zusätzlichen Felder hängen vom Wert von type ab. Weitere Informationen stehen in den folgenden Abschnitten.

two_layers_feature_size

Legt zwei unterschiedliche Breiten abhängig von der Höhe fest. Bei Höhen unterhalb von limit wird lower_size verwendet, andernfalls upper_size.

• Zusätzliche Felder:
  • limit: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 81 (einschließlich). Legt die Grenze zwischen der unteren und der oberen Ebene fest.
  • lower_size: (Optional, standardmäßig auf 0 eingestellt) Wert zwischen 0 und 16 (einschließlich). Mindestbreite des Baums bei Höhen unterhalb von limit.
  • upper_size: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 16 (einschließlich). Mindestbreite des Baums bei Höhen größer oder gleich limit.

three_layers_feature_size

Legt drei unterschiedliche Breiten abhängig von der Höhe fest. Bei Höhen unterhalb von limit wird als Mindestbreite lower_size verwendet. Für die obersten upper_limit Stammblöcke wird upper_size verwendet. In allen übrigen Höhen wird middle_size verwendet.

• Zusätzliche Felder:
  • limit: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 80 (einschließlich). Höhe der unteren Ebene, gemessen vom unteren Ende des Stamms.
  • upper_limit: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 80 (einschließlich). Höhe der oberen Ebene, gemessen vom oberen Ende des Stamms.
  • lower_size: (Optional, standardmäßig auf 0 eingestellt) Wert zwischen 0 und 16 (einschließlich). Mindestbreite des Baums in der unteren Ebene, also in den untersten limit Stammblöcken.
  • middle_size: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 16 (einschließlich). Mindestbreite des Baums in der mittleren Ebene, also zwischen der unteren und der oberen Ebene.
  • upper_size: (Optional, standardmäßig auf 1 eingestellt) Wert zwischen 0 und 16 (einschließlich). Mindestbreite des Baums in der oberen Ebene, also in den obersten upper_limit Stammblöcken.

Stammplatzierer

Der Stammplatzierer bestimmt die Form des Baumstamms.

• trunk_placer: Der Stammplatzierer.
  • type: Einer der Werte straight_trunk_placer, forking_trunk_placer, giant_trunk_placer, mega_jungle_trunk_placer, dark_oak_trunk_placer, fancy_trunk_placer, bending_trunk_placer, upwards_branching_trunk_placer, cherry_trunk_placer oder poplar_trunk_placer.
  • base_height: Wert zwischen 0 und 32 (einschließlich). Die Grundhöhe des Stamms.
  • height_rand_a: Wert zwischen 0 und 24 (einschließlich). Ein zufälliger Wert zwischen 0 und diesem Wert (einschließlich) wird zur Höhe des Stamms addiert.
  • height_rand_b: Wert zwischen 0 und 24 (einschließlich). Ein weiterer zufälliger Wert zwischen 0 und diesem Wert (einschließlich) wird zur Höhe des Stamms addiert.
  • Die zusätzlichen Felder hängen vom Wert von type ab. Weitere Informationen stehen in der folgenden Tabelle.

Stammplatzierer

	Name	Beschreibung und zusätzliche Felder
	straight_trunk_placer	Platziert einen geraden Stamm mit der angegebenen Höhe. Das Laub wird am Block oberhalb des höchsten Stammblocks platziert. [Neu: JE 26.4] Zusätzliche Felder: trunk_width: (Optional, standardmäßig auf 1 eingestellt) Ein Wert mit einem Mindestwert von 1. Ein Int-Anbieter.
	forking_trunk_placer	Platziert einen Stamm mit einem oder zwei Ästen, die 1 bis 3 Blöcke überhängen. Das Laub wird an der Spitze jedes Astes platziert. Keine zusätzlichen Felder.
	giant_trunk_placer	Platziert einen 2×2 Blöcke breiten Stamm mit der angegebenen Höhe. Der oberste Stammblock besteht jedoch nur aus einem einzelnen Block. Das Laub wird am Block oberhalb des höchsten Stammblocks platziert. Keine zusätzlichen Felder.
	mega_jungle_trunk_placer	Erweitert giant_trunk_placer um Äste mit einer Länge von 5 Blöcken, die in zufällige Richtungen in der oberen Hälfte des Stamms wachsen. Zusätzlich wird am Ende jedes Astes Laub platziert. Keine zusätzlichen Felder.
	dark_oak_trunk_placer	Platziert einen 2×2 Blöcke breiten Stamm mit der angegebenen Höhe. Zusätzlich werden in den obersten fünf Stammblöcken Astsäulen in einem Bereich von 4×4 Blöcken um den Stamm platziert. Laub wird sowohl an der Spitze des Stamms als auch an der Spitze jedes Astes platziert. Keine zusätzlichen Felder.
	fancy_trunk_placer	Platziert einen geraden Stamm mit einer Höhe von (height + 2) * 0.618 sowie Äste in zufällige Richtungen. Die Äste werden stets mindestens bei 20 % der Baumhöhe generiert. Keine zusätzlichen Felder.
	bending_trunk_placer	Platziert einen Stamm mit der angegebenen Höhe. Die beiden obersten Blöcke können jeweils mit einer gewissen Wahrscheinlichkeit um einen Block versetzt werden. Oberhalb des Stamms wird ein gerader Ast mit der Länge bend_length generiert. Laub wird an allen Blöcken des obersten Astes sowie an allen Stammblöcken platziert, die höher liegen als min_height_for_leaves. Zusätzliche Felder: bend_length: Wert zwischen 1 und 64 (einschließlich). Ein Int-Anbieter. min_height_for_leaves: (Optional, standardmäßig auf 1 eingestellt) Muss eine positive Ganzzahl sein.
	upwards_branching_trunk_placer	Zusätzliche Felder: extra_branch_steps: Anzahl der Schritte zum Generieren zusätzlicher Äste. Muss eine positive Ganzzahl sein. Ein Int-Anbieter. extra_branch_length: Bestimmt die zusätzliche Astlänge. Muss eine nicht negative Ganzzahl sein. Ein Int-Anbieter. place_branch_per_log_probability: Wahrscheinlichkeit, mit der jeder Stammblock einen Ast erzeugt. Wert zwischen 0,0 und 1,0 (einschließlich). can_grow_through: Eine Block-ID, eine Block-Gruppe oder eine Liste von Block-IDs. Gibt die Blöcke an, durch die Baumstämme wachsen können.
	cherry_trunk_placer	Zusätzliche Felder: branch_count: Wert zwischen 1 und 3 (einschließlich). Ein Int-Anbieter. branch_horizontal_length: Wert zwischen 2 und 16 (einschließlich). Ein Int-Anbieter. branch_start_offset_from_top: Ein gleichverteilter Int-Anbieter, der einen Wert zwischen zwei Grenzen mit gleichmäßiger Verteilung liefert. Der Wert muss zwischen −16 und 0 (einschließlich) liegen. Da die Astansätze mindestens zwei Blöcke Variation benötigen, damit beide Äste Platz finden, muss max_inclusive mindestens min_inclusive + 1 betragen. min_inclusive: Der kleinstmögliche Wert. max_inclusive: Der größtmögliche Wert. branch_end_offset_from_top: Wert zwischen −16 und 16 (einschließlich). Ein Int-Anbieter.
	poplar_trunk_placer	Zusätzliche Felder: branch_amount: Wert zwischen 1 und 4 (einschließlich). Ein Int-Anbieter. trunk_height_above_branches: Wert zwischen 0 und 8 (einschließlich). Ein Int-Anbieter.

Laubplatzierer

Der Laubplatzierer bestimmt die Platzierung und Form des Baumlaubs.

• foliage_placer: Der Laubplatzierer.
  • type: Einer der Werte blob_foliage_placer, spruce_foliage_placer, pine_foliage_placer, acacia_foliage_placer, bush_foliage_placer, fancy_foliage_placer, jungle_foliage_placer, mega_pine_foliage_placer, dark_oak_foliage_placer, random_spread_foliage_placer, cherry_foliage_placer oder poplar_foliage_placer.
  • radius: Der Radius des Laubs. Wert zwischen 0 und 16 (einschließlich).
    • Ein Int-Anbieter.
  • offset: Der vertikale Versatz zwischen der Oberseite des Stamms und der Oberseite des Laubs. Wert zwischen 0 und 16 (einschließlich).
    • Ein Int-Anbieter.
  • Die zusätzlichen Felder hängen vom Wert von type ab. Weitere Informationen stehen in der folgenden Tabelle.

Laubplatzierer

	Name	Beschreibung und zusätzliche Felder
	blob_foliage_placer	Zusätzliche Felder: height: Die Höhe des Laubs. Wert zwischen 0 und 16 (einschließlich).
	bush_foliage_placer	Zusätzliche Felder: height: Die Höhe des Laubs. Wert zwischen 0 und 16 (einschließlich).
	fancy_foliage_placer	Zusätzliche Felder: height: Die Höhe des Laubs. Wert zwischen 0 und 16 (einschließlich).
	jungle_foliage_placer	Zusätzliche Felder: height: Die Höhe des Laubs. Wert zwischen 0 und 16 (einschließlich).
	spruce_foliage_placer	Platziert kegelförmige Laubschichten, beginnend an der Oberseite des Stamms zuzüglich des Versatzes. Der Radius nimmt zu, bis der maximale Radius erreicht ist. Anschließend werden weitere Kegelstumpfschichten mit diesem maximalen Radius generiert, bis das Laub eine Höhe von trunk_height + 1 erreicht. Zusätzliche Felder: trunk_height: Wert zwischen 0 und 24 (einschließlich). Ein Int-Anbieter.
	pine_foliage_placer	Zusätzliche Felder: height: Wert zwischen 0 und 24 (einschließlich). Ein Int-Anbieter.
	mega_pine_foliage_placer	Zusätzliche Felder: crown_height: Wert zwischen 0 und 24 (einschließlich). Ein Int-Anbieter.
	random_spread_foliage_placer	Zusätzliche Felder: foliage_height: Wert zwischen 1 und 512 (einschließlich). Ein Int-Anbieter. leaf_placement_attempts: Wert zwischen 0 und 256 (einschließlich).
	cherry_foliage_placer	Zusätzliche Felder: height: Wert zwischen 4 und 16 (einschließlich). Ein Int-Anbieter. wide_bottom_layer_hole_chance: Wahrscheinlichkeit für eine Öffnung in der breiten unteren Laubschicht. Wert zwischen 0,0 und 1,0 (einschließlich). corner_hole_chance: Wahrscheinlichkeit für eine Öffnung an einer Ecke. Wert zwischen 0,0 und 1,0 (einschließlich). hanging_leaves_chance: Wahrscheinlichkeit für herabhängendes Laub. Wert zwischen 0,0 und 1,0 (einschließlich). hanging_leaves_extension_chance: Wahrscheinlichkeit für eine Verlängerung des herabhängenden Laubs. Wert zwischen 0,0 und 1,0 (einschließlich).
	acacia_foliage_placer	Keine zusätzlichen Felder.
	dark_oak_foliage_placer	Keine zusätzlichen Felder.
	poplar_foliage_placer	Das Laub weist ein kreuzförmiges Muster auf. Zusätzliche Felder: height: Wert zwischen 5 und 16 (einschließlich). Ein Int-Anbieter. side_hole_chance: Wahrscheinlichkeit für seitliche Öffnungen im Laub. Wert zwischen 0,0 und 1,0 (einschließlich).

Wurzelplatzierer

Der Wurzelplatzierer ist optional und steuert die Platzierung und Form der Wurzeln sowie die Verschiebung des Stamms nach oben.

• root_placer: Der Wurzelplatzierer.
  • type: Art des Wurzelplatzierers für Bäume; derzeit ist nur mangrove_root_placer verfügbar.
  • root_provider: Der Block, der als Wurzel des Baums verwendet wird.
    • Ein Blockzustandsanbieter.
  • trunk_offset_y: Versatz senkrecht zum Stamm.
    • Ein Int-Anbieter.
  • above_root_placement: (Optional) Legt die Blöcke oberhalb der Wurzel fest.
    • above_root_provider: Der Block, der oberhalb der Wurzel verwendet wird.
      • Ein Blockzustandsanbieter.
    • above_root_placement_chance: Wahrscheinlichkeit, mit der der Block generiert wird. Wert zwischen 0,0 und 1,0 (einschließlich).
  • Die zusätzlichen Felder hängen vom Wert von type ab. Weitere Informationen stehen in der folgenden Tabelle.

Wurzelplatzierer

	Name	Beschreibung und zusätzliche Felder
	mangrove_root_placer	Zusätzliche Felder: mangrove_root_placement: Parameter für die Platzierung der Mangrovenwurzeln. max_root_width: Maximale Breite der Wurzel. Wert zwischen 1 und 12 (einschließlich). max_root_length: Maximale Länge der Wurzel. Wert zwischen 1 und 64 (einschließlich). random_skew_chance: Wahrscheinlichkeit für eine zufällige Abweichung der Wurzelrichtung. Wert zwischen 0,0 und 1,0 (einschließlich). can_grow_through: Eine Block-ID, eine Block-Gruppe oder eine Liste von Block-IDs. Gibt die Blöcke an, durch die Wurzeln wachsen können. muddy_roots_in: Eine Block-ID, eine Block-Gruppe oder eine Liste von Block-IDs. Wurzeln, die sich in diesen Blöcken befinden, werden zu schlammigen Wurzelblöcken. muddy_roots_provider: Die Blöcke, die als schlammige Wurzeln verwendet werden. Ein Blockzustandsanbieter.

Dekoratoren

Dekoratoren fügen verschiedenen Teilen eines Baums zusätzliche Blöcke hinzu.

• : Ein Dekorator.
  • type: Der Typ der hinzuzufügenden Dekoration. Einer der Werte alter_ground, attached_to_leaves, attached_to_logs, beehive, cocoa, creaking_heart, leave_vine, pale_moss, place_on_ground, trunk_vine oder shelf_mushroom.
  • Die zusätzlichen Felder hängen vom Wert von type ab. Weitere Informationen stehen in der folgenden Tabelle.

Baumdekoratoren

	Name	Beschreibung und zusätzliche Felder
	alter_ground	Ersetzt Blöcke der Block-Gruppe #minecraft:dirt in der Umgebung des Baums durch andere Blöcke. Zusätzliche Felder: provider: Ein regelbasierter Blockzustandsanbieter, der festlegt, wie der Boden ersetzt wird. Ein regelbasierter Blockzustandsanbieter mit dem Feld rule_based.
	attached_to_leaves	Platziert Blöcke an den freiliegenden Seitenflächen aller Laubblöcke in den angegebenen Richtungen. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich). exclusion_radius_xz: Der Mindestabstand zwischen zwei Dekorationen in horizontaler Richtung. Wert zwischen 0 und 16 (einschließlich). exclusion_radius_y: Der Mindestabstand zwischen zwei Dekorationen in vertikaler Richtung. Wert zwischen 0 und 16 (einschließlich). required_empty_blocks: Anzahl der freien Blöcke, die für die Dekoration erforderlich sind. Wert zwischen 0 und 16 (einschließlich). block_provider: Der Block, der für die Dekoration verwendet wird. Ein Blockzustandsanbieter. directions: (Darf nicht leer sein) Die Richtungen, in denen die Dekoration generiert werden kann. : Eine Richtung. Muss einer der Werte up, down, north, south, west oder east sein.
	attached_to_logs	Platziert Blöcke an den freiliegenden Seitenflächen aller Stammblöcke in den angegebenen Richtungen. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich). block_provider: Der Block, der für die Dekoration verwendet wird. Ein Blockzustandsanbieter. directions: (Darf nicht leer sein) Die Richtungen, in denen die Dekoration generiert werden kann. : Eine Richtung. Muss einer der Werte up, down, north, south, west oder east sein.
	beehive	Platziert mit der angegebenen Wahrscheinlichkeit einen einzelnen Bienenstock. Dieser befindet sich immer einen Block unterhalb des untersten Laubblocks, kann dabei jedoch an einem anderen Ast liegen. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich).
	cocoa	Platziert Kakaobohnen an den untersten drei Stammblöcken. Jede Seitenfläche hat dabei eine Wahrscheinlichkeit von 25 %, Kakaobohnen zu erhalten. Das Feld probability legt fest, mit welcher Wahrscheinlichkeit der Dekorator überhaupt Kakaobohnen platziert. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich), mit der der Dekorator Kakaobohnen platziert.
	creaking_heart	Platziert ein Knarzherz, indem ein Stammblock an einer Position ersetzt wird, an der alle sechs angrenzenden Blöcke zur Block-Gruppe #minecraft:logs gehören. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich).
	leave_vine	Platziert Ranken an beliebigen Laubblöcken. Jede Ranke wird, sofern möglich, um vier Blöcke nach unten verlängert. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich), mit der an einer beliebigen Position eine Ranke platziert wird.
	pale_moss	Platziert das konfigurierte Merkmal minecraft:pale_moss_patch an der Position des untersten Stammblocks mit der Wahrscheinlichkeit ground_probability. Fügt an den unteren Enden von Stamm- und Laubblöcken Hängendes Blassmoos hinzu. Die Wahrscheinlichkeiten dafür werden durch trunk_probability beziehungsweise ground_probability festgelegt. Zusätzliche Felder: leaves_probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich). trunk_probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich). ground_probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich).
	place_on_ground	Überprüft tries Positionen innerhalb des angegebenen Radius und Höhenbereichs. Gesucht wird eine Position auf der Höhe der Höhenkarte MOTION_BLOCKING_NO_LEAVES, an der sich ein fester Block befindet und oberhalb davon Luft ist. An passenden Positionen wird der angegebene Block auf dem darüberliegenden Block platziert. Zusätzliche Felder: tries: (Optional) Positive Ganzzahl. Standardmäßig 128. radius: (Optional) Nicht negative Ganzzahl. Standardmäßig 2. height: (Optional) Nicht negative Ganzzahl. Standardmäßig 1. block_state_provider: Der Block, der für die Dekoration verwendet wird. Ein Blockzustandsanbieter.
	trunk_vine	Platziert an jeder Seite jedes Stammblocks mit einer Wahrscheinlichkeit von 75 % Ranken. Keine zusätzlichen Felder.
Datei:Baummerkmal shelf mushroom tree decorator.png	shelf_mushroom	Platziert mit der angegebenen Wahrscheinlichkeit an jedem Stammblock Baumpilze. Zusätzliche Felder: probability: Wahrscheinlichkeit zwischen 0,0 und 1,0 (einschließlich).