MC Toolkit

Anleitungen / Fehlerbehebung

pack.mcmeta: pack_format-Nummern und die „inkompatibel"-Warnung

Ein falsches Feld lässt Minecraft dein Pack ausgrauen. Hier ist die Form, die 26.x verlangt, wie du alte und neue Versionen in einer Datei abdeckst und wo die Datei liegen muss.

Fast jedes „mein Pack wird als inkompatibel angezeigt" ist ein Feld in einer kleinen Datei.

Die Datei

{
  "pack": {
    "min_format": 97,
    "max_format": 97,
    "description": "My pack"
  }
}

Das ist ein 26.3-Ressourcenpack; ein 26.3-Datenpack verwendet 121. Seit 1.21.9 muss jedes Format über 64 (Ressourcen) bzw. 81 (Daten) mit min_format und max_format deklariert werden. Ein Pack, das weiterhin ein bloßes "pack_format": 97 schreibt — was die meisten Tutorials und die meisten Generatoren noch zeigen — wird abgelehnt und als inkompatibel angezeigt.

Sie muss exakt pack.mcmeta heißen und im Wurzelverzeichnis der Zip-Datei liegen — neben assets/ oder data/, nicht in einem Ordner innerhalb der Zip-Datei. Den enthaltenden Ordner statt seines Inhalts zu zippen ist der zweithäufigste Fehler, und er sieht identisch aus wie eine falsche Formatnummer.

Ressourcenpacks und Datenpacks verwenden unterschiedliche Nummern

Das ist der Teil, der viele erwischt: Die beiden Zähler haben sich vor Jahren auseinanderentwickelt und sind nicht austauschbar. Ein Datenpack, das eine Ressourcenpack-Nummer verwendet, wird ausgegraut, obwohl die Nummer „aktuell" ist.

Statt eine Tabelle auswendig zu lernen, die mit jedem Release veraltet, lies die Nummer aus einem Vanilla-Pack für die Version ab, die du anpeilst — oder lass sie von einem Generator eintragen.

Eine Datei für alte und neue Versionen

Eine einzelne Nummer festzulegen bedeutet, dass das Pack beim nächsten Release bricht. Eine Bereichsangabe nicht — aber eine Bereichsangabe, die bis in 26.x reicht, muss für zwei Generationen des Spiels gleichzeitig geschrieben werden:

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 46, "max_inclusive": 64 },
    "min_format": 46,
    "max_format": 97,
    "description": "My pack"
  }
}

min_format/max_format ist der Bereich, den 26.x liest. pack_format und supported_formats sind nur für Clients älter als 1.21.9 vorhanden: supported_formats muss genau bei 64 enden (81 bei einem Datenpack), min_format muss seinem unteren Ende entsprechen, und pack_format muss darin liegen. Der alte Ratschlag — supported_formats bis zu einer großen Zahl wie 99 — ist jetzt die eine Form, die 26.x rundheraus ablehnt. Für ein Pack, das nur Texturen oder Rezepte hinzufügt — was die meisten Packs sind — ist ein weiter Bereich ehrlich, weil darin zwischen den Versionen tatsächlich nichts bricht.

Description nimmt Textkomponenten an

"description": [
  { "text": "My pack ", "color": "gold" },
  { "text": "v2", "color": "gray", "italic": true }
]

Abschnittszeichen-Codes (§6) funktionieren ebenfalls noch, aber die JSON-Form übersteht Copy-Paste durch Tools, die Steuerzeichen entfernen.

Overlays, um mehrere Versionen gleichzeitig zu unterstützen

"overlays": { "entries": [
  { "formats": { "min_inclusive": 42, "max_inclusive": 45 }, "directory": "older" }
] }

Der Ordner older/ im Wurzelverzeichnis des Packs wird nur bei diesen Formaten verwendet. So unterstützt ein einziger Download zwei Versionen mit unterschiedlichen Modellformaten, statt zwei Zips auszuliefern.

Schnelldiagnose

SymptomUrsache
Ausgegraut, „für eine ältere/neuere Version erstellt"falsche Formatnummer, oder (1.21.9 und später) kein min_format/max_format
Pack wird gar nicht aufgelistetpack.mcmeta nicht im Wurzelverzeichnis der Zip-Datei, oder ungültiges JSON
Lädt, Texturen fehlenPack-Format in Ordnung; die Textur-Pfade sind falsch
Funktioniert im Einzelspieler, nicht auf einem ServerDatenpack im falschen Weltordner

Ein nachgestelltes Komma ist ungültiges JSON und erzeugt den Fall „wird gar nicht aufgelistet", nicht eine Fehlermeldung.

Erzeuge eine gültige Datei für deinen Pack-Typ und deine Zielversion — mit min_format/max_format und den Legacy-Feldern, wo eine ältere Version sie benötigt — mit dem pack.mcmeta Generator.

pack.mcmeta-Generator →

Weitere Anleitungen

Alle ansehen →