# paoku

**Repository Path**: jasydong/paoku

## Basic Information

- **Project Name**: paoku
- **Description**: WEB跑酷游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# paoku · WEB 跑酷游戏

一款基于 **原生 HTML5 Canvas + JavaScript** 的 **2.5D 伪3D 三车道无尽跑酷** 游戏。角色在三条车道上奔跑，左右变道、跳跃躲避障碍、收集金币，距离越远难度越高，挑战最高分。

## 特性
- 🎮 零依赖、零构建：纯原生 Canvas + ES Modules，浏览器即开即玩
- 🛣️ 2.5D 伪3D 三车道透视渲染（近大远小）
- 🏃 程序化绘制扁平卡通风角色/障碍/场景（无图片资源）
- 📈 无尽模式：速度与障碍密度随距离递增
- 🌗 日/黄昏/夜主题随距离切换
- ⌨️ 📱 桌面键盘 + 移动触屏双端操控，响应式自适应
- 💾 本地存储最高分
- ✨ 粒子特效（金币收集 / 撞击）、屏幕震动、程序化音效

## 玩法
- 三车道无尽奔跑，角色固定在近处
- **低障碍**（锥桶/栅栏/矮墙）：跳跃越过
- **高障碍**（横杆）：必须变道躲避，跳了也撞
- **金币**：低空直接吃，高空需跳跃收集
- 距离越远速度越快、障碍越密，每 1200m 切换主题
- 分数 = 距离(米) + 金币 × 25

## 技术栈
| 维度 | 选择 |
|------|------|
| 渲染 | 原生 HTML5 Canvas 2D |
| 语言 | 原生 JavaScript（ES Modules） |
| 构建 | 无（直接浏览器运行） |
| 美术 | 程序化绘制（Canvas API） |

## 运行方式
> ⚠️ 因使用 ES Modules，需通过本地 HTTP 服务器预览，不能直接 `file://` 打开。

任选其一：
```bash
# Python
python3 -m http.server 8080

# Node（需 npx）
npx serve
```
然后浏览器访问 `http://localhost:8080`。

## 操作说明
**桌面**
- `←` / `→`：左右变道
- `↑` / `空格`：跳跃
- `P`：暂停
- `Enter`：开始 / 重玩

**移动**
- 左右滑动：变道
- 上滑：跳跃
- 点击暂停按钮：暂停

## 项目结构
```
paoku/
├── index.html              # 入口
├── docs/DEVELOPMENT.md     # 开发计划文档
├── css/style.css           # 样式
└── js/
    ├── main.js             # 入口
    ├── config.js           # 全局配置
    ├── Game.js             # 主类（状态机/主循环）
    ├── utils.js            # 透视投影与工具
    ├── input.js            # 输入管理
    ├── storage.js          # 最高分存取
    ├── entities/           # Player/Obstacle/Coin
    ├── render/             # Road/Sprites/UI
    └── states/             # Menu/Play/Over
```
详细架构与分阶段计划见 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。

## 参与贡献
1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request