Publikasi

Sebuah game sampai ke Ralyoo sebagai bundel yang diunggah ke registry. Registry memvalidasinya, menyimpannya di alamat berversi yang tidak pernah berubah, dan memasukkannya ke katalog. Web Ralyoo tidak perlu dibangun ulang.

Saat ini yang mengunggah adalah tim Ralyoo. Kirim berkas .ralyoo kamu ke tim, atau unggah sendiri kalau kamu punya token registry.

1. Lengkapi manifest

ralyoo.json adalah yang tampil di katalog:

{
  "$schema": "https://docs.ralyoo.com/schema/ralyoo.json",
  "id": "kejar-bintang",
  "version": "0.1.0",
  "sdk": ">=1.1 <2",
  "title": { "id": "Kejar Bintang" },
  "description": { "id": "Kejar bintang pakai joystick. Yang duluan dapat lima, menang." },
  "controls": { "id": "Joystick" },
  "author": { "name": "Nama kamu" },
  "players": { "min": 2, "max": 4 },
  "pillars": ["konsol"],
  "locales": ["id"],
  "media": { "icon": "meta/icon.svg", "cover": "meta/cover.webp", "color": "#7FD8FF" }
}

• id permanen. Ia bagian dari alamat bundel dan kunci simpanan; tidak bisa diganti setelah unggahan pertama.
• title paling panjang 22 karakter (satu baris di lobi), description 100 (dua baris).
• media: lihat Aset. Ganti ikon dan cover bawaan template.
• sdk: rentang versi SDK yang dibutuhkan game. ">=1.1 <2" berarti "1.1 atau lebih baru, sebelum 2".

Setiap field ada di Referensi manifest.

2. Bungkus

npm test
npm run pack

pack menulis kejar-bintang-0.1.0.ralyoo. Kalau ada error, tidak ada yang ditulis dan alasannya dicetak.

3. Unggah

export RALYOO_REGISTRY_TOKEN=…
npx ralystudioo publish --to https://staging.ralyoo.com

Registry memeriksa ulang semuanya di sisi server. Jawabannya:

Coba dulu di staging, mainkan sekali dari awal sampai layar hasil dengan HP sungguhan, baru minta dirilis ke produksi.

Memperbarui game

Versi yang sudah terbit tidak bisa diubah. Itu yang membuat bundel boleh di-cache selamanya dan sesi yang sedang berjalan tidak pernah berubah di tengah main.

Untuk merilis perubahan:

1. Naikkan version di ralyoo.json (dan package.json).
2. npm run pack, lalu publish.

Katalog berpindah ke versi terbaru. Alamat versi lama tetap hidup.

Penomoran mengikuti semver: perbaikan 0.1.0 → 0.1.1, fitur 0.1.0 → 0.2.0. Simpanan (ctx.storage) terikat ke id, bukan ke versi, jadi bertahan antar versi: baca data lama dengan hati-hati.

Menarik versi

Kalau sebuah versi ternyata rusak, tim Ralyoo bisa menariknya; katalog kembali ke versi sebelumnya.

Daftar periksa

• npm test lulus, host.errors kosong.
• ralystudioo lint tanpa error; peringatan sudah dibaca.
• Dimainkan dengan 2 dan 4 pemain, termasuk satu pemain putus lalu kembali.
• Dicoba dengan Reduced motion dan dengan Latency 150 ms.
• Dicoba di HP sungguhan, tegak dan miring sesuai orientation.
• Teks di layar host minimal 28 px pada 1080p.
• fps stabil di laptop tanpa GPU khusus; tidak ada lonjakan frame di HUD.
• Ikon dan cover milik sendiri; judul dan deskripsi pas di lobi.
• Lisensi aset pihak ketiga dicatat di LICENSES.md di folder game.