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