# 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 |
|:---:|:---:|
|  |  |
| 场景 3 | 场景 4 |
|:---:|:---:|
|  |  |
## 本地运行
### 环境
- 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)。