ゲーム内ランキング：順位、ラウンド、報酬

プレイヤーに見えるもの

• タブになったボード：それぞれにプレイヤーのスコア、順位、ラウンド終了までのカウントダウンを示すカードがあります。
• 上位のプレイヤー。プレイヤー自身は強調表示され、上位3人にはメダル。
• ポップアップの順位の報酬とポイントの報酬。ポイントの報酬はその場で受け取れます。
• 前のラウンドの報酬のポップアップ：ラウンドが終わると「受け取る」ボタン付きで自動表示されます。
• ゲームにポイントを稼ぐモードがあれば、カードに**「プレイ」ボタン**。
• 報酬が待っているときのタブのバッジ。

ボードの構造

• ラウンド。 ボードはサイクルで繰り返す（たとえば毎週）、スケジュールで動く、またはラウンドの連なりとして進みます。
• スコアの数え方。 すべての結果の合計、ベストの結果、ベストタイム、最後の値。
• 順位の報酬：ラウンド終了時の順位の範囲ごと。1位、2〜3位、4〜10位など。
• ポイントの報酬：ラウンド中のマイルストーン。「今週1000ポイント稼ぐ」。

ポイントはどこから来るか

ポイントはボードに設定した出どころから来ます。

• ゲームからの結果（ClientScore）。ゲームが数値を送ります。たとえばランのスコア。⚠ 出どころには上限を設定して ください。1回あたりの上限、1日の上限、送信の間隔。この出どころがなければ、ボードはゲームからの数値をまったく受け取りません。
• サーバーが自分で数えるイベント。たとえば購入や終えたクエスト。これはゲームからごまかせません。

開発者向け

ランキングは @idosgames/core の client.leaderboard で動きます。

// 結果を送る：サーバーが数え方のルールと上限を適用します
const sub = await client.leaderboard.submitScore('weekly_score', 150)
if (!sub.ok) return showError(sub.error)
sub.data.NewScore // 数えたあとのスコア

// 複数ボードの画面：上位の一覧とプレイヤーの進み具合を1回のリクエストで
const overview = await client.leaderboard.getOverviewBatch(['weekly_score', 'season_pvp'])

// 待っているものをすべて受け取る：順位の報酬とポイントの報酬
await client.leaderboard.claimAllRewardsBatch(['weekly_score', 'season_pvp'])

• 0 以下のスコアは、SDK がリクエストを送らずに自分で拒否します。
• 新しいスコアは応答の NewScore から取ります。「ベストの結果」では、悪い結果はスコアを変えません。
• フレンドの順位は getFriendsLeaderboard(leaderboardID) です。

すべてのフィールドは、SDK の MCP サーバーが配るスキル leaderboard-system に説明があります。