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:
- Ein neues Datenpaket kann als zip-Datei aus dem Internet heruntergeladen oder als ungezipter Ordner selbst zusammengestellt werden.
- Im Menü/Einzelspieler wird eine Welt ausgewählt (nicht betreten) und die Schaltfläche „Bearbeiten“ gedrückt.
- Im Bearbeiten-Menü wird die Schaltfläche „Ordner öffnen“ gedrückt. Das öffnet den Weltordner dieser Welt.
- Doppelklick auf den Ordner datapacks öffnet den Datenpaket-Ordner.
- In diesen Ordner wird das neue Datenpaket (gezipt oder ungezipt) verschoben.
- Beim Betreten der Welt werden alle Datenpakete geladen.
- Nachträglich können sie auch mit dem Befehl
/reload
geladen werden. - Mit dem Befehl
/datapack list
werden alle Datenpakete aufgelistet. - Mit dem Befehl
/datapack enable
kann ein Datenpaket wieder aktiviert werden und die Reihenfolge der Datenpakete festgelegt werden. - 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.
- description: Die Beschreibung des Datenpaketes. Sie wird angezeigt, wenn man sich die Datenpakete mit dem Befehl
- 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.
- Ein Pfad zu einer Datei oder einem Ordner.
- block: Die einzige Eigenschaft von "filter".
- 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.
- pack: Alle allgemeinen Informationen für das Datenpaket.
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:
- Name des Datenpakets
- pack.png: Das Icon des Datenpakets. Es wird vom Spiel nur verwendet, wenn das Datenpaket direkt beim Erstellen der Welt hinzugefügt wird.
- 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).
- damage_type: Veränderte Schadensarten.
- chat_types: Verändertes Chatnachrichtenformat.
- 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.
- trim_material: Veränderte Verzierungsmaterialien.
- trim_pattern: Veränderte Verzierungsmuster.
- 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.
- damage_type: Eigene Schadensarten.
- 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.
- trim_material: Eigene Verzierungsmaterialien.
- trim_pattern: Eigene Verzierungsmuster.
- minecraft: Veränderte Minecraft-Weltdaten. Nicht alle Minecraft-Weltdaten können verändert werden, möglich ist es nur für folgende Daten:
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.
- entities
- loot_tables
- minecraft
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Standard-Ressourcen |
| ||||
---|---|---|---|---|---|
Standard-Weltdaten |
| ||||
Spielwelt | |||||
Software | |||||
Speicherformate | |||||
Einstellungen | |||||
Mehrspieler | |||||
Historisch |