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 o błędzie nigdy nie wskazuje pola, które go zepsuło.
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 UUID nagłówka i UUID modułu, które muszą się od siebie różnić, oraz z format_version, który nie jest wersją gry, na którą celujesz.
Dwa UUID-y, nigdy ten sam
Manifest zawiera header oraz tablicę modules. Każdy z nich 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" zostanie odrzucone.
Java nie ma żadnego manifestu
To właśnie ten podział sprawia problemy osobom przenoszącym się między edycjami. Zasób Java zawiera pack.mcmeta deklarujący obsługiwane formaty (min_format i max_format w obecnych wersjach). Bedrock zawiera 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 jedynie nazwę archiwum.
Sprawdź przed importem
Rozpakuj archiwum i zajrzyj na najwyższy poziom. Paczka zagnieżdżona o jeden folder głębiej — MyPack/manifest.json zamiast manifest.json — zaimportuje się jako nic, bez żadnego błędu. Manifest musi znajdować się w katalogu głównym każdej paczki, obok folderów, które opisuje.
Modele bloków to osobny format
Model bloku w formacie JSON dla Java to nie to samo co plik geometrii dla Bedrock i te dwa formaty nie są wymienne. Model Java to zwykle po prostu parent plus mapa textures — lista prostopadłościanów elements jest potrzebna tylko dla niestandardowego kształtu — natomiast Bedrock opisuje kształty we własnym formacie minecraft:geometry. Oba odmierzają 16 jednostek na blok, dlatego model może wyglądać poprawnie w jednej edycji, a w drugiej zaimportować się jako nic.
Nazwy rejestrów nie są wymienne
Bedrock i Java nie zgadzają się co do identyfikatorów tego samego contentu. Paczka odwołująca się do nazwy z Java dla zaklęcia, efektu lub biomu wczyta się, a potem po cichu nic nie zrobi, ponieważ nazwa nie wskazuje żadnego wpisu. Same rejestry różnią się rozmiarem między edycjami, więc nie można zakładać, że paczka stworzona pod listę jednej edycji będzie kompletna w drugiej.
Zweryfikuj manifest, sprawdź układ archiwum i wygeneruj model bloku w Bedrock & Pack Tools.