用途:该技能用于对 RPGJS Studio 实例执行内容管理任务,包括地图、地图事件、数据库记录、媒体资源以及设置的增删改查,并可发布 MMORPG 项目。适用于 Codex 在制作或管理 2D RPG 游戏时调用。
主要能力:读取公开游戏数据库,按项目批量解析角色与敌人外观并保留媒体链接与显式覆盖;生成角色立绘与动画(spritesheet 的 idle 模式可生成 1024×768 透明四姿态 2×2 图,消耗 5 credits;既有动画请求为 15 credits);媒体生成支持 base64 引用并按 PNG/JPEG/GIF/WebP 签名识别;地图生成支持风格描述、terrain、terrainLayer、terrainMorphologyLayer(洞与墙)等;事件支持 show_cinematic(视频、allowSkip、bgm、preload)、show_text(含输入变量)、call_shop、call_character_select、change_class 等;可发布 MMORPG 并查询发布状态。
使用方式:先检查当前工作目录是否存在 RPGSTUDIO.md,存在则先读取以复用 BASE_URL 等稳定信息;BASE_URL 默认 https://rpgjs.studio,需由用户提供或指定。API key 从环境变量 RPGSTUDIO_API_KEY 读取,缺失时提示用户在 ${BASE_URL}/api-keys 创建并导出。请求头使用 x-api-key 与 Content-Type: application/json,优先使用 curl。按任务读取对应 reference 文件(database、maps、events、blocks、media、settings、project-env、mmorpg 等)。写操作遵循 REST 语义,先解析外键、复用返回的 _id;AI 媒体生成必须先 action: "estimate" 估算并获用户确认后再 execute。地图生成需 prepare、确认、execute 并轮询实例,最终需 finalized: true 与 mapId。
限制:API key 与项目绑定,无需也不应恢复、请求或持久化 projectId;不得打印或记录密钥。认证失败(401/403 或无效 key)须立即停止。媒体生成在 execute 时先行扣费,启动失败会退款;排队响应不代表完成。地形渲染须使用 @rpgjs/render-map2d,不可自行重实现。MMORPG 版本化 R2 发布与仅活跃房间传播已实现,但发布与生产集成仍待完成。其余未提供的细节暂未说明。