チームイベント：みんなで建てて共通の賞品を

プレイヤーに見えるもの

• タイマーとチームの賞品付きの開催中のチームイベント。
• 「チームに参加」：仲間はサーバーが組みます。
• メンバーそれぞれの建物とその進み具合。
• 1回か5回まとめて、無料か通貨での**「回す」**、建物の報酬、チームからの脱退。

仕組み

• チームはサーバー上の1つの共有ドキュメントにあり、画面は操作のたびに読み直します。
• 回すたびにプレイヤー自身の建物が進み、完成すると建物の報酬が出ます。
• チームのすべての建物が完成すると、チームの賞品が支払われます。

開発者向け

チームイベントは @idosgames/core の client.coopEvent で動きます。

// チームに参加し（仲間はサーバーが組みます）、回して自分の建物を建てる
const group = await client.coopEvent.joinOrCreateGroup('castle_build')
if (!group.ok) return showError(group.error)
await client.coopEvent.spin('castle_build', group.data.Group?.GroupID ?? '', 5)

• 仲間が何か操作すると状態が変わります。getGroupState でチームを読み直します。
• 賞品は claimObjectReward と claimGrandPrize で受け取ります。

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