Minecraft Wiki
Registrieren
Advertisement
Information icon
Dieser Inhalt ist nur für Minecraft: Java Edition.

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.
  • Rezepte fürs Handwerk, Erhitzen, Aufwerten und Verzieren.
  • Alternative ID-Namen für Blöcke und Gegenstände.
  • Anwendung eigener Befehlslisten mittels Funktionen.
  • Laden eigener Konstruktionen mit dem Konstruktionsblock.
  • Das Format für Chatnachrichten.
  • Generierung von eigenen Dimensionen .
  • Generierung von eigenen Biomen, Merkmalen und Bauwerken mit der angepassten Weltgenerierung.
  • Gegenstandsmodifizierer die Gegenstände im Inventar verändern können.
  • Verzierungsmuster und -materialien.
  • Schadensarten.

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 Einstellung des Betriebssystems werden die 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. 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. Für das zu verwendende Format, siehe Paketformat.
      • supported_formats: Eine einzelne Paketformat-Nummer, eine Liste oder ein Verbundtyp, die das Datenpaket ebenfalls unterstützt.
        • min_inclusive: Erste Nummer.
        • max_inclusive: Letzte Nummer.
    • filter: Die Filter des Datenpakets. Man gibt hier alle Daten an, die von Datenpaketen mit geringerer Priorität "herausgefiltert", also ignoriert, werden sollen. Möchte man zum Beispiel in einer Welt eigene Fortschritte haben und keine Vanilla-Fortschritte mehr, gibt man diese hier an und das Spiel ignoriert diese komplett, als wären sie in den Standard-Weltdaten nie vorhanden gewesen.
      • block: Die einzige Eigenschaft von "filter".
        • Ein Pfad zu einer Datei oder einem Ordner.
          • namespace: Der Namensraum, in dem sich die zu ignorierende Datei/der zu ignorierende Ordner befinden. Wird er weggelassen, sind alle Namensräume betroffen.
          • path: Der genaue Pfad. Er muss ab dem Namensraum angegeben werden. Gibt man nur den Pfad zu einem Ordner gefolgt von /.* an, werden alle Dateien und Unterordner dieses Ordners ignoriert. Wird der Pfad weggelassen, werden alle Daten im Namensraum ignoriert.
    • features: Angabe aller experimentellen Spielelemente, die mit dem Datenpaket aktiviert werden sollen. Datenpakete mit aktivierten experimentellen Spielelementen können Welten, bei denen mindestens eines der angegeben experimentellen Spielelemente deaktiviert ist, nicht nach der Erstellung hinzugefügt werden.
      • enabled: Liste aller experimentellen Spielelemente, die mit Erstellung der Welt aktiviert seien sollen.

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

{
  "pack": {
    "pack_format": 17,
    "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:

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.

Paketformat[]

In der nachstehenden Tabelle wird der Versionsbereich anhand der einzelnen Paketformatnummern beschrieben:

Format Version
4 1.13-1.14.4
5 1.15-1.16.1
6 1.16.2-1.16.5
7 1.17-1.17.1
8 1.18-1.18.1
9 1.18.2
10 1.19-1.19.3
11 1.19.4 (23w03a-23w05a)
12 1.19.4
13 1.20 (23w12a-23w14a)
14 1.20 (23w12a-23w17a)
15 1.20-1.20.1
16 1.20.2 (23w31a)
17 1.20.2 (23w32a)

Geschichte[]

Versionsgeschichte der Java Edition
Vollversion 1.13
17w43a
  • Datenpakete hinzugefügt, bisher wurden geänderte Weltdaten im Unterordner /data abgelegt.
  • Beutetabellen (/loot_tables), Fortschrittsdaten (/advancements), Funktionen (/functions), Rezeptdaten (/recipes) und eigene Konstruktionsvorlagen (/structures) werden in Datenpaketen gespeichert.
17w46a
17w48a
  • Datenpakete können benutzerdefinierte Rezepte laden.
  • Formatversion mit dem Wert 4 hinzugefügt.
17w49a
17w49b
  • Für Funktionen können Aliasse erstellt werden.
  • In Tick markierte Funktionen werden zu Beginn jedes Ticks ausgeführt.
Vollversion 1.15
19w38a
1.15-pre2
  • Die Formatversion wird auf 5 in der pack.mcmeta geändert.
Vollversion 1.16 (1.16-pre1)
  • Datenpakete können beim Erstellen einer Welt direkt über eine Auswahlliste hinzugefügt werden. Man sieht in dieser aber immer das Standard-Icon.
Vollversion 1.16.2
20w27a
  • In der Auswahlliste sieht man das Standard-Icon nur noch, wenn das Datenpaket keine pack.png-Datei enthält.
1.16.2-rc1
  • Die Formatversion wird auf 6 in der pack.mcmeta geändert.
Vollversion 1.17
20w45a
  • Das Pack-Format in version.json wird in Daten- und Ressourcenversionen aufgeteilt.
20w46a
  • Die Formatversion wird auf 7 in der pack.mcmeta geändert.
  • Gegenstandsmodifizierer (/item_modifiers) hinzugefügt.
Vollversion 1.18 (21w37a)
  • Die Formatversion wird auf 8 in der pack.mcmeta geändert.
Vollversion 1.18.2 (1.18.2-pre1)
  • Die Formatversion wird auf 9 in der pack.mcmeta geändert.
Vollversion 1.19 (22w11a)
  • Neue Eigenschaft filter in der Definitionsdatei hinzugefügt.
  • Die Formatversion wird auf 10 in der pack.mcmeta geändert.
Vollversion 1.19.3 (22w42a)
Vollversion 1.19.4
23w03a
  • Die Formatversion wird auf 11 in der pack.mcmeta geändert.
23w04a
23w06a
  • Die Formatversion wird auf 12 in der pack.mcmeta geändert.
  • Schadensarten (/damage_type) werden hinzugefügt.
Vollversion 1.20
23w12a
  • Die Formatversion wird auf 13 in der pack.mcmeta geändert.
23w16a
  • Die Formatversion wird auf 14 in der pack.mcmeta geändert.
23w18a
  • Die Formatversion wird auf 15 in der pack.mcmeta geändert.
Vollversion 1.20.2
23w31a
  • Neue Eigenschaft supported_formats in der Definitionsdatei hinzugefügt.
  • Die Formatversion wird auf 16 in der pack.mcmeta geändert.
23w32a
  • Die Formatversion wird auf 17 in der pack.mcmeta geändert.
Advertisement