SuperAPI AI 工具集

remix-add-sprite

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能引导你为 Remix 平台上基于 canvas 的游戏生成精灵图,并将生成结果集成进游戏代码,实现角色或元素动画。

前提条件:游戏 HTML 文件需已存在;需在 Remix 平台创建游戏并取得 game ID;需设置 REMIX_API_KEY 环境变量。

使用方式:

  1. 获取已有 game ID。优先使用任务上下文或先前工具结果中的 gameId,否则读取最近的 .remix-cli.json(旧项目可能为 .remix-mcp.json),若其中有 gameId 则复用;均无时才按 upload-game 流程创建。
  2. 生成精灵图。优先使用 MCP 的 generateSpriteSheet,参数包含 gameId、prompt、gridSize;返回 hosted spriteUrl、transparentSpriteUrl、网格元数据及警告。若改用 REST 调用,需先从 OpenAPI 规格确认准确 schema。
  3. 集成到游戏。用返回的 URL 配合 canvas drawImage 逐帧渲染,示例中通过 sprite.src 设置图片地址,并按 frameWidth、frameHeight、totalFrames 与 currentFrame 计算源坐标;在 sprite.onload 后启动动画循环。需要覆盖背景时使用 transparentSpriteUrl。

提示:在 prompt 中明确帧数与动作(如“4-frame walk cycle”优于“walking character”),并指定画风(如 pixel-art、hand-drawn、flat vector)。帧布局需依据返回的网格元数据计算,不要假设为单行水平排列。游戏循环开始前先等待 onload 完成预加载。

限制:需已有游戏文件与 game ID 及 API Key;文档未提供具体价格、平台支持范围或 API 速率等额外信息,暂未提供。