ゲームの VIP とプレミアムパス

プレイヤーに見えるもの

• 低いランクから順にすべてのパス：名前、特典、期間。
• パスごとに1回の無料体験。使えるときはタブにバッジ。
• 有効なパスのタイマーと「延長」。
• 通貨やアイテムで購入。現金のパスはプラットフォームの決済で販売します。

仕組み

• パスにはランクがあります。複数持っているときは高いランクが優先されます。
• 特典はサーバーが適用します。ストアの割引とボーナス、イベントのマイルストーンとシーズンのティアでの2つ目の賞品。
• イベントとシーズンは、該当するパスに印を付けた VIP 画面へプレイヤーを案内します。

開発者向け

VIP は @idosgames/core の client.premium で動きます。割引とボーナスにコードは不要です。サーバーがすべての購入と受け取りに適用します。

// タイトルのパス（設定）とプレイヤーの VIP の状態
const defs = await client.premium.getDefinitions()
await client.premium.getUserState()
const vip = client.data.user.state?.Premium
vip?.MaxActiveTier // 有効な最上位のランク、VIP なしなら 0
vip?.Subscriptions?.['vip_gold']?.ExpirationDate // キーだけでなく日付を確認します

• 使った体験は使ったままです。体験の一覧は ActivatedTrialIDs にあるので、もう一度勧めないでください。
• 実際に引かれたものと付与されたものは、基本価格ではなく購入の応答にあります。

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