Files

83 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 霓虹俄罗斯方块 · Neon Tetris
一个**零依赖、单文件**的 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