SuperAPI AI 工具集

arcadifying-mini-games

编程与开发

查看项目

更新于 10-15 10:16

技能介绍

用途

该技能用于在已有的实时核心循环之上,补充时间结构、仪式画面、分数经济、名次记录与吸引(attract)行为,把一个可玩的迷你游戏改造成完整的街机游戏。它只实现缺失的层次,不在此工作流下重新设计核心机制。

入口条件

需要确认存在可玩的循环,且已知其未损坏、不无聊。有现成的运行时、游玩或遥测证据时可直接使用。缺少先前证据时,不需要遍历所有游戏验证技能,只需在包装循环前运行所需的最小检查,并报告剩余的不确定性。

工作流程

  1. 盘点缺失的街机层:检查回合/波次、过关条件、READY/过关/死亡/游戏结束仪式、续命经济、首字母与持久排名、吸引模式、进度 HUD、分离的 jingle 与 SE。保留可用的层,只实现缺口。

  2. 先定义回合数据再写代码:创建数据表而非分支回合逻辑。用现有部件的参数组合塑造回合个性,在困难段之后安排刻意的喘息,在稳定的世界内事件中选择明确的配额,而不是用倍率膨胀分数。设置回合数、圈数缩放、配额或时间奖励前,先阅读 arcade-system-details.md。

  3. 安装单一阶段状态机:使用一个阶段变量作为唯一事实来源,阶段流转为 ready → play → clear → ready,以及 play → death → play,death → entry → table → game-over/title 路径。需保持的不变量包括:每个更新段和输入处理器都检查当前阶段;转换后在后续同帧生成器、碰撞或计分运行前重新检查阶段;链式确认驱动阶段使用短暂宽限期,避免一次刚按下的边沿跳过多个画面;READY、过关和死亡冻结会停止输入、生成、碰撞、移动、计时器和冷却变更,绘制与仪式调度可继续;停止更新循环的引擎调用只在自定义 entry/table 阶段和已调度的 jingle 工作完成后发生;回合边界在过关时以及下一回合开始时移除所有危险及其在途效果(爆炸、冲击波、排队射击);累积型失败条件(丢失单位、未命中目标、填充计量表)在玩家死亡或重生期间不推进,且未命中瞬间已超出玩家触及范围的状态计入该次未命中而非下一次;最终过关不设置下一回合状态:无重生无敌、无 READY、无待生成。

  4. 添加连贯的分数经济:把续命、过关奖励、名字输入、前五名持久化、默认排名、并列行为和非合格分数行为定义为一个系统。实现前阅读 arcad-system-details.md,其中包含阈值、输入 UI 模型、读取时合并的持久化和依赖回放的合格规则。

  5. 分离仪式音频:将回合开始、过关、续命和游戏结束映射到 jingle;将瞬时动作映射到一次性 SE。引擎没有 jingle API 时,在更新循环仍活跃时处理按帧索引的音符队列。仅当游戏需要完整事件套件设计时才使用 designing-retro-arcade-sound-kits,而不是仅为满足此链接。

  6. 构建吸引模式:优先使用现有的确定性回放设施,前提是它记录了游戏所需的控制。否则通过策略接口驱动真实游戏,发出与人类输入相同的控制记录。阅读 arcade-system-details.md 了解回放防护、键盘限制、脚本自动驾驶以及用于公平性测量的可选朴素策略。吸引模式不得写入排名、不得在输入画面无限停滞,也不得因可变/非确定性阶段决策而偏离。

验证

将检查范围限定在改动的层,但完整包装改变时验证集成循环。注入或安排状态以测试配额 → 过关 → 下一回合、续命跨越、输入保存/跳过、排名并列以及任何改变规则的回合。强制仪式重合:过关奖励本身获得的续命、过关帧上的未命中、死亡序列期间的续命。每个横幅、计数器变化和 jingle 必须保持可见或可听;一个覆盖另一个是常见缺陷。在过关瞬间于下一回合生成点放置活动危险和在途效果,确认玩家在下一回合最初几秒存活。观察整个死亡序列中的生命显示:每次变化都与该帧的授予或丢失事件匹配,不得在没有续命时上升,序列期间获得的续命必须显示。捕获每个改动的仪式画面;值断言无法捕捉裁剪文本、跳过画面或出框光标。当承诺多个绑定时,通过至少两个配置的同义词键测试每个命名 UI 动作。运行标题 → 吸引 → 游玩 → 游戏结束 → 输入/表格 → 标题两次,以捕捉重入和持久化缺陷。接线浏览器或引擎入口流后,运行项目的运行时冒烟检查。保持阶段、回合号和计算出的回合参数可通过项目现有调试/测试边界访问,不要比验证所需更广泛地暴露生产内部。

输出

产出回合参数表、阶段状态机、分数/续命/输入/排名接线、吸引实现、jingle 映射,以及适用的转换、持久化、画面和运行时检查的证据。

参考路由

arcade-system-details.md — 在实现回合、分数经济、名字输入、持久化或吸引模式前加载相关章节。

probing-web-game-mechanics — 仅当改动的机制难以或不可靠地到达时,用于浏览器状态注入。

smoke-testing-web-games — 在浏览器运行时改动后使用,不用于文档或纯设计工作。