From 18016b27824c2bb8a577f14601419f2dd3c08212 Mon Sep 17 00:00:00 2001 From: class04f19 Date: Thu, 24 Sep 2026 04:03:51 +0000 Subject: [PATCH] Write project README with gameplay and tech notes --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 57 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b689c6d..b7a87d1 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,58 @@ -# neon-breakout-game +# 霓虹打砖块 · Neon Breakout -A neon-styled breakout game in a single HTML file \ No newline at end of file +一个用纯 HTML + Canvas + JavaScript 写成的霓虹风格打砖块小游戏,**单文件、零依赖**,双击 `index.html` 即可开玩。 + +## 游玩 + +在线打开: + +或克隆到本地后直接用浏览器打开 `index.html`: + +```bash +git clone https://gitea.compute-thinking.cn/class04f19/neon-breakout-game.git +cd neon-breakout-game +# 打开 index.html +``` + +## 操作 + +| 操作 | 按键 | +| --- | --- | +| 移动挡板 | 鼠标移动 / 手指滑动 / `←` `→` / `A` `D` | +| 发球 | `空格` / 点击画面 | +| 暂停 | `P` / `Esc` | +| 静音 | `M` | + +## 玩法要点 + +- 挡板**中心**接球 → 反弹更竖直;**边缘**接球 → 反弹角度更斜,用来打刁钻角落。 +- 砖块有 1~3 点血量,颜色越暖越硬,需要多次击打才会破碎。 +- 每块砖破碎后有 **14%** 概率掉落道具: + + | 道具 | 效果 | + | --- | --- | + | 🟩 `W` | 挡板加宽(持续 13 秒) | + | 🟦 `M` | 三重球(最多 6 个球) | + | 🟪 `S` | 所有球减速 | + | 🟥 `♥` | 生命 +1 | + +- 共 **3 关**,逐关砖块更硬、球速更快。掉球扣 1 条命,3 条命用完游戏结束。 + +## 技术实现 + +- **渲染**:全部 Canvas 2D 手绘,霓虹发光用 `shadowBlur` + 渐变,圆角矩形为自实现 `roundRect`。 +- **物理**:小球以 `1/240s` 子步进推进,避免高速穿模;砖块碰撞用「圆心到矩形最近点 + 重叠轴比较」决定反弹方向。 +- **音效**:Web Audio API 实时合成振荡器方波/三角波,**无任何音频文件**,首次交互时创建 `AudioContext`。 +- **适配**:画布固定 800×600 逻辑尺寸,CSS 按容器缩放,指针坐标按 `getBoundingClientRect()` 换算,手机端同样可玩。 + +## 项目结构 + +``` +. +├── index.html # 游戏本体(HTML + CSS + JS 全在这一个文件里) +└── README.md +``` + +## 许可 + +MIT