复古卡通俄罗斯方块 laidick/retro-cartoon-tetris

TETRIS — 复古卡通版（Rust）

用 Rust 写的完整俄罗斯方块游戏，现代卡通美术风格，配 NES 风格芯片音乐。所有内容都在运行时生成：图形靠程序绘制，音乐和音效在启动时合成进 WAV 缓冲区，所以不需要附带任何外部音频文件。

演示： 这个游戏由 DeepSeek Harness + DeepSeek 4.1 Flash 根据一句一次性提示词构建。

游戏画面

这是什么

- 规则： SRS 旋转加踢墙，7-bag 随机，暂存，幽灵方块，官方计分，500 ms 锁定延迟且移动可重置，等级速度曲线，消行动画，block-out/lock-out 判负。
- 图形： 「现代复古卡通」——粗墨线描边，贴纸面板配硬阴影，半调日落背景，漫画爆炸效果，彩纸屑，还有会做表情的吉祥物。用 macroquad 图元渲染；唯一的素材是一款 OFL 显示字体。
- 音频： Korobeiniki（公有领域民谣，原版 NES 俄罗斯方块 Type A 音乐用的就是它）改编成两个脉冲声部加三角波贝斯，150 BPM；另有 NES 风味音效（移动、旋转、锁定、硬降、暂存、消行、四行欢呼、升级、游戏结束）。

构建与运行

需要 Rust 工具链（在 1.98 上测试过）和音频设备。

cargo run --release

如果你的环境无法写入 ~/.cargo（某些沙箱环境会这样），把 Cargo 指向可写的注册表缓存：

CARGO_HOME="$PWD/.cargo-home" cargo run --release

操作

| 按键 | 动作 |
| ← / → | 移动（DAS/ARR） |
| ↓ | 软降 |
| Space | 硬降 |
| ↑ / X | 顺时针旋转 |
| Z / Left Ctrl | 逆时针旋转 |
| C / Left Shift | 暂存 |
| P / Esc | 暂停 |
| R | 重新开始 |
| M | 音乐开/关 |
| Enter | 开始 / 再玩一局 |
| Esc（游戏结束时） | 返回菜单 |

菜单里用 ←/→（或 ↑/↓）选择起始等级（1–15）。

截图模式

用于视觉回归检查，不用碰键盘：

cargo run --release -- --shot out.png --screen play
cargo run --release -- --shot menu.png --screen menu
cargo run --release -- --shot pause.png --screen pause
cargo run --release -- --shot over.png --screen gameover

--mute 关闭音频。--audio-check 加载生成的音频片段，并打印解码成功的数量。--dump-audio DIR 把合成的音乐和音效写成 WAV 文件供检查：

cargo run --release -- --dump-audio /tmp/tetris-audio

测试

cargo test

测试套件覆盖随机生成器、SRS 踢墙、旋转完整性、消行、计分、等级推进、暂存规则、锁定延迟、幽灵方块、游戏结束，以及一次 4000 步的随机对局模拟，外加 WAV 文件头和音频合理性检查。

项目结构

- src/game.rs — 纯规则，确定性 RNG，单元测试（不需要窗口）。
- src/audio.rs — WAV 合成，Korobeiniki 编曲，音效库，测试。
- src/render.rs — 卡通渲染器，吉祥物，粒子，菜单/覆盖层。
- src/main.rs — 窗口、输入/DAS、状态机、音频触发、截图。

许可证

代码和程序化生成的画面采用 MIT 许可证（LICENSE）。
内置的 Lilita One 字体采用 SIL Open Font License 1.1（assets/OFL.txt）。Korobeiniki 是公有领域民歌。

致谢

- Korobeiniki：俄罗斯传统民歌，公有领域。
- Lilita One 字体：SIL Open Font License 1.1（assets/OFL.txt）。
- macroquad 游戏框架（MIT/Apache-2.0）。