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

# Quests

Manages quests players take on, their progress and their clear rewards.




**이 데모에 대하여**

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

## 개요

Pick one of three quests (**Forest patrol**, **Cave expedition**, **Dragon hunt**), start it, and clear it for a reward. Starting a quest spends stamina, and clearing it pays free coins, with a bonus on top the first time only. Only one quest can be in progress at a time.

## 체험 방법

1. Check each quest's cost and reward under **Pick a quest (one at a time)**. **Forest patrol**, for example, costs 10 stamina and pays 10 coins, plus 100 more on the first clear.
1. Press **Start** on a quest. Stamina in **Your stamina** drops by the quest's cost, and the running quest appears under **Running**, as in `Running: Forest patrol (10 stamina spent)`.
1. While a quest is running, pressing **Start** on another quest is refused by GS2.
1. Press **Complete** under **Your quest in progress**. The clear reward and the first-clear bonus are paid into **Free balance** under **Where the coins land**, and the quest is marked **Cleared**.
1. Start and clear the same quest again: this time only the clear reward is paid, with no first-clear bonus. If you run short of stamina, **Recover** restores 5.

Stamina tops out at 50 and recovers 5 every minute on its own. **Dragon hunt** costs 30 stamina.

## 사용하는 GS2 서비스

- [GS2-Quest](/ko/microservices/quest/): The GS2-Quest group `main` defines the three quests with their start cost in stamina, clear reward and first-clear reward. **Start** and **Complete** are GS2-Quest's own client calls; it keeps one progress per player and records which quests have been cleared.
- [GS2-Stamina](/ko/microservices/stamina/): GS2-Stamina holds the stamina meter (50 at most, recovering 5 every minute); starting a quest deducts its cost through `Gs2Stamina:ConsumeStaminaByUserId`.
- [GS2-Money2](/ko/microservices/money2/): A GS2-Money2 wallet receives the reward coins; clear and first-clear rewards are paid in as free coins through `Gs2Money2:DepositByUserId`.
- [GS2-Exchange](/ko/microservices/exchange/): A GS2-Exchange rate model defines **Recover**, a transaction that restores 5 stamina.

## GS2 Studio에서 사용하기

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

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

- Owner: `gs2io`
- Repository: `gs2-studio-package`
- Subdirectory: `micro-economy-quest/packages/micro-economy-quest`

## 소스 코드

- 데모 프로젝트: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-economy-quest/live-demo>
- 기능 패키지: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-economy-quest>