ゲーム内クエスト：デイリータスクと報酬

プレイヤーに見えるもの

• タブになったサイクル：デイリー、ウィークリー、実績。次のサイクルまでのタイマー付き。
• タスクごとの進行バーと、すべての目標が見られる詳細のポップアップ。
• 終わったタスク用の**「すべて受け取る」ボタン**。
• ポイントがたまると宝箱が開くポイントトラック。
• 終わったタスクが待っているときのタブのバッジ。

クエストの構造

• サイクル：スケジュールのあるタスクのまとまり。デイリー、ウィークリー、常設、期間限定イベント。サイクルは段階を 順に進めることもできます。たとえば8週間のシーズンで、週ごとに専用のタスクとポイントトラックがある形です。
• クエスト：それぞれカウンターを持つ1つ以上の目標（「モンスターを20体倒す」）と報酬。先に別のクエストの完了を 条件にでき、連続クエストはこうして作ります。

報酬は3種類あり、すべて同時に働きます。

1. クエストの報酬：すべての目標を達成したとき。
2. ポイントトラックの宝箱：受け取ったクエストがサイクルのポイントを増やし、必要な合計で宝箱が開きます。
3. グループのボーナス：1つのグループのクエストを決まった数だけ終えたとき。

進行はどこから来るか

開発者向け

クエストは @idosgames/core の client.quest で動きます。進行はクエストごとではなくカウンター名で送ります。 サーバーがそのカウンターを待っているすべての進行中のタスクに渡します。

// 起きた場所で：モンスターを倒した
await client.quest.addQuestProgress('monsters_defeated', 1)

// クエスト画面：プレイヤーの進行。サイクルは自動で進みます
const state = await client.quest.getUserQuestState()

// 終わったクエストの報酬を受け取る
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)

• addQuestProgress が進めるのは、出どころがゲームの目標だけです。サーバーが自分で数える目標は拒否されます。
• 「念のため」に値を送らないでください。目標に1回あたりの上限があると、超えた時点でプレイヤーのアカウントが停止されます。
• 付与された報酬は SDK のキャッシュの残高にすでに反映されているので、読み込み直す必要はありません。

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