Cara Membuat manifest.json untuk Add-on Minecraft Bedrock

manifest.json adalah "kartu identitas" setiap pack. Tanpa file ini, Minecraft tidak akan mengenali foldermu sebagai pack. Kesalahan kecil di file ini adalah penyebab paling umum add-on tidak muncul, jadi pahami setiap bagiannya.

Bentuk dasar

Berikut manifest lengkap untuk sebuah Behavior Pack:

{
  "format_version": 2,
  "header": {
    "name": "KawaiiVerse Tools",
    "description": "Item dan mob tambahan dari KawaiiVerse",
    "uuid": "0b7c7f6e-3a51-4c8e-9d40-1f2a6b8c9e01",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 0]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "6e2a1d84-5b0c-4f37-8a9e-2c4d6f8a0b12",
      "version": [1, 0, 0]
    }
  ],
  "dependencies": [
    {
      "uuid": "a91f3c27-7d4e-4b60-b8f1-3e5c7a9d1f23",
      "version": [1, 0, 0]
    }
  ]
}

Bagian demi bagian

format_version

Versi format manifest. Nilai 2 adalah format yang paling banyak dipakai dan didukung semua versi modern. Mojang juga memperkenalkan format yang lebih baru dengan penulisan versi berbentuk teks, tetapi untuk belajar, format 2 sudah cukup.

header

modules

Daftar isi pack. Setiap modul punya type, UUID sendiri (berbeda dengan UUID header), dan versi.

dependencies

Pack lain atau modul script yang dibutuhkan. Untuk add-on biasa, BP mencantumkan UUID header milik RP, sehingga RP ikut aktif saat BP diaktifkan.

Manifest Resource Pack

{
  "format_version": 2,
  "header": {
    "name": "KawaiiVerse Tools (Resources)",
    "description": "Tekstur dan model KawaiiVerse Tools",
    "uuid": "a91f3c27-7d4e-4b60-b8f1-3e5c7a9d1f23",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 0]
  },
  "modules": [
    {
      "type": "resources",
      "uuid": "d4b8e2f1-0c6a-4e9b-a7d3-5f1e9c2b8a34",
      "version": [1, 0, 0]
    }
  ]
}

Perhatikan bahwa UUID header RP di atas (a91f3c27-…) sama dengan yang dicantumkan di dependencies milik BP. Itulah yang menghubungkan keduanya.

Menambahkan Script API

Untuk memakai JavaScript, tambahkan modul script dan dependency ke modul @minecraft/server:

"modules": [
  { "type": "data", "uuid": "6e2a1d84-5b0c-4f37-8a9e-2c4d6f8a0b12", "version": [1, 0, 0] },
  {
    "type": "script",
    "language": "javascript",
    "uuid": "f0e1d2c3-b4a5-4968-8776-655443322110",
    "entry": "scripts/main.js",
    "version": [1, 0, 0]
  }
],
"dependencies": [
  { "uuid": "a91f3c27-7d4e-4b60-b8f1-3e5c7a9d1f23", "version": [1, 0, 0] },
  { "module_name": "@minecraft/server", "version": "2.0.0" }
]

Isi version untuk @minecraft/server harus versi yang didukung game-mu. Versi stabil tidak butuh experiments, sedangkan versi -beta membutuhkan experiment Beta APIs. Cek versi yang tersedia di dokumentasi resmi Microsoft Learn (Minecraft Creator) sebelum memilih.

Contoh scripts/main.js sederhana:

import { world } from "@minecraft/server";

world.afterEvents.playerSpawn.subscribe(({ player, initialSpawn }) => {
  if (initialSpawn) player.sendMessage("Selamat datang di dunia KawaiiVerse!");
});

Cara membuat UUID

UUID adalah kode acak 36 karakter. Pilih salah satu cara berikut:

• Buka situs generator UUID versi 4 (cari "uuid generator").
• Di Windows PowerShell: [guid]::NewGuid()
• Di Linux atau macOS: uuidgen
• Di Node.js: crypto.randomUUID()

Satu pack membutuhkan minimal dua UUID: satu untuk header dan satu untuk setiap modul.

Kesalahan yang paling sering terjadi

• UUID dipakai ulang. Dua pack dengan UUID header yang sama akan saling menimpa atau salah satunya tidak muncul.
• Lupa koma atau kurung. JSON sangat ketat. Satu koma berlebih di elemen terakhir sudah cukup membuat pack gagal dibaca. Gunakan editor yang memeriksa JSON, misalnya VS Code.
• Komentar di JSON. Minecraft menoleransi komentar // di banyak file, tetapi validator dan alat lain bisa menolaknya. Sebaiknya hindari komentar di manifest.
• Versi dependency salah. Versi di dependencies harus sama dengan versi header pack yang dirujuk.
• min_engine_version terlalu tinggi. Pemain dengan versi game lebih lama tidak bisa memasang pack-mu.

Jika pack tetap tidak muncul, nyalakan Content Log untuk melihat pesan error. Caranya ada di Troubleshooting Bedrock.