Leaderboard

Skor berperingkat dengan reset otomatis, arsip periode sebelumnya, dan anti-cheat di sisi server.

Komentar kode dan nama API tetap dalam bahasa Inggris agar sesuai dengan SDK.

Di halaman ini

Buat leaderboard
Kirim skor
Membaca peringkat
Reset dan periode sebelumnya
Anti-cheat
Kirim dari server Anda

Buat leaderboard#

Buat leaderboard di halaman Leaderboard project Anda dan pakai slug-nya di kode.

Pengaturan	Pilihan
Slug	Pengenal huruf kecil yang dipakai di kode, mis. `coins`.
Urutan peringkat	`DESC` (tertinggi dulu) atau `ASC` (terendah dulu, mis. catatan waktu balapan).
Mode skor	`BEST` menyimpan skor terbaik setiap pemain; `LATEST` selalu menggantinya.
Reset	`NONE`, `DAILY`, `WEEKLY`, atau `MONTHLY`.
Skor minimum / maksimum	Skor minimum dan maksimum yang diterima (opsional).
Jeda kirim skor	Jarak minimum dalam detik antara dua pengiriman oleh satu pemain (opsional).

Kirim skor#

Nama pemain diambil dari akun, sehingga klien tidak bisa mengirim skor atas nama orang lain.

var submit = await Majacloud.Leaderboards.SubmitScoreAsync("coins", 340);
if (submit.Ok && submit.Value.Accepted)
    Debug.Log("New rank #" + submit.Value.Entry.Rank);

GDScript

var submit := await Majacloud.leaderboards.submit_score("coins", 340)
if submit.ok and submit.value.accepted:
	print("New rank #", submit.value.entry.rank)

JavaScript

const submit = await mc.leaderboards.submitScore('coins', 340);
if (submit.ok && submit.value.accepted) console.log('New rank #' + submit.value.entry.rank);

curl

curl -X POST https://majacloud.majanite.com/v1/leaderboards/coins/scores -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"score": 340}'

Membaca peringkat#

Entri teratas bisa dibaca tanpa login; peringkat pemain sendiri dan entri di sekitarnya butuh pemain yang sudah login.

var top = await Majacloud.Leaderboards.GetTopAsync("coins", limit: 10);
var me = await Majacloud.Leaderboards.GetMyRankAsync("coins");
var around = await Majacloud.Leaderboards.GetAroundMeAsync("coins", radius: 3);

if (me.Ok && me.Value.Entry != null) Debug.Log("You are #" + me.Value.Entry.Rank + " of " + me.Value.Total);

GDScript

var top := await Majacloud.leaderboards.get_top("coins", 10)
var me := await Majacloud.leaderboards.get_my_rank("coins")
var around := await Majacloud.leaderboards.get_around_me("coins", 3)

if me.ok and me.value.entry != null:
	print("You are #%d of %d" % [me.value.entry.rank, me.value.total])

JavaScript

const top = await mc.leaderboards.getTop('coins', { limit: 10 });
const me = await mc.leaderboards.getMyRank('coins');
const around = await mc.leaderboards.getAroundMe('coins', { radius: 3 });

if (me.ok && me.value.entry) console.log(`You are #${me.value.entry.rank} of ${me.value.total}`);

curl

curl "https://majacloud.majanite.com/v1/leaderboards/coins/entries?limit=10" -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY"
curl https://majacloud.majanite.com/v1/leaderboards/coins/me -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN"
curl "https://majacloud.majanite.com/v1/leaderboards/coins/around-me?radius=3" -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN"

Reset dan periode sebelumnya#

Leaderboard harian, mingguan (Senin), dan bulanan direset pukul 00:00 UTC. Periode yang selesai diarsipkan; baca dengan periode previous:

var yesterday = await Majacloud.Leaderboards.GetTopAsync("coins", 10, 0, MajacloudLeaderboardPeriod.Previous);

GDScript

var yesterday := await Majacloud.leaderboards.get_top("coins", 10, 0, "previous")

JavaScript

const yesterday = await mc.leaderboards.getTop('coins', { limit: 10, period: 'previous' });

curl

curl "https://majacloud.majanite.com/v1/leaderboards/coins/entries?period=previous" -H "X-Project-ID: $PROJECT_ID" -H "X-Client-Key: $CLIENT_KEY"

Berapa banyak periode lalu yang disimpan, dan berapa entri yang dikembalikan leaderboard, bergantung pada paket (lihat Batas).

Anti-cheat#

Skor di luar batas minimum atau maksimum ditolak dengan validation.
Mengirim lebih cepat dari jeda yang diatur menghasilkan rate_limited.
Klien hanya bisa mengirim skor untuk pemain yang sedang login.
Untuk game kompetitif, biarkan server Anda yang menentukan skor dan mengirimnya dengan secret key.

Kirim dari server Anda#

Dengan secret key, kirim player_id dan skornya. Pemain tersebut harus sudah ada.

JavaScript

// Node.js with secretKey: submit after your server validated the match
await admin.server.submitScore('coins', 'player_3f9c…', 980);

curl

curl -X POST https://majacloud.majanite.com/v1/leaderboards/coins/scores \
  -H "X-Project-ID: $PROJECT_ID" -H "X-Secret-Key: $SECRET_KEY" \
  -H "Content-Type: application/json" -d '{"player_id": "player_3f9c…", "score": 980}'