需求规格:让每条规则都有可观察结果
把案例描述变成确定规则
本页描述竖屏试炼当前教学基线,参数来源于共享 ARENA_SPEC 和规则函数。它不是推荐给所有游戏的平衡表,也不是微信平台要求。修改规则时,应同时更新规格、相关测试与表现,避免同一份需求在聊天、代码和画面里出现三种含义。构建和真机是否通过,统一查看验证报告。
设计坐标宽五百四十、高九百六十,原点在场地中心,横向向右为正,纵向向上为正。玩家初始位置为横坐标零、纵坐标负一百三十,朝上,生命五点。移动范围限制在横向负二百三十到二百三十、纵向负三百七十到三百二十。输入向量归一化,所以斜向移动不应比轴向更快;无输入时保留上一次朝向。
局级与动作状态各负其责
局级状态是 ready、playing、paused、won、lost。开始或重试会重建初态,进入 playing,开启第一波。只有 playing 推进规则;暂停切换只在 playing 与 paused 之间有效,胜负之后不能靠暂停恢复。生命归零优先进入 lost,同一步即使满足清敌条件,也不再推进胜利。结果状态保持,直到玩家开始新局。
动作状态是 idle、startup、active、recovery。空闲时收到攻击意图才开始一次新攻击,attackId 增加。前摇零点一二秒,有效期零点一秒,后摇零点二二秒,时间按逻辑步裁决,因此视觉边界会落在离散步上。攻击中仍可移动,但速度使用普通移动的百分之四十五;朝向随移动更新,当前案例没有实现攻击方向锁定。
| 规则 | 当前基线 | 观察入口 |
|---|---|---|
| 普通速度 | 每秒 190 世界单位 | 位置与逻辑时间 |
| 攻击范围 | 100 世界单位 | 范围图形与伤害 |
| 玩家生命 | 5 | HP 文本 |
| 敌人生命 | 2 | 敌人颜色与血条 |
| 受伤无敌 | 0.8 秒 | 玩家颜色与模型字段 |
| 波次间隔 | 清空后 0.8 秒 | waveDelay 与 WAVE |
| 波次数量 | 3、4、5 | 有效敌人列表 |
命中规则需要比画面更精确
有效期内,敌人在范围内且朝向点积满足阈值时成为命中候选。代码的点积阈值略小于零,对应略超过前半平面的扇形;不要简单写成“正前方九十度”。同一次攻击对一个敌人只减一点生命,通过敌人的 hitAttack 记录去重;下一次攻击可以再次命中。敌人被击中后沿远离玩家方向移动三十单位,生命归零后不再移动或造成接触伤害。
敌人每步追向玩家,速度为三十加波次乘七。接近到给定距离后停止继续靠近,接触距离满足条件且玩家无敌时间归零时,玩家减一生命并获得短暂无敌。多个敌人同时贴近也不能在同一步连续扣掉全部生命。此处是简单手写距离检测,没有墙体碰撞、复杂物理或绕障寻路;后续添加墙体必须补充路线和运动规则。
三波使用固定几何分布,没有随机种子系统。清空有效敌人后累积波次等待,未达到三波则生成下一波,否则进入 won。击杀数来自实际移除的死亡敌人,不能因画面重绘或重试再次增加。整局最高可击杀十二个敌人,最高记录名称虽显示 LOCAL BEST,实际单位是击杀数而非通关时间或综合评分。
输入与恢复规则
键盘支持 WASD、方向键、空格和 P。空格在 ready、won、lost 时开始或重试;运行时按住会持续提供攻击意图,空闲后可以再次开始。触摸方向按钮按住移动,抬起或取消移除方向;触摸攻击为一次提交。点击场地设置一个移动目标,玩家会走向目标,直到靠近或被新的操作替换。这不是按住拖拽才移动的虚拟摇杆。
隐藏事件会把正在运行的局暂停,并清空方向与目标;恢复后需要明确继续,不自动恢复战斗。规则层暂停冻结游戏时间、攻击时间、敌人移动、无敌和波次等待。输入清理是适配层责任,不能仅因为 stepArena 不推进,就假定旧按住状态已经消失。导航发生时还应避免开始按钮的同一次输入被当成攻击。
最高分在运行状态转为胜或负时更新,取本地旧值与本局击杀数的最大值,用 arena-best 键保存。存储读写失败不阻止游戏;本局中途关闭不会保存完整现场。此策略适合可丢失的教学记录,不提供账号隔离、跨设备合并或可信排行榜。若扩展到有价值的资产,需要重新设计数据边界,而不是只给字符串加密。
不变量帮助发现遗漏
运行中玩家生命不会高于初始值,敌人编号在一局内稳定,同一次攻击不会重复伤害同一敌人。暂停前后推进相同输入应保持规则快照不变;重试后生命、波次、击杀、攻击计时与敌人列表恢复新局状态。本地最高分只能不下降,局内击杀不能由 HUD 字符串反向决定。为这些性质写行为断言,比只检查函数是否被调用更有用。
当前简化也要进入规格:攻击可以边移动边转向,只有一种敌人,几何表现不含完整动画资源,战斗用距离与点积检测,本地最高分无防篡改保证。它们是当前行为边界;未来修改时,应把“希望改变什么”和“必须保留什么”分别列出,避免 AI 顺手重做输入和数据层。
给 AI 的任务与验收
任务示例:“按本页规格检查现有实现,列出每条规则对应的函数、字段与测试。不要先重构。若发现差异,给出从全新启动可复现的步骤与期望状态,再做最小修复。保留共享规则来源,不单独编辑同步副本。”这能将审查集中在实际行为。
验收先在模型层重放,再在 Cocos 画面核对距离、阶段和覆盖层。包含范围边界、同次攻击多步重叠、暂停恢复、失败优先、全部三波和重复重试;最高分另测试写入失败与重新加载。任何未执行的环境保持未验证,需求矩阵与执行结果分开维护。实现路径见代码导读,故障矩阵见案例验收。
规则时间与显示时间的差别
固定逻辑步使阶段切换发生在离散时刻,显示帧可能位于两个逻辑状态之间。验收前摇时,不要只拿录屏中某一帧估计毫秒,而应结合逻辑时间和 attackPhase。模型中的范围使用角色中心,几何图形则有可见半径,所以贴图边缘碰到并不必然满足中心距离条件。若未来改成考虑目标半径,需要同时改判定、图形和规格,不能只扩大扇形让画面看起来更容易命中。
最高分也要按实际单位理解:击杀数取最大值,不比较时间,因此更快通关不会刷新一个更高的分数。若要引入综合评分,必须新增评分公式、平手规则和旧记录迁移,不能只把现有文案改成排行榜。规格应保护这些不起眼的单位和比较规则,因为它们往往是后续 AI 扩展时最容易擅自补全的地方。
来源与核查范围
- 本仓库
src/lab/arenaRules.ts、examples/arena/assets/scripts/Arena.ts,核查日期:2026-11-17。参数与顺序来自当前源码。 - Cocos 3.8 节点事件系统,核查日期:2026-11-17。用于输入事件机制,案例具体输入语义由本项目定义。