Anleitungen / Fehlerbehebung

Ein Bedrock-Addon ist eine Zip-Datei, und das Manifest ist der Grund, warum es fehlschlägt

Die meisten abgelehnten .mcaddon-Importe sind eine gültige Zip-Datei mit einer falschen Kopfzeile, und die Fehlermeldung nennt nie das Feld, das den Fehler verursacht hat.

2026-09-17

Ein .mcaddon ist ein Zip-Archiv mit einer anderen Dateiendung, und das Spiel lehnt es aus Gründen ab, die nichts mit der Zip-Datei zu tun haben. Der übliche Übeltäter ist manifest.json — eine kleine Datei mit einem Header, dessen zwei UUIDs unterschiedlich sein müssen und dessen format_version nicht die Spielversion ist, auf die du abzielst.

Zwei UUIDs, niemals dieselbe

Ein Manifest enthält eine header und ein modules-Array. Jede braucht ihre eigene uuid, und dieselbe in beiden wiederzuverwenden ist die häufigste Ablehnung überhaupt:

{
  "format_version": 2,
  "header": {
    "name": "My Pack",
    "description": "Example",
    "uuid": "aaaaaaaa-0000-0000-0000-000000000000",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 0]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "bbbbbbbb-0000-0000-0000-000000000001",
      "version": [1, 0, 0]
    }
  ]
}

UUIDs sind 128-Bit-Werte, geschrieben als 32 Hexadezimalziffern in fünf durch Bindestriche getrennten Gruppen. Jeder Generator ist in Ordnung; ein Duplikat nicht. version und min_engine_version sind Arrays aus drei Ganzzahlen, keine Strings — "1.0.0" schlägt bei manchen Builds stillschweigend fehl.

Java hat überhaupt kein Manifest

Das ist die Trennung, die Leute stolpern lässt, die zwischen den Editionen wechseln. Ein Java-Ressourcenpaket liefert eine pack.mcmeta mit einer pack_format-Ganzzahl. Bedrock liefert manifest.json mit UUIDs und einer Modulliste. Keine der beiden Dateien wird von der anderen Edition gelesen, und ein Paket kann nicht durch Umbenennen des Archivs portiert werden.

Prüfe, bevor du importierst

Entpacke das Archiv und sieh dir die oberste Ebene an. Ein Paket, das eine Ordnerebene tief verschachtelt ist — MyPack/manifest.json statt manifest.json — wird überhaupt nicht importiert, ohne Fehlermeldung. Das Manifest muss neben dem textures/- oder behavior_packs/-Inhalt liegen, den es beschreibt.

Blockmodelle sind ein separates Format

Ein Java-Blockmodell-JSON ist keine Bedrock-Geometriedatei, und die beiden sind nicht austauschbar:

Beide drücken ein Würfelraster von 16 Einheiten pro Block aus, weshalb ein generiertes Modell in dem einen richtig aussieht und in dem anderen als leere Form importiert wird.

Registry-Namen sind nicht austauschbar

Bedrock und Java sind sich bei Bezeichnern für denselben Inhalt uneinig. Ein Paket, das einen Java-Namen für eine Verzauberung, einen Effekt oder ein Biom referenziert, wird geladen und dann stillschweigend nichts tun, weil der Name zu keinem Eintrag aufgelöst wird. Die Registries selbst unterscheiden sich in ihrer Größe zwischen den Editionen, sodass ein Paket, das gegen die Liste einer Edition erstellt wurde, nicht als vollständig in der anderen angenommen werden kann.

Validiere das Manifest, prüfe das Archivlayout und generiere ein Blockmodell in den Bedrock & Pack Tools.

Bedrock & Pack Tools →