Datenpaket

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.

Konzept

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.
• Prädikate und Bedingungen für Befehle.
• 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.
• Generierung von eigenen Dimensionen
• Generierung von eigenen Biomen, Bauwerke und Dekorationen mit der angepassten Weltgenerierung.
• Gegenstandsmodifizierer die Gegenstände im Inventar verändern können.

Datenpakete werden eingelesen:

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

Installation und Deinstallation

Man kann in 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 die Schaltfläche „Bearbeiten“ gedrückt.
3. Im Bearbeiten-Menü wird die Schaltfläche „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 ein Datenpaket wieder aktiviert werden und 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.

Je nach Dateiendungen nicht angezeigt, dann wird zwar als Dateiname pack.mcmeta sichtbar angezeigt, aber der volle Name lautet, wenn man mit einem Rechtsklick auf die Datei geht und auf Eigenschaften klickt, dann pack.mcmeta.txt, wodurch das Datenpaket nicht erkannt wird!

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. Seit Minecraft-Version 1.17 wird Format 7 verwendet. 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.

Die Datenpaket-Datei .minecraft/saves/Name des Weltordners/datapacks/Name des Datenpakets/pack.mcmeta sieht so aus:

{
  "pack": {
    "pack_format": 7,
    "description": "Mein Datenpaket"
  }
}

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).
      • dimension: Veränderte Dimensionen.
      • dimension_type: Verändert Eigenschaften von Dimensionen.
      • worldgen: Verändert die Weltgeneration wie Biome, Bauwerke und Dekorationen.
    • 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.
      • predicates: Eigene Prädikate.
      • recipes: Eigene Rezepte.
      • structures: Eigene Konstruktionsvorlagen.
      • tags: Eigene Aliasdaten.
      • dimension: Eigene Dimensionen.
      • dimension_type: Eigene Eigenschaften von Dimensionen.
      • worldgen: Eigene Weltgeneration sowie eigene Biome, Bauwerke und Dekorationen.
      • item_modifiers: Eigene Gegenstandsmodifizierer.

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. Das hat weitreichende Auswirkungen (siehe hier).

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.