Datenpaket

Diese Seite beschreibt Inhalte über Funktionen, die in der Java Edition und Bedrock Edition enthalten sind. Diese Funktionen sind schon in der aktuellen Entwicklungsversion 23w44a und beta 1.20.50.21 der 1.20.3 und der 1.20.40, jedoch noch nicht in einer offiziellen Aktualisierung enthalten.

Dieser Artikel behandelt das Datenpaket. Für den Befehl /datapack siehe Befehl/datapack.

Mit einem Datenpaket (engl. data pack) können Änderungen an den Weltdaten für eine bestimmte Welt vorgenommen werden (Server-Seite). Das unterscheidet sie von Ressourcenpaketen, die die Darstellung des gesamten Spiels (Client-Seite) ändern.

Durch die Anwendung eines Datenpaketes können sowohl existierende Weltdaten (Beutetabellen, Fortschrittsdaten etc.) verändert, als auch neue hinzugefügt werden.

Das Konzept der Datenpakete besteht darin, dass das Spiel gewisse Informationen wie Kreaturen-Drops oder Fortschritte aus Dateien einliest und anwendet. Ändert man diese Dateien, hat man automatisch andere Kreaturen-Drops oder andere Fortschritte. Folgende Weltdaten können verändert werden:

• Drops von getöteten Kreaturen.
• Inhalte von generierten Truhen.
• Funde beim Angeln.
• Texte, Bedingungen und Ergebnisse der Minecraft-Fortschritte sowie Anwendung eigener Fortschritte.
• Handwerk-Rezepte.
• Ofen-Rezepte.
• Alternative ID-Namen für Blöcke und Gegenstände.
• Anwendung eigener Befehlslisten mittels Funktionen.
• Laden eigener Konstruktionen mit dem Konstruktionsblock.

Datenpakete werden eingelesen:

• Beim Laden der Welt oder beim Starten des Servers,
• beim Befehl /reload,
• beim Anklicken des "Fertig"-Buttons im Menü/Optionen/Ressourcenpakete im Einzelspielermodus,
• beim Drücken der Tasten F3+T im Einzelspielermodus.

Installation und Deinstallation

Man kann jeder Welt ein oder mehrere Datenpakete hinzufügen und die Daten dieser Welt dadurch verändern. Schritt für Schritt:

1. Ein neues Datenpaket kann als zip-Datei aus dem Internet heruntergeladen oder als ungezipter Ordner selbst zusammengestellt werden.
2. Im Menü/Einzelspieler wird eine Welt ausgewählt (nicht betreten) und der Button "Bearbeiten" gedrückt.
3. Im Bearbeiten-Menü wird der Button "Ordner öffnen" gedrückt. Das öffnet den Weltordner dieser Welt.
4. Doppelklick auf den Ordner datapacks öffnet den Datenpaket-Ordner.
5. In diesen Ordner wird das neue Datenpaket (gezipt oder ungezipt) verschoben.
6. Beim Betreten der Welt werden alle Datenpakete geladen.
7. Nachträglich können sie auch mit dem Befehl /reload geladen werden.
8. Mit dem Befehl /datapack list werden alle Datenpakete aufgelistet.
9. Mit dem Befehl /datapack enable kann die Reihenfolge der Datenpakete festgelegt werden.
10. Mit dem Befehl /datapack disable kann ein Datenpaket dauerhaft deaktiviert werden.

Auch Serverwelten haben einen Ordner datapacks in ihrem Weltordner (der Weltordner ist in den server.properties festgelegt).

Die Standard-Weltdaten sind ebenfalls ein Datenpaket, es heißt vanilla.

Definitionsdatei

Die Datei pack.mcmeta steht direkt im Paket-Ordner. Sie speichert die allgemeinen Informationen für ein Datenpaket. Diese Datei ist für Minecraft das Erkennungszeichen, dass sich der Ordner, in dem sich die Datei befindet, ein Datenpaket-Ordner ist. Fehlt die Datei, wird der Ordner nicht als Datenpaket erkannt und erscheint nicht in der Auflistung bei dem Befehl /datapack list. Der Dateityp mcmeta bedeutet MineCraft Metadaten, es ist aber eine normale Textdatei im JSON-Format.

Die pack.mcmeta-Datei hat folgenden Aufbau:

