# cat-tower-defense **Repository Path**: dihl/cat-tower-defense ## Basic Information - **Project Name**: cat-tower-defense - **Description**: 塔防 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-01 - **Last Updated**: 2026-10-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 猫咪塔防 基于 **Cocos Creator 3.8.8 + TypeScript** 的塔防小游戏:部署猫咪英雄,抵御鼠群波次,守护城堡。 仓库:https://github.com/Zhoupy0608/cat-tower-defense ## 核心特色 - **11 种猫咪英雄**:远程物理 / 魔法射击,近战骑士与刺客 - **16 种敌人**(含 Boss):护甲、潜行、召唤等差异化能力 - **10 关渐进解锁**:前几关解锁英雄,后续关卡强化压力 - **统一投射物系统**:子弹、魔法弹、冲击波等 - **点选或拖拽部署**:底部选猫后点击草地格子放置 - **GridMath 可测坐标层**:布局与点击同源公式,`npm test` 覆盖 - **敌人对象池统计**:命中率可观测,便于刷怪性能优化 ## 游戏截图
| 场景 1 | 场景 2 | |:---:|:---:| | ![场景1](docs/screenshots/gameplay-armored-mouse.png) | ![场景2](docs/screenshots/gameplay-boss-giant.png) | | 场景 3 | 场景 4 | |:---:|:---:| | ![场景3](docs/screenshots/gameplay-early-waves.png) | ![场景4](docs/screenshots/gameplay-hero-selection.png) |
## 本地运行 ### 环境 - Cocos Creator **3.8.8** - Node.js 16+(跑单测时需要) ### 步骤 1. 克隆仓库 ```bash git clone https://github.com/Zhoupy0608/cat-tower-defense.git cd cat-tower-defense ``` 2. 用 Cocos Creator 打开本目录 3. **双击** `assets/scene.scene`(不要预览空的 Untitled) 4. 点击工具栏 **预览** ### 单测 ```bash npm install npm test ``` ## 操作说明 | 操作 | 说明 | |------|------| | 点击底部英雄 | 选中(可放置的英雄) | | 再点草地虚线格 | 放置英雄 | | 或按住拖到格子松手 | 拖拽放置 | | 顶部「开始战斗」 | 开始当前波次 | 竖屏设计分辨率约 **720×1280**,预览时请看完整画面顶部按钮。 ## 项目结构 ``` assets/ ├── scripts/ # TypeScript 逻辑 │ ├── components/ # 英雄 / 敌人 / UI / 城堡 │ ├── managers/ # 战斗 / 波次 / 关卡 │ ├── projectiles/ # 投射物 │ ├── systems/ # 网格、对象池、启动器、GridMath │ ├── types/ # 类型与关卡配置 │ └── utils/ ├── resources/images/ # 贴图与图标 └── scene.scene # 主场景 tests/ # Vitest 单测 RESUME_BULLETS.md # 简历要点 ``` ## 技术栈 - 引擎:Cocos Creator 3.8.8 - 语言:TypeScript - 单测:Vitest - 常用模式:组件化、工厂、对象池 ## 玩法简述 - 英雄部署在 11×6 网格,用投射物攻击,不承伤 - 敌人沿路径进攻城堡;城堡血量为 0 则失败 - 清完本关全部波次即胜利 ## License MIT,详见 [LICENSE](./LICENSE)。