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

# ミッション

日次・週次・月次・リセットなしのミッションと、その達成条件・報酬を管理します。




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

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

## 概要

GS2-Mission のカウンターとミッションを分けて扱うデモです。1 つのカウンターを 4 つのミッションが見ており、1 回の操作で 4 つすべてが進み、目標値の違いで別々に達成されます。カウンターは今日・今週・今月・累計の 4 つの期間を同時に数え、ミッションのグループはリセットなし（career）と毎日リセット（daily）で受け取り直せるタイミングが異なります。

## 試し方

1. **One counter, four windows** の **Advance** を押すと、カウンターが 1 増え、**Today value**、**Weekly value**、**Monthly value**、**Total value** の 4 つがそろって増えます。
1. 1 回目で **Career missions: receive once** の career1（**Wants 1 on the counter. Pays 10 coins.**）が達成され、**Receive** ボタンが現れます。押すと **Where the coins land** の **Free balance** が 10 増え、**Received 10 coins.** と表示されます。
1. **Advance** をもう 1 回押して 2 にすると、**Daily mission: receive again tomorrow** の daily2 が達成され、**Receive** で 20 コインを受け取れます。
1. さらに 3 回目で career3（30 コイン）、5 回目で career5（50 コイン）が達成され、それぞれ **Receive** で受け取れます。目標に届いていないミッションには受け取りボタンが出ません。
1. daily グループは毎日 0 時（UTC）にリセットされ、翌日にまた受け取れます。career グループはリセットされないため、一度受け取ったら受け取り済みのままです。

カウンターを戻したり career の受け取りを取り消したりする操作はありません。アカウントは同じブラウザのショールーム全デモで共通なので、やり直したいときはプライベートウィンドウなど別のブラウザで開くと新しい匿名アカウントで始められます。

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

- [GS2-Mission](/ja/microservices/mission/): GS2-Mission が、日次・週次・月次・リセットなしの 4 スコープを持つカウンター counter と、それを見るミッション（career1・career3・career5・daily2）を 2 つのグループに分けて定義し、達成と報酬の受け取りを管理します。
- [GS2-Exchange](/ja/microservices/exchange/): GS2-Exchange の無料の交換レートが、カウンターを 1 増やす操作（IncreaseCounterByUserId）を定義し、**Advance** から実行されます。
- [GS2-Money2](/ja/microservices/money2/): ミッション報酬は GS2-Money2 のウォレット（スロット 0）へ無償通貨として入金され、**Free balance** に表示されます。

## GS2 Studio で使う

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

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

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

## ソースコード

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