• Die namenlose Haupteigenschaft.
  • pack: Alle allgemeinen Informationen für das Datenpaket.
    • description: Die Beschreibung des Datenpaketes. Sie wird angezeigt, wenn man sich die Datenpakete mit dem Befehl /datapack list anzeigt und mit der Maus über einen Namen fährt. Die Beschreibung kann auch leer sein. Für die Darstellung von bunten Texten in dieser Beschreibung können Formatierungscodes verwendet werden.
    • pack_format: Das Format des Datenpaketes. Zur Zeit ist nur der Wert "1" sinnvoll. Sollte sich mit einer zukünftigen Minecraft-Version das JSON-Format einer der Weltdaten ändern, erhöht sich die Paketformatnummer, um alte Datenpakete von neuen unterscheiden und eine Warnung ausgeben zu können.

Aufbau

Ein Datenpaket muss einen bestimmten Aufbau haben, damit Minecraft die einzelnen Daten erkennen und laden kann:

• Das komplette Paket muss in einem Ordner stehen. Der Name dieses Paket-Ordners wird mit dem Zusatz "file/" durch den Befehl /datapack list angezeigt. Üblicherweise ist der Paket-Ordner eine komprimierte zip-Datei, er kann aber auch unkomprimiert sein.
• In dem Paket-Ordner muss die Definitionsdatei pack.mcmeta stehen, die allgemeine Informationen des Paketes enthält. Fehlt diese Datei oder hat sie einen falschen Inhalt, wird das Datenpaket nicht erkannt.
• Im Paket-Ordner muss ein Unterordner namens data existieren. Darin stehen die Weltdaten-Unterordner mit den jeweiligen Weltdaten. Alle Weltdaten-Unterordner und ihr Inhalt sind optional. Fehlt ein Weltdaten-Unterordner oder eine Weltdaten-Datei, wird sie aus den Minecraft Standard-Weltdaten geladen. Gibt es stattdessen einen zusätzlichen Unterordner oder eine zusätzliche Datei, hat das für Minecraft keine Bedeutung und wird ignoriert. Enthält eine Datei einen Syntaxfehler (Klammer fehlt, Komma zuviel, unbekannter ID-Name für einen Block oder Gegenstand etc.), wird sie ignoriert.
• Zwar gehören die Minecraft-Konstruktionsvorlagen zu den Standard-Weltdaten, aber im Gegensatz zu anderen Standard-Weltdaten sind sie über ein Datenpaket nicht änderbar.

Aufbau des Paket-Ordners:

• Name des Datenpakets
  • pack.mcmeta: Die Definitionsdatei.
  • data: Eigene Weltdaten.
    • minecraft: Veränderte Minecraft-Weltdaten. Nicht alle Minecraft-Weltdaten können verändert werden, möglich ist es nur für folgende Daten:
      • advancements: Veränderte Fortschrittsdaten (hier die Unterordner).
      • loot_tables: Veränderte Beutetabellen (hier die Unterordner).
      • recipes: Veränderte Rezeptdaten.
      • tags: Veränderte Aliasdaten (hier die Unterordner).
    • eigener-namensraum: Für eigene Weltdaten legt man einen eigenen Namensraum an. Folgende Weltdaten können im Originalspiel neu hinzugefügt werden:
      • advancements: Eigene Fortschrittsdaten.
      • functions: Eigene Funktionen.
      • loot_tables: Eigene Beutetabellen.
      • recipes: Eigene Rezepte.
      • structures: Eigene Konstruktionsvorlagen.
      • tags: Eigene Aliasdaten.

Funktionsweise

In Datenpaketen sind alle Daten optional. Fehlen dort Minecraft-Weltdaten, werden sie aus den Standard-Weltdaten geladen, die immer alle Minecraft-Weltdaten enthalten. Es ist aber auch möglich, mit dem Befehl /datapack disable vanilla die Standard-Weltdaten zu deaktivieren. Dann droppen u. a. die Kreaturen keine Beute, man kann keine Fortschritte erhalten und keine Handwerk-Rezepte mehr anwenden.

Wenn für die Welt mehrere Datenpakete gespeichert sind, werden sie alle geladen. Mit dem Befehl /datapack enable kann ihre Reihenfolge festgelegt werden, wobei die Weltdaten eines späteren Paketes immer die Weltdaten der früheren Pakete überlagern.

Um Weltdaten zu ändern, kopiert man die entsprechende Standard-Weltdaten-Datei und verändert sie. Wenn man also z.B. nur die Drops des Creepers ändern möchte, kopiert man die Creeper-Beutetabelle und ändert darin die Drops. Die veränderte Datei wird dann in das Datenpaket gestellt:

• Name des Datenpakets
  • pack.mcmeta: Die Definitionsdatei
  • data
    • minecraft
      • loot_tables
        • entities
          • creeper.json: Die Beutetabelle für die Creeper.