diff --git a/README.md b/README.md index c888500..e92bc8c 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,82 @@ -# neon-tetris +# 霓虹俄罗斯方块 · Neon Tetris -霓虹俄罗斯方块 · Neon Tetris —— 单文件 HTML5 俄罗斯方块(SRS 旋转 / 7-bag / Hold / 幽灵块 / 连消) \ No newline at end of file +一个**零依赖、单文件**的 HTML5 俄罗斯方块。打开 `index.html` 就能玩,键盘和手机触屏都支持。 + +用的是**现代俄罗斯方块(Guideline / SRS)**那一套规则,不是简化版:SRS 旋转 + 踢墙、7-bag 随机器、Hold 暂存、幽灵块、锁定延迟、连消加成。 + +## 玩法与规则 + +| 机制 | 说明 | +| --- | --- | +| **SRS 旋转** | 采用标准 Super Rotation System 出生朝向与踢墙表,贴墙、贴地的旋转都能转进去;I 块有独立的踢墙表 | +| **7-bag 随机器** | 每 7 个方块为一袋随机排列,保证不会出现长时间不出 I 块、也不会长时间重复同一种 | +| **Hold 暂存** | `C` 或点击 HOLD 框,把当前方块存起来 / 取出,每个方块落地前只能用一次 | +| **幽灵块** | 半透明轮廓显示方块会落在哪里 | +| **锁定延迟** | 落地后有 500ms 缓冲,期间移动/旋转会重置计时(最多 15 次),可以放心做最后调整 | +| **7 种方块** | I / J / L / O / S / T / Z,各有独立霓虹配色 | +| **等级** | 每消 10 行升一级,共 20 级,下落速度从 700ms/格加快到 50ms/格 | + +## 计分 + +| 行为 | 分数 | +| --- | --- | +| 消 1 / 2 / 3 行 | 100 / 300 / 500 × 等级 | +| **Tetris(消 4 行)** | 800 × 等级 | +| 连消(连续几次落子都消行) | 额外 50 × 连击数 × 等级 | +| 软降 | +1 / 格 | +| 硬降 | +2 / 格 | + +最高分存在浏览器 `localStorage` 里。 + +## 操作 + +| 操作 | 键盘 | 触屏 | +| --- | --- | --- | +| 左右移动 | `←` `→` / `A` `D` | 下方 ← → | +| 软降 / 硬降 | `↓` / `空格` | ↓ / ⤓ | +| 顺时针 / 逆时针 | `↑` `X` / `Z` | ↻ / ↺ | +| 暂存 | `C` | 点击 HOLD 框 | +| 开始 / 暂停 | `空格` `Enter` / `P` `Esc` | 点按钮 | + +切到别的标签页会自动暂停;右上角可以关音效。 + +## 运行 + +方式一,直接双击 `index.html`。 + +方式二,起个本地静态服务: + +```bash +python3 -m http.server 8000 +# 然后打开 http://localhost:8000 +``` + +方式三,部署到 Gitea Pages / GitHub Pages / 任意静态托管,仓库根目录当站点根目录即可。 + +## 实现要点 + +- **Canvas 2D + 分层缓存**:棋盘(已固定的方块)画在一张离屏 canvas 上,只在方块落地/消行时重绘;每帧只 `drawImage` + 画当前方块和幽灵块。这样即使每个方块都带 `shadowBlur` 霓虹发光,也不会每帧重算 200 次阴影,低端手机也能跑满帧。 +- **帧率无关的更新循环**:用 `requestAnimationFrame` 的 `dt` 驱动重力累积器、锁定延迟计时、消行动画和震屏衰减,切标签页回来不会瞬移。 +- **状态机**:`ready → playing ⇄ paused`、`playing → clearing → playing`、`→ over`。消行时进入 `clearing` 状态播 190ms 的闪白动画,之后再压缩棋盘并生成新方块,逻辑与表现分离。 +- **踢墙表用屏幕坐标**:SRS 官方表的 y 轴向上为正,代码里 y 向下为正,所以表里的 y 全部取反后直接写进代码,避免运行时反复换算出错。 +- **旋转矩阵**:`new[y][x] = old[n-1-x][y]`;逆时针就把顺时针做三次(矩阵只有 3×3 / 4×4,够快且不易写错)。 +- **音效全部 WebAudio 现场合成**,整个游戏没有一个外部资源文件。 +- **响应式布局**:棋盘宽度用 `min(94vw, 320px, (100dvh - 预留高度)/2)` 计算,保证 10×20 的棋盘在任何屏幕上都不被裁切;只有触屏设备才显示虚拟按键。 + +## 文件 + +``` +. +├── index.html # 全部代码:结构 + 样式 + 游戏逻辑 +└── README.md +``` + +## 可以继续加的东西 + +- T-spin 判定与加分、Back-to-Back 连击 +- 前 40 行竞速(Sprint)与限时(Ultra)模式 +- 回放录制 / 在线排行榜 + +## License + +MIT