用途:为 Remix 平台上的游戏管理商店道具,包括创建、更新、删除,以及在游戏代码中接入购买与发放逻辑。
前置条件:游戏必须已存在。优先从任务上下文获取 gameId,其次读取 .remix-cli.json,再读旧的 .remix-mcp.json;都不可用时才走上传游戏流程创建。尽量使用官方 CLI 或 MCP 工具链,而非手写 HTTP。
管理接口:创建道具用 POST https://api.remix.gg/v1/games/{gameId}/items,需 Authorization: Bearer $REMIX_API_KEY 与 Content-Type: application/json。字段含 name、slug、itemType、bitsCost、description、iconUrl;itemType 为 CONSUMABLE、ONE_TIME 或 TIER_UNLOCK,CONSUMABLE 与 ONE_TIME 必填 bitsCost,TIER_UNLOCK 必填 tier;新建道具状态为 PENDING。更新用 POST .../items/{itemId},可只传要改的字段;删除用 DELETE .../items/{itemId}。列表需先执行,以便复用 itemId、避免 slug 重复并查看状态。
代码接入:通过 window.RemixSDK,先 await sdk.ready()。可用 sdk.purchase({ item: 'slug' }) 购买,务必同时监听 sdk.onPurchaseComplete(...) 后再发放物品;用 hasItem()、getItemPurchaseCount()、inventory、shopItems 判断持有,用 sdk.getShopItem(slug) 或 sdk.shopItems 读取当前价格与图标,仅把使用计数写入 gameState。
限制与注意:不要用 singlePlayer.actions.purchase(...)、localStorage 记录购买,也不要在游戏状态里硬编码价格或道具元数据。MCP 下 createShopItem 在省略 iconUrl 时可为 CONSUMABLE 或 ONE_TIME 自动生成图标。具体计费与平台政策暂未提供。