Classements

Des scores classés avec réinitialisations automatiques, archives des périodes passées et anti-triche côté serveur.

Les commentaires du code et les noms d'API restent en anglais pour correspondre aux SDK.

Sur cette page

Créer un classement
Envoyer un score
Lire le classement
Réinitialisations et périodes précédentes
Anti-triche
Envoyer depuis votre serveur

Créer un classement#

Créez des classements sur la page Classements de votre projet et utilisez le slug dans le code.

Paramètre	Options
Slug	Identifiant en minuscules utilisé dans le code, par ex. `coins`.
Ordre de tri	`DESC` (le plus élevé d'abord) ou `ASC` (le plus bas d'abord, par ex. pour des temps de course).
Mode de score	`BEST` conserve le meilleur score de chaque joueur ; `LATEST` le remplace toujours.
Réinitialisation	`NONE`, `DAILY`, `WEEKLY` ou `MONTHLY`.
Score minimum / maximum	Score minimum et maximum acceptés (facultatif).
Délai entre envois	Nombre minimum de secondes entre deux envois d'un même joueur (facultatif).

Envoyer un score#

Le nom du joueur provient du compte : un client ne peut donc pas envoyer de score au nom de quelqu'un d'autre.

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}'

Lire le classement#

Les meilleures entrées ne nécessitent pas de connexion ; le rang du joueur et les entrées autour de lui nécessitent un joueur connecté.

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"

Réinitialisations et périodes précédentes#

Les classements quotidiens, hebdomadaires (le lundi) et mensuels sont réinitialisés à 00:00 UTC. La période terminée est archivée ; lisez-la avec la période 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"

Le nombre de périodes passées conservées et le nombre d'entrées renvoyées par un classement dépendent de l'offre (voir Limites).

Anti-triche#

Les scores en dehors du minimum ou du maximum sont refusés avec validation.
Envoyer plus vite que le délai autorisé renvoie rate_limited.
Les clients ne peuvent envoyer de score que pour le joueur connecté.
Pour les jeux compétitifs, laissez votre serveur déterminer le score et l'envoyer avec la clé secrète.

Envoyer depuis votre serveur#

Avec la clé secrète, envoyez le player_id et le score. Le joueur doit exister.

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}'