Aliasdaten

Dieser Artikel behandelt alternative ID-Namen. Für weitere Bedeutungen siehe Tag (Begriffsklärung).

Die Aliasdaten (engl. tags) enthalten alternative ID-Namen. Insbesondere lassen sich damit mehrere ID-Namen zu einer Gruppe zusammenfassen (z. B. alle bunten Wollen zu minecraft:wool), die dann als alternativer ID-Name in Rezeptdaten und Befehlen verwendet werden kann. Natürlich ist es auch möglich, nur einen einzigen ID-Namen mit einem Alias zu versehen, z.B. "hwpp" statt "heavy_weighted_pressure_plate".

Arten

• Block-Aliasse: Sie werden im Befehl /execute verwendet, um einen Block in der Welt zu prüfen. Beispiel: Der Befehl /execute if block ~ ~-1 ~ #minecraft:wool run say Wolle schreibt "Wolle" in den Chat, wenn sich unter der Befehlsquelle ein Wollblock gleich welcher Farbe befindet. Die Aliasgruppen, zu denen ein Block gehört, sieht man im Debug-Bildschirm, wenn man den Block fokussiert. Spezielle Block-Aliasse:
  • enderman_holdable.json: Diese Blöcke können von einem Enderman aufgenommen werden.
  • impermeable.json: Diese Blöcke tropfen nicht, wenn Wasser darüber ist.
  • logs.json: Diese Blöcke verhindern, dass natürlich generiertes Laub in der Nähe zerfällt.
  • underwater_bonemeals.json: Diese Blöcke werden im Biom warmer Ozean unter Wasser durch Knochenmehl erzeugt.
  • valid_spawn.json: Beim Generieren einer Standard-Welt setzt das Spiel den Welt-Spawnpunkt nur auf diese Blöcke.
• Gegenstand-Aliasse: Sie werden zum Prüfen von Inventaren und in den Rezeptdaten verwendet. Beispiel: Der Befehl /clear @s #minecraft:wool entfernt sämtliche Wolle aus dem Inventar des nächsten Spielers. In den Rezeptdaten werden Aliasse mit der tag-Eigenschaft anstelle der item-Eigenschaft angesprochen.
• Funktions-Aliasse: Sie fassen Befehls-Funktionen zusammen. Beispiel: Der Befehl /function #eigener-namensraum:eigener-alias führt nacheinander alle Funktionen aus, die in dieser Aliasgruppe enthalten sind. Spezielle Funktions-Aliasse:
  • minecraft:tick.json: Diese Funktionen werden automatisch mit jedem Tick ausgeführt, d. h. 20 Mal pro Sekunde.
  • minecraft:load.json: Diese Funktionen werden einmal ausgeführt:
    • Beim Laden der Welt im Einzelspieler, erstmalig im Mehrspieler,
    • beim drücken der Tastenkombination F3+T, im Einzelspieler,
    • beim Befehl /reload.

Herkunft

• minecraft.jar: Die Original-Aliasdaten stehen in minecraft.jar.
  • data: Die Standard-Weltdaten.
    • minecraft: Die Minecraft-Standard-Weltdaten.
      • tags: Die Aliasdaten.
        • blocks: Aliasse für Blöcke.
        • fluids: Aliasse für flüssige Blöcke.
        • functions: Das Originalspiel hat im minecraft-Namenraum keine Funktions-Aliasse. Möchte man jedoch den speziellen Funktions-Alias tick.json oder load.json nutzen, funktionieren diese nur im minecraft-Namensraum (siehe unten).
        • items: Aliasse für Gegenstände.
        • entity_types: Aliasse für Entitäten-Typen.

Änderbarkeit

Die Original-Aliasdaten gehören zu den Standard-Weltdaten und werden mit Datenpaketen geändert. Der Befehl /datapack disable vanilla deaktiviert die Standard-Weltdaten. Damit kann man keine Original-Aliasse mehr verwenden. Allerdings hat das auch weitere Auswirkungen (siehe hier).

Die Aliasdaten haben den Dateityp .json (JavaScript Object Notation), sind aber ganz normale Textdateien, die mit jedem Texteditor gelesen und verändert werden können.

Aliasdaten ändern

Um Aliasdaten zu ändern, platziert man die entsprechende Datei mit dem richtigen Namen im richtigen Ordner. Das bedeutet, man muss nicht alle Aliasdaten kopieren, sondern nur die, die man verändert hat. Im Minimalfall ist das nur eine einzige Datei. Beispiel:

.minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/minecraft/tags/items/planks.json

Nach dem nächsten Spielstart oder nach dem Befehl /reload werden die geänderten Aliasdaten angewendet. Im Beispiel ändern sich alle Rezepte, in denen das planks-Alias verwendet wird. Schreibt man in die Datei z. B. "minecraft:stone", können Betten je nach Einstellung (siehe unten) auch oder nur noch aus Wolle mit Stein hergestellt werden. (Beachte, dass für Rezepte die Gegenstand-Aliasse verwendet werden, nicht die Block-Aliasse).

Komplett neue Aliasdaten hinzufügen

Man kann auch beliebige eigene Aliasdaten hinzufügen. Diese hinterlegt man idealerweise in einem eigenen Namensraum, um sie deutlich von den Minecraft-Aliasdaten zu unterscheiden.

.minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/eigener-namensraum/tags/blocks/eigener-alias.json

.minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/eigener-namensraum/tags/functions/eigener-alias.json

Nach dem nächsten Spielstart oder nach dem Befehl /reload können die geänderten Aliasdaten verwendet werden. Beispiele:

Befehl /execute at @p if block ~ ~-1 ~ #eigener-namensraum:eigener-alias run setblock ~ ~-1 ~ stone

Dieser Befehl prüft, ob sich unter dem nächsten Spieler ein Block aus der Aliasgruppe befindet und wenn ja, ersetzt er ihn durch einen Stein.

Befehl /function #eigener-namensraum:eigener-alias

Dieser Befehl ruft nacheinander alle Funktionen auf, die in der Aliasgruppe zusammengefasst sind.

tick.json und load.json

Die speziellen Funktions-Aliasse minecraft:tick.json und minecraft:load.json funktionieren nur im minecraft-Namensraum.

Die Befehle in der hinterlegten Funktion, werden bei relativen as-selector Angaben, ohne as-selector, bei relativen at-selector Angaben, vom at-selector (0,4,1) ausgeführt.

Zusätzlich werden bei load.json, beim Laden der Welt, Befehle mit absoluten Spieler as-selector Angaben nicht ausgeführt.

Automatische Begrüßungen mit z.B. Befehl /tellraw oder im Mehrspieler die Erfassung von beitretenden Spielern mit z.B. Befehl /tag sind daher nicht möglich.

Beispiel für load.json: In der Funktion .minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/eigener-namensraum/functions/eigene-funktion.mcfunction steht nur eine Zeile: setblock 0 70 0 stone.

Der Funktions-Alias .minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/data/minecraft/tags/functions/load.json sieht so aus:

{
	"replace": false,
	"values": [
		"eigener-namensraum:eigene-funktion"
	]
}

Bei jedem Betreten der Welt wird die Funktion einmal ausgelöst und setzt an die Position (0,70,0) einen Stein.

Funktionsweise

In bestimmten Befehlen kann man statt eines ID-Namens für Block, Gegenstand oder Funktion einen Alias angeben. Aliasse werden mit einer vorangestellten Raute # von normalen ID-Namen unterschieden. Das Spiel führt den Befehl dann für alle im Alias eingetragenen Blöcke, Gegenstände oder Funktionen aus.

Die Tab-Vorschau bei der Befehlseingabe zeigt die Eingabemöglichkeiten: Wenn die Eingabe von Aliassen möglich ist, werden sie in der Auflistung immer vor den anderen ID-Namen angezeigt.

Datenstruktur

• Die namenlose Haupteigenschaft.
  • replace: true oder false. Bei true ersetzt der Alias einen bisher geladenen Alias gleichen Namens. Das bedeutet, dass bei der standardmäßigen Datenpaket-Ladereihenfolge "Vanilla + eigenes Datenpaket" ein replace-Alias den Vanilla-Alias gleichen Namens ersetzt. Bei umgekehrter Ladereihenfolge "eigenes Datenpaket + Vanilla" ersetzt ein replace-Alias dagegen nichts, weil es in diesem Beispiel vor dem eigenen Datenpaket kein weiteres Datenpaket gibt; danach wird der Vanilla-Alias dem eigenen Alias gleichen Namens hinzugefügt, weil alle Vanilla-Aliasse die replace-Einstellung false haben.
  • values: Liste von ID-Namen von entweder Blöcken, Gegenständen oder Funktionen. Die Liste darf nicht gemischt sein, ihr Inhalt muss zum Aliastyp passen, der durch den Alias-Ordner festgelegt ist. In jeder Liste ist auch die Angabe von Aliasdaten möglich. Sie werden mit einem vorangestellten # gekennzeichnet, z. B. #minecraft:planks. Ein Alias, der direkt oder über Umwege sich selbst enthält, ist jedoch nicht möglich.

