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

# Rankings

A global leaderboard with a scheduled entry period and rewards handed out by rank.




**이 데모에 대하여**

데모는 익명 계정으로 자동 로그인합니다. 이 계정은 쇼룸의 모든 데모에서 공유되므로 한 데모에서 얻은 아이템이나 재화가 다른 데모에도 반영됩니다. 로딩에 약간 시간이 걸립니다. 화면이 작다면 새 탭에서 열어 사용해 보세요.

## 개요

A leaderboard shared by every visitor. Start a three-minute contest under **Score contest**, post scores, and once your contest is over, receive coins by the rank you finished at. Each visitor's entry window is opened by a GS2-Schedule trigger, and the scores and rewards are a GS2-Ranking2 global ranking.

## 체험 방법

1. Press **Start contest** to open your own contest for three minutes; **Status** turns to **Open: play while the time lasts** and **Ends** counts down the time left.
1. Press **Play** to score a random 1 to 1000. Only a new personal best is posted, and **You** shows your rank and best score.
1. The board below lists other visitors' scores with your own row (**You**) among them; other visitors' new scores can take a few minutes to appear.
1. Press **Finish contest** (or wait three minutes) to close the contest; **Status** turns to **Over: your reward is ready to receive**.
1. Press **Receive**; the reward for your rank (1st 300, 2nd-3rd 150, 4th-10th 80, anyone else who played 30 coins) lands in **Free balance** under **Where the coins land**.

The ranking has a single season, so each account can receive a reward once. Open the demo in another browser or a private window to join the same board as a second anonymous account.

## 사용하는 GS2 서비스

- [GS2-Ranking2](/ko/microservices/ranking2/): A GS2-Ranking2 global ranking (higher is better, 1 to 1000) puts every visitor's score on one board and pays the reward for each rank band once the contest is over.
- [GS2-Schedule](/ko/microservices/schedule/): A GS2-Schedule relative event is the ranking's entry period; the trigger pulled by **Start contest** opens it for three minutes per visitor.
- [GS2-Exchange](/ko/microservices/exchange/): **Start contest** and **Finish contest** are free GS2-Exchange rates whose transactions pull and clear the trigger.
- [GS2-Money2](/ko/microservices/money2/): The rank reward coins are deposited into the GS2-Money2 wallet as free currency.

## GS2 Studio에서 사용하기

GS2 Studio의 Simple 모드에서 **Add features** 를 열고 **Rankings** 의 **Add** 를 누르면 이 기능을 자신의 프로젝트에 가져올 수 있습니다. 패키지를 직접 지정하려면 **Add from GitHub** 를 선택하고 아래 패키지를 입력합니다.

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

- Owner: `gs2io`
- Repository: `gs2-studio-package`
- Subdirectory: `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>