# catalogue.json: metadata dan lokalisasi game PlayDrop

Referensi untuk judul game, deskripsi, tag genre, gambar dan video listingan, terjemahan, serta field server opsional dalam format PlayDrop Connector.

Source: https://www.playdrop.ai/id/docs/catalogue-json

[PlayDrop Connector](https://www.playdrop.ai/id/docs/connectors) memublikasikan game Anda dengan `catalogue.json` yang ringkas: objek JSON dengan `apps` yang berisi tepat satu game. Hanya `name` yang wajib diisi. Agen mengirimkannya sebagai argumen katalog bersama file game; tidak perlu alat command-line. PlayDrop Cloud mengelola metadata ini untuk Anda.

## Contoh publikasi minimal

Pastikan slug huruf kecil tetap sama saat memperbarui. Tambahkan judul tampilan, deskripsi yang akurat, kontrol, bahasa sumber, dan tag yang dikenal sesuai kebutuhan. Contoh di bawah ini menggunakan tag genre platformer yang sudah ada.

```json
{
  "apps": [{
    "name": "moon-jump",
    "displayName": "Moon Jump",
    "description": "Jump between lunar platforms and reach the finish.",
    "controls": "Arrow keys to move. Space to jump.",
    "sourceLocale": "en",
    "tags": ["game-genre/platformer"]
  }]
}
```

## Field yang didukung dan batasannya

`name`: 1–100 huruf kecil, angka, atau tanda hubung, diawali dengan huruf atau angka. `displayName`: judul yang tidak kosong. `subtitle`: maksimal 120 karakter. `description`: maksimal 3,000 karakter Markdown, tanpa heading H1, media yang disematkan, atau tabel. `inspirationPrompt`: maksimal 400 karakter teks biasa dalam satu baris. Batas teks dihitung dalam unit kode UTF-16 JavaScript.

Field opsional meliputi `controls`, `releaseNotes`, `makingOf`, `emoji`, `color`, `sourceRepository`, `license`, `tags`, `sourceLocale`, `listingLocalizations`, `listingMedia`, dan `server`. Tag menggunakan referensi `group-slug/tag-slug` yang sudah ada, dengan maksimal 20 tag unik. `server` mencantumkan room Colyseus dari `server.js` yang diunggah, misalnya `"server": { "rooms": ["game"] }`; lihat [SDK server](https://www.playdrop.ai/id/docs/server-sdk). Sebelum publikasi, tanyakan kepada konektor nilai lisensi yang saat ini diterima dan aturan field selengkapnya.

## Gambar dan video listingan

Unggah media listingan sebagai file di samping `index.html`, dengan nama sesuai path: `listing/icon.png`, `listing/hero-landscape.png` (16:9), dan `listing/hero-portrait.png` (9:16) dengan judul game di dalam artwork-nya, screenshot seperti `listing/screenshots/landscape/0.png`, serta video `listing/videos/landscape/0.mp4` (trailer) dan `listing/videos/portrait/0.mp4` (teaser untuk ponsel). Video diputar tanpa suara di kartu game dan halaman game (trailer di komputer dan TV, teaser di ponsel), sehingga video adalah cara tercepat untuk menunjukkan gameplay dan mendapatkan permainan pertama. Gambar berformat PNG dan video berformat MP4.

## Terjemahkan listingan secara akurat

Selalu publikasikan dalam bahasa Inggris ditambah bahasa Anda sendiri jika berbeda. Atur `sourceLocale` ke bahasa asli. `listingLocalizations` mendukung bahasa Inggris, Prancis, Jerman, Spanyol, Portugis Brasil, Indonesia, Jepang, Korea, Tionghoa Tradisional, dan Tionghoa Sederhana. Setiap terjemahan memerlukan `locale` dan `displayName`; saat Anda mengunggahnya bersama sumbernya, PlayDrop mengisi `sourceHash`. Unggah artwork terjemahan di bawah `listing/locales/<locale>/`, misalnya `listing/locales/fr/hero-landscape.png` dengan judul dalam bahasa Prancis; artwork tersebut dicocokkan dengan terjemahannya secara otomatis. Perbarui terjemahan setelah sumber berubah. Terjemahan listingan tidak menerjemahkan game itu sendiri.