Beispiel

Das Alias planks.json fasst alle Holzbretter zusammen:

{
	"replace": false,
	"values": [
		"minecraft:acacia_planks",
		"minecraft:oak_planks",
		"minecraft:dark_oak_planks",
		"minecraft:jungle_planks",
		"minecraft:birch_planks",
		"minecraft:spruce_planks"
	]
}

Alle Aliasse

Holz

#oak_logs: Alle Eichenhölzer (als Block und Gegenstand)

Eichenstamm Eichenholz Entrindeter Eichenstamm Entrindetes Eichenholz

#spruce_logs: Alle Fichtenhölzer (als Block und Gegenstand)

Fichtenstamm Fichtenholz Entrindeter Fichtenstamm Entrindetes Fichtenholz

#birch_logs: Alle Birkenhölzer (als Block und Gegenstand)

Birkenstamm Birkenholz Entrindeter Birkenstamm Entrindetes Birkenholz

#jungle_logs: Alle Tropenhölzer (als Block und Gegenstand)

Tropenbaumstamm Tropenholz Entrindeter Tropenbaumstamm Entrindetes Tropenholz

#acacia_logs: Alle Akazienhölzer (als Block und Gegenstand)

Akazienstamm Akazienholz Entrindeter Akazienstamm Entrindetes Akazienholz

#dark_oak_logs: Alle Schwarzeichenhölzer (als Block und Gegenstand)

Schwarzeichenstamm Schwarzeichenholz Entrindeter Schwarzeichenstamm Entrindetes Schwarzeichenholz

#logs: Alle Hölzer (als Block und Gegenstand)

 #oak_logs #spruce_logs #birch_logs #jungle_logs #acacia_logs #dark_oak_logs

#leaves: Alle Laubarten (als Block und Gegenstand)

Eiche Fichte Birke Tropenbaum Akazie Schwarzeiche

#planks: Alle Holzbretter (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#saplings: Alle Setzlinge (als Block und Gegenstand)

Eiche Fichte Birke Tropenbaum Akazie Schwarzeiche

#wooden_buttons: Alle Holzknöpfe (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#wooden_doors: Alle Holztüren (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#wooden_trapdoors: Alle Holzfalltüren (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#wooden_pressure_plates: Alle Holzdruckplatten (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#wooden_slabs: Alle Holzstufen (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#wooden_stairs: Holztreppen (als Block und Gegenstand)

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#buttons: Alle Knöpfe (als Block und Gegenstand)

 #wooden_buttons Steinknopf

#doors: Alle Türen (als Block und Gegenstand)

 #wooden_doors Eisentür

#trapdoors: Alle Falltüren (als Block und Gegenstand)

 #wooden_trapdoors Eisenfalltür

#slabs: Alle Stufen (als Block und Gegenstand)

Eichenholz Fichtenholz Birkenholz Tropenholz Akazienholz Schwarzeichenholz Stein Sandstein Roter Sandstein Bruchstein Ziegelsteine Steinziegel Netherziegel Quarz Prismarin Prismarinziegel Dunkler Prismarin Purpur Versteinertes Eichenholz

#stairs: Alle Treppen (als Block und Gegenstand)

Eichenholz Fichtenholz Birkenholz Tropenholz Akazienholz Schwarzeichenholz Sandstein Roter Sandstein Bruchstein Ziegelsteine Steinziegel Netherziegel Quarz Prismarin Prismarinziegel Dunkler Prismarin Purpur

Korallen

#corals: Alle lebenden Korallen und Korallenfächer (nur als Block)

Orgel Hirn Blasen Feuer Geweih
Orgel Hirn Blasen Feuer Geweih

#coral_blocks: Alle lebenden Korallenblöcke (nur als Block)

Orgel Hirn Blasen Feuer  Geweih

#wall_corals: Alle lebenden Korallenwandfächer (nur als Block)

Orgel Hirn Blasen Feuer Geweih

Gefärbte Blöcke

#banners: Alle Banner und Wandbanner (als Block und Gegenstand)

 Weiß  Orange  Magenta  Hellblau  Gelb  Hellgrün  Rosa  Grau  Hellgrau  Türkis  Violett  Blau  Braun  Grün  Rot  Schwarz
 Weiß  Orange  Magenta  Hellblau  Gelb  Hellgrün  Rosa  Grau  Hellgrau  Türkis  Violett  Blau  Braun  Grün  Rot  Schwarz

