Panduan / Pemecahan Masalah

Addon Bedrock itu zip, dan manifest-nya yang bikin gagal

Sebagian besar impor .mcaddon yang ditolak sebenarnya zip valid dengan satu baris header yang salah, dan pesan errornya tidak pernah menyebut kolom mana yang bikin rusak.

2026-09-17

Sebuah .mcaddon adalah arsip zip dengan ekstensi berbeda, dan game menolaknya karena alasan yang sama sekali tidak berhubungan dengan zip-nya. Biang keladi yang paling umum adalah manifest.json — file kecil dengan header yang dua UUID-nya harus berbeda dan format_version-nya bukan versi game yang kamu targetkan.

Dua UUID, jangan pernah sama

Sebuah manifest membawa header dan array modules. Masing-masing butuh uuid sendiri, dan memakai ulang satu UUID di keduanya adalah penyebab penolakan paling umum:

{
  "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 adalah nilai 128-bit yang ditulis sebagai 32 digit heksadesimal dalam lima grup berhubung. Generator apa pun boleh; yang duplikat tidak. version dan min_engine_version adalah array tiga bilangan bulat, bukan string — "1.0.0" gagal secara diam-diam di sebagian build.

Java tidak punya manifest sama sekali

Inilah perbedaan yang bikin orang bingung saat berpindah edisi. Resource pack Java menyertakan pack.mcmeta dengan bilangan bulat pack_format. Bedrock menyertakan manifest.json dengan UUID dan daftar modul. Tidak ada file yang dibaca oleh edisi lain, dan pack tidak bisa dipindahkan hanya dengan mengganti nama arsipnya.

Periksa sebelum mengimpor

Ekstrak arsipnya dan lihat level teratasnya. Pack yang tersarang satu folder lebih dalam — MyPack/manifest.json alih-alih manifest.json — terimpor sebagai tidak ada apa-apa, tanpa error. Manifest harus berada di samping konten textures/ atau behavior_packs/ yang dijelaskannya.

Model blok adalah format terpisah

JSON model blok Java bukan file geometri Bedrock, dan keduanya tidak bisa saling tukar:

Keduanya menyatakan grid kubus 16 unit per blok, itulah sebabnya model yang dihasilkan terlihat benar di salah satu edisi tapi terimpor sebagai bentuk kosong di edisi lainnya.

Nama registri tidak bisa saling tukar

Bedrock dan Java berbeda pendapat soal pengenal untuk konten yang sama. Pack yang merujuk nama Java untuk enchantment, effect, atau biome akan termuat lalu diam-diam tidak melakukan apa-apa, karena nama itu tidak mengarah ke entri mana pun. Registrinya sendiri berbeda ukuran antar edisi, jadi pack yang ditulis berdasarkan daftar satu edisi tidak bisa dianggap lengkap di edisi lain.

Validasi manifest-nya, periksa tata letak arsipnya, dan hasilkan model blok di Bedrock & Pack Tools.

Bedrock & Pack Tools →