Poradniki / Rozwiązywanie problemów

Dodatek do Bedrock to plik zip, a manifest jest powodem, dla którego się nie wczytuje

Większość odrzuconych importów .mcaddon to poprawny plik zip z jednym błędnym wierszem nagłówka, a komunikat błędu nigdy nie wskazuje pola, które go zepsuło.

2026-09-17

Plik .mcaddon to archiwum zip z innym rozszerzeniem, a gra odrzuca go z powodów, które nie mają nic wspólnego z samym zipem. Zwykle winowajcą jest manifest.json — niewielki plik z nagłówkiem, którego dwa UUID-y muszą być różne, a którego format_version nie jest wersją gry, na którą celujesz.

Dwa UUID-y, nigdy ten sam

Manifest zawiera header oraz tablicę modules. Każdy potrzebuje własnego uuid, a użycie tego samego w obu to najczęstsza przyczyna odrzucenia:

{
  "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]
    }
  ]
}

UUID-y to wartości 128-bitowe zapisywane jako 32 cyfry szesnastkowe w pięciu grupach rozdzielonych myślnikami. Dowolny generator jest w porządku; duplikat już nie. version i min_engine_version to tablice trzech liczb całkowitych, a nie ciągi znaków — "1.0.0" w niektórych kompilacjach zawodzi po cichu.

Java nie ma żadnego manifestu

To właśnie ten podział sprawia problemy osobom przenoszącym się między edycjami. Zasób Java dostarcza pack.mcmeta z liczbą całkowitą pack_format. Bedrock dostarcza manifest.json z UUID-ami i listą modułów. Żaden z tych plików nie jest odczytywany przez drugą edycję i nie można przenieść paczki, zmieniając nazwę archiwum.

Sprawdź, zanim zaimportujesz

Rozpakuj archiwum i spójrz na najwyższy poziom. Paczka zagnieżdżona o jeden folder głębiej — MyPack/manifest.json zamiast manifest.json — importuje się jako zupełnie nic, bez żadnego błędu. Manifest musi leżeć obok zawartości textures/ lub behavior_packs/, którą opisuje.

Modele bloków to osobny format

Model bloku w Javie w formacie JSON to nie to samo co plik geometrii Bedrock i te dwa formaty nie są wymienne:

Oba wyrażają siatkę sześcianów o 16 jednostkach na blok, dlatego wygenerowany model wygląda poprawnie w jednym, a w drugim importuje się jako pusty kształt.

Nazwy w rejestrach nie są wymienne

Bedrock i Java nie zgadzają się co do identyfikatorów tego samego contentu. Paczka, która odwołuje się do nazwy z Javy dla zaklęcia, efektu lub biomu, wczyta się, a potem po cichu nic nie zrobi, ponieważ nazwa nie prowadzi do żadnego wpisu. Same rejestry różnią się rozmiarem między edycjami, więc nie można zakładać, że paczka napisana pod listę jednej edycji będzie kompletna w drugiej.

Zweryfikuj manifest, sprawdź układ archiwum i wygeneruj model bloku w Bedrock & Pack Tools.

Bedrock & Pack Tools →