10 KiB
HEROLL 玩法验证 MVP 最新整合文档
版本：2026-08-24
状态：当前可运行 DEMO 的规范基线
范围：Grass 主题、10 层、单机玩法验证；不包含广告、局外成长、抽卡、付费或联网功能。
1. 本版锁定结论
- 棋盘共有 40 个独立实际地块，不存在“10 个逻辑格映射 40 个画面格”。
- 双骰总点数就是移动步数：1 点移动 1 个地块。例如从 0 号起点 ROLL 出 10，角色顺时针逐格移动 10 次并停在 10 号地块。
- 棋盘固定不旋转。角色从底部起点出发，沿左侧、顶部、右侧顺时针移动。
- 普通战斗格按 1–4 个骷髅区分，严格对应 1–4 只怪物。
- 加入普通小 Boss 地块和污染 Boss 地块；暂不加入其他负面格或原作角落格。
- 战斗、两类小 Boss、商店或事件完整结算后，来源地块变成荒地。
- 每层只走完一圈。进入下一层后，荒地继续保持荒地，除非被 Boss 转化/污染机制或新增地块覆盖。
- 保留所有必要的移动、落地、战斗、UI 数字和结算动画；正常游玩不提供跳过动画或直接硬切界面的入口。
- 当前 DEMO 不显示任何广告按钮；死亡时仅允许源码复生祝福生效，否则进入失败结算。
2. 核心循环
```text ROLL 双骰 → 显示两枚骰子和总点数 → 按总点数逐格顺时针移动 → 播放落地反馈 → 结算战斗 / 小Boss / 商店 / 事件 / 荒地 → 已结算功能格变荒地 → 越过起点进入下一层，恢复最大生命的30% → 第10层击败最终Boss后胜利 ```
角色从 39 号地块继续前进会越过 0 号起点。每次越过起点只触发一次楼层推进，不会重复结算起点，也不会在同一移动中再次触发其他落点。
3. 棋盘与地块完整清单
3.1 基础地块
| 地块 | 图形识别 | 数量/生成 | 停留作用 | 结算后 |
|---|---|---|---|---|
| 起点 `START` | 蓝色起点图标 | 固定 1 个，索引 0 | 越过时进入下一层并恢复最大生命 30% | 永久保留 |
| 荒地 `EMPTY` | 无功能图标的空格 | 初始剩余位置及已消耗位置 | 无事件、无战斗，落地后返回 ROLL | 继续保留，直到被合法覆盖 |
| 普通战斗 1 骷髅 | 1 个骷髅 | 初始普通战斗池 | 生成 1 只普通怪物 | 胜利后变荒地 |
| 普通战斗 2 骷髅 | 2 个骷髅 | 初始普通战斗池 | 生成 2 只普通怪物 | 胜利后变荒地 |
| 普通战斗 3 骷髅 | 3 个骷髅 | 初始普通战斗池 | 生成 3 只普通怪物 | 胜利后变荒地 |
| 普通战斗 4 骷髅 | 4 个骷髅 | 初始普通战斗池 | 生成 4 只普通怪物 | 胜利后变荒地 |
| 普通小 Boss `MINIBOSS` | 原作普通 Boss 地块和怪箱图标 | 初始 1 个 | 触发小 Boss 战斗；怪物数量随机 1–4 | 胜利后变荒地 |
| 污染 Boss `INFECTED_BOSS` | 原作污染 Boss 地块和污染怪箱图标 | 初始 1 个 | 触发污染小 Boss 战斗；未消灭时进入新层会污染普通战斗格，最多生效 3 次 | 胜利后变荒地 |
| 商店 `MERCHANT` | 原作蓝色商店图标 | 第 3/6/9 层安装 | 打开 3 个固定丹药商品和 3 个随机商品 | 离开后变荒地 |
新局棋盘初始生成 13 个普通战斗格、1 个普通小 Boss、1 个污染 Boss、1 个本层核心事件和起点，其余位置为荒地。所有 40 个位置均可被角色真实停留。
3.2 事件地块
| ID | 地块 | 当前 DEMO 作用 | 结算后 |
|---|---|---|---|
| EV-137 | 铁匠铺 | 选择已装备物品强化；按品质使用 80%/50%/30%/10%/0% 基础成功率，失败时装备被分解 | 荒地 |
| EV-138 | 灵泉/营火 | 恢复最大生命 30%，不超过上限 | 荒地 |
| EV-139 | 传奇装备 | 生成 1 件传奇装备并进入标准装备比较 | 荒地 |
| EV-140 | 挖掘 | 5×5 棋盘，基础 5 次挖掘；获得局内点数或装备 | 荒地 |
| EV-141 | 宝箱 | 生成 1 件普通掉落池装备并进入装备比较 | 荒地 |
| EV-142 | 彩票 | 单次随机结算；当前验证收益为 100/20/7/0 点 | 荒地 |
| EV-143 | 21 点 | 当前验证版自动比较玩家与庄家点数，奖励 18/5/0 点 | 荒地 |
| EV-144 | 祝福点 | 揭示并接受 1 个祝福 | 荒地 |
| EV-151 | 抓娃娃 | 基础 1 次，当前验证成功率 55%；成功获得装备 | 荒地 |
| EV-152 | 黄金马车 | 二选一：恢复最大生命 20%，或获得 15 点 | 荒地 |
| EV-164 | 骰子机 | 掷 3 枚 D6；三同 50 点、对子 15 点，否则获得最大骰面点数 | 荒地 |
| EV-166 | 泡泡射手 | 基础 3 发，每发获得 1–6 点 | 荒地 |
事件格使用各自的 `Installtile_*` 原作图标。当前不加入未确认的负面格、角落格或额外事件种类。
4. 地块生命周期与跨层规则
每个功能地块在一局中遵循同一条生命周期：
```text 功能地块 → 玩家落地 → 完整播放进入与结算动画 → 战斗胜利或事件退出/领取完成 → 该位置变为荒地 → 进入下一层仍保持荒地 ```
允许覆盖荒地的来源只有两类：
- Boss 2+4 行动将合法的非起点、非祝福位置转为普通战斗格。
- 过层或商店购买产生的新增地块安装到合法荒地。
污染 Boss 自身未被消灭时，每次进入新层让现存普通战斗格的怪物数 `+1`，最高 4 只，同时污染层级 `+1`，最多生效 3 次。它不会覆盖起点或祝福格。
5. Boss 行动规则
Boss Gauge 不是“玩家攻击几次、Boss 攻击一次”的战斗条。它只统计玩家完成的 ROLL 行动：
- 玩家先完成 2 次 ROLL，右侧显示 `0/2 → 1/2`。
- 第二次 ROLL 后进入 4 次 ROLL 倒计时，显示 `4 → 3 → 2 → 1 → 0`。
- 倒计时结束后，播放 Boss 警示、棋盘震动和逐格转化动画。
- Boss 将 4 个互不重复的合法地块变为普通战斗格。
- 祝福格和起点不会被转化。
- 行动结束后回到玩家 2 次 ROLL 的蓄势阶段，循环继续。
6. 战斗与难度
- 普通战斗格的骷髅数就是本场敌人数，不允许图标与实际敌人数不一致。
- 1–4 敌人的单体攻击倍率分别为 `1.00 / 0.72 / 0.58 / 0.48`，避免多目标简单叠加造成不可控秒杀。
- 普通小 Boss 和污染 Boss 的怪物数量权重为 `60% / 25% / 10% / 5%`，分别对应 1/2/3/4 只。
- 小 Boss 在同层普通敌人基线上使用 `生命 ×1.18、攻击 ×1.12`。
- 玩家和敌人自动攻击，保留反击。玩家战斗中的唯一即时主动输入是丹药。
- 初始配置已加入新手容错，自动化用例要求不使用丹药、广告或调试强化也能连续击败前三组普通怪物。
7. 丹药
全局只有一种丹药。商店固定提供三个丹药商品：
| 商品 | 作用 |
|---|---|
| 补充丹药 | 增加 1 瓶，但不能超过当前持有上限 |
| 增加上限 | 持有上限永久增加 1 瓶 |
| 增加恢复量 | 提升这唯一一种丹药的基础恢复量 |
当前验证实现按逆向配置使用固定 HP 基础曲线 `50、80、110……650`；最大生命百分比治疗由独立丹药祝福叠加。丹药只在战斗中可使用，恢复不超过最大生命。进入下一层的 30% 恢复属于楼层机制，不消耗丹药。
8. 主要 UI 位置
| 区域 | 位置 | 内容与作用 |
|---|---|---|
| 局内货币 | 左上 | 当前局内点数 |
| AUTO / 暂停 | 右上 | 自动战斗状态与暂停入口 |
| 楼层进度 | 右侧竖条 | 当前层/总层数、Boss 蓄势或倒计时 |
| 棋盘 | 画面中上部 | 40 个实际地块、中心 Boss、玩家棋子和顺时针路线 |
| 玩家状态 | 棋盘下方 | 当前层、等级、生命值与生命条 |
| 装备 | 底部中间 | 武器、戒指、手套、鞋四个固定槽 |
| 属性查看 | 左下 | 打开角色属性与调试验收入口 |
| ROLL | 底部中央 | 唯一的棋盘主操作；掷骰期间锁定 |
| 丹药 | 右下 | 显示当前瓶数/上限；仅战斗中可用 |
地块必须优先通过原作图标辨认，文字只作为辅助，不允许玩家只能依赖颜色或猜测地块功能。
9. 动画与节奏硬约束
以下表现均必须保留一段可读动画或反馈：按钮按下、双骰滚动和定格、总点数显示、逐格移动、落地、过层恢复、战斗进入、双方攻击与受击、伤害和治疗数字、反击、胜利/失败、装备比较、祝福、商店购买、事件操作、源码祝福复生和最终结算。
正常游玩不得提供跳过这些动画的按钮，也不得在 ROLL 后直接把角色硬跳到最终地块。调试入口可加速战斗，但不能改变点数、步数、落点或结算顺序。
10. 当前验证结果
| 验收项 | 结果 |
|---|---|
| TypeScript 严格编译 | 通过 |
| 核心自动测试 | 24/24 通过 |
| 40 个独立实际地块 | 通过 |
| 可见 ROLL 总点数 = 动画步数 = 最终索引差 | 通过 |
| 1–4 骷髅 = 1–4 只怪物 | 通过 |
| 两类小 Boss 与三次污染 | 通过 |
| 战斗/事件变荒地且跨层保留 | 通过 |
| Boss 2+4 循环并转化 4 个地块 | 通过 |
| 浏览器完整冒烟 | 通过 |
| 原作 UI/地块资源还原测试 | 通过 |
| 广告按钮数量 | 0 |
11. 证据到实现
| 证据 | 结论 | 实现路径 |
|---|---|---|
| 用户标注图 1 | 点数必须与实际地块步数一一对应 | `ROLL → dice sum → animateMovement(sum) → tileIndex` |
| 用户标注图 2 | HUD、棋盘、装备、ROLL、丹药采用原作关卡内布局 | `main.ts` 渲染层 + `styles.css` 固定锚点 |
| 用户标注图 3 | 1–4 骷髅、小 Boss、污染 Boss 是不同战斗地块 | `TileState.kind/enemyCount` → 独立原作资源 → `startBattle` |
| 用户本轮确认 | 已触发地块变荒地并跨层保留；暂不加入其他负面格 | `clearTileAfterResolution` → `EMPTY` → 过层保留 |
| 自动测试与实机截图 | 规则、移动和资源加载可重复验证 | `mvp/tests/core.test.mjs`、`browser-smoke.mjs`、`restoration.test.mjs` |
12. 运行与复验
双击项目根目录：
```text HEROLL_MVP_START.cmd ```
完整验证：
```powershell cd C:\Users\toshio\Documents\ChatGPT\heroll\mvp .\Validate-Heroll-MVP.ps1 ```
启动器自检（不打开浏览器）：
```cmd set HEROLL_MVP_SELF_TEST=1 HEROLL_MVP_START.cmd ```
更细的公式、数据表和技术契约见 `design/gameplay-validation/Heroll_Gameplay_Validation_GDD.md`；原作视觉证据和还原边界见 `analysis/reference-study/RESTORATION_REPORT.md`。