游戏中的 VIP 和会员通行证

玩家看到什么

• 所有通行证，从最低等级开始：名称、福利和时长。
• 每种通行证一次的免费试用，可用时标签页上有徽标。
• 生效中通行证的计时和“续期”。
• 用货币或物品购买；用真实货币购买的通行证通过平台结账页面出售。

如何运作

• 通行证有等级：玩家同时持有多个时，以更高等级为准。
• 福利由服务器应用：商店中的折扣和加成，活动里程碑和赛季等级上的第二份奖品。
• 活动和赛季会把玩家带到 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 中，不要再次提供。
• 实际扣除和发放的内容在购买响应里，而不是在基础价格中。

每个字段都在技能 premium-system 中有说明，由 SDK 的 MCP 服务器提供。