> For the complete documentation index, see [llms.txt](/llms.txt)

# ランキング

全プレイヤーを対象としたランキングです。開催期間をスケジュールで指定し、順位に応じた報酬を配れます。




**このデモについて**

デモは匿名アカウントで自動的にログインします。このアカウントはショールームのすべてのデモで共有されるため、あるデモで手に入れたアイテムや通貨が別のデモにも反映されます。読み込みには少し時間がかかります。画面が小さい場合は新しいタブで開いてお試しください。

## 概要

すべての訪問者が共有するランキングのデモです。**Score contest** で 3 分間のコンテストを開始してスコアを登録し、コンテスト終了後に順位に応じた報酬コインを受け取ります。参加期間は訪問者ごとに GS2-Schedule のトリガーで開き、スコアと報酬は GS2-Ranking2 のグローバルランキングが管理します。

## 試し方

1. **Start contest** を押すと、自分のコンテストが 3 分間開きます。**Status** が **Open: play while the time lasts** になり、**Ends** に残り時間が表示されます。
1. **Play** を押すと 1〜1000 のスコアがランダムに出ます。自己ベストを更新したときだけ登録され、**You** に順位とベストスコアが表示されます。
1. 下の順位表に、ほかの訪問者のスコアと並んで自分の行（**You**）が表示されます。ほかの訪問者の新しいスコアは反映まで数分かかることがあります。
1. **Finish contest** を押す（または 3 分待つ）とコンテストが終了し、**Status** が **Over: your reward is ready to receive** になります。
1. **Receive** を押すと順位に応じた報酬（1 位 300、2〜3 位 150、4〜10 位 80、それ以外の参加者 30 コイン）が **Where the coins land** の **Free balance** に入ります。

ランキングのシーズンは 1 つだけなので、報酬を受け取れるのは 1 アカウントにつき 1 回です。別のブラウザやプライベートウィンドウで開くと、別の匿名アカウントとして同じ順位表に参加できます。

## 使用している GS2 のサービス

- [GS2-Ranking2](/ja/microservices/ranking2/): GS2-Ranking2 のグローバルランキング（スコアが高いほど上位、1〜1000）が全訪問者のスコアを 1 つの順位表にまとめ、コンテスト終了後に順位帯ごとの報酬を付与します。
- [GS2-Schedule](/ja/microservices/schedule/): GS2-Schedule の相対イベントがランキングの参加期間で、**Start contest** で引かれるトリガーにより訪問者ごとに 3 分間だけ開きます。
- [GS2-Exchange](/ja/microservices/exchange/): **Start contest** と **Finish contest** は、GS2-Exchange の無料の交換レートとして、トリガーを引く／解除するトランザクションを実行します。
- [GS2-Money2](/ja/microservices/money2/): 順位報酬のコインは GS2-Money2 のウォレットに無償通貨として入金されます。

## GS2 Studio で使う

GS2 Studio のシンプルモードで **機能を追加** を開き、**ランキング** の **追加** を押すと、この機能を自分のプロジェクトに取り込めます。パッケージを直接指定する場合は **GitHub から追加** を選び、次のパッケージを指定します。

```text
https://github.com/gs2io/gs2-studio-package/tree/main/micro-liveops-ranking/packages/micro-liveops-ranking
```

- オーナー: `gs2io`
- リポジトリ: `gs2-studio-package`
- サブディレクトリ: `micro-liveops-ranking/packages/micro-liveops-ranking`

## ソースコード

- デモのプロジェクト: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-liveops-ranking/live-demo>
- 機能パッケージ: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-liveops-ranking>