#carpets: Alle Teppiche (als Block und Gegenstand)

Weiß Orange Magenta Hellblau Gelb Hellgrün Rosa Grau Hellgrau Türkis Violett Blau Braun Grün Rot Schwarz

#wool: Alle Wollen (als Block und Gegenstand)

Weiß Orange Magenta Hellblau Gelb Hellgrün Rosa Grau Hellgrau Türkis Violett Blau Braun Grün Rot Schwarz

Flüssigkeiten

Die Flüssigkeiten-Aliasse fassen den jeweiligen Block (Lava oder Wasser) mit seinem Flüssigkeit-Zustand zusammen, der "flowing_lava" bzw. "flowing_water" heißt und kein Block ist. Details siehe Blockzustand#Flüssigkeiten. Die Flüssigkeiten-Aliasse werden nur intern vom Spiel verwendet. In einem Befehl (z. B. Befehl /execute if block ~ ~ ~ #minecraft:water run say Wasser), funktionieren sie nicht.

#lava: Lava

Lava minecraft:flowing_lava

#water: Wasser

Wasser minecraft:flowing_water

Sonstige Blöcke

#anvil: Alle Ambosse (als Block und Gegenstand)

Amboss Angeschlagen Beschädigt

#beehives: Unterschlüpfe für Bienen

Bienennest Bienenstock

#crops: Verschiedene anbaubare Pflanzen

Rote Bete Karotten Kartoffeln Weizenpflanzen Melone Kürbis

#ice: Alle Eisblöcke (nur als Block)

Eis Brüchiges Eis Packeis Blaueis

#flower_pots: Alle Blumentöpfe (nur als Block)

Ohne Inhalt Mit Mohn Mit Löwenzahn Mit Eichensetzling Mit Fichtensetzling Mit Birkensetzling Mit Tropenbaumsetzling Mit rotem Pilz Mit braunem Pilz Mit Kaktus Mit totem Busch Mit Farn Mit Akaziensetzling Mit Schwarzeichensetzling Mit blauer Orchidee Mit Sternlauch Mit Porzellansternchen Mit roter Tulpe Mit oranger Tulpe Mit weißer Tulpe Mit rosa Tulpe Mit Margerite

#rails: Alle Schienen (als Block und Gegenstand)

Schiene Aktivierungsschiene Antriebsschiene Sensorschiene

#sand: Alle Sande (als Block und Gegenstand)

Sand Roter Sand

#stone_bricks: Alle Steinziegel (als Block und Gegenstand)

Steinziegel Bemoost Rissig Gemeißelt

Spezielle Blöcke

#bee_growables: Alle Blöcke, die Bienen zum Ernten von Honig benutzen können

Rote Bete Karotten Kartoffeln Weizenpflanzen Melone Kürbis Süßbeerenstrauch

#enderman_holdable: Alle Blöcke, die ein Enderman wegnehmen kann

Grasblock Erde Grobe Erde Podsol Sand Roter Sand Kies Mohn Löwenzahn Roter Pilz Brauner Pilz Blaue Orchidee Sternlauch Porzellansternchen Rote Tulpe Orange Tulpe Weiße Tulpe Rosa Tulpe Margerite TNT Kaktus Ton Kürbis Geschnitzter Kürbis Melone Myzel Netherrack

#impermeable: Alle wasserundurchlässigen Blöcke (sie tropfen nicht, wenn Wasser darüber ist)

Glas Weißes Glas Oranges Glas Magenta Glas Hellblaues Glas Gelbes Glas Hellgrünes Glas Rosa Glas Graues Glas Hellgraues Glas Türkises Glas Violettes Glas Blaues Glas Braunes Glas Grünes Glas Rotes Glas Schwarzes Glas

#underwater_bonemeals: Alle Blöcke, die im Biom warmer Ozean unter Wasser durch Knochenmehl erzeugt werden

#corals #wall_corals Seegras

#valid_spawn: Alle Blöcke, auf die das Spiel beim Generieren einer Standard-Welt den Welt-Spawnpunkt setzen kann.

Grasblock Podsol

Gegenstände

#boats: Alle Boote

Eiche Fichte Birke Tropenholz Akazie Schwarzeiche

#fishes: Alle Fische

Roher Kabeljau Gebratener Kabeljau Roher Lachs Gebratener Lachs Kugelfisch Tropenfisch