feat(assets): 添加三张地图背景图和装饰物素材
This commit is contained in:
Cloud Bot
292
.docs/tasks/task-multi-map-difficulty.md
Normal file
292
.docs/tasks/task-multi-map-difficulty.md
Normal file
@@ -0,0 +1,292 @@
|
||||
# 任务：多地图 + 难度系统 + 场景化改造
|
||||
|
||||
## 目标
|
||||
1. 主页新增难度选择（低/中/高），点击后带参数跳转游戏
|
||||
2. 实现3张地图，每5波切换一次（地图1→地图2→地图3）
|
||||
3. 每张地图有专属背景图、路径形状、装饰物
|
||||
4. 波次配置根据难度动态调整（怪物数量、速度、Boss频率）
|
||||
|
||||
## 素材已就绪
|
||||
`/public/game-assets/` 目录中已有：
|
||||
- `map1-bg.png`、`map2-bg.png`、`map3-bg.png` — 三张地图背景
|
||||
- `deco-coffee.png`、`deco-monitor.png`、`deco-desk.png` — 装饰物
|
||||
|
||||
## 文件改动清单
|
||||
|
||||
### 1. `game/data/mapConfigs.ts`（新建）
|
||||
定义3张地图的配置：
|
||||
|
||||
```typescript
|
||||
export type DifficultyLevel = 'easy' | 'normal' | 'hard'
|
||||
|
||||
export interface MapConfig {
|
||||
id: number
|
||||
name: string // 地图名称
|
||||
bgKey: string // Phaser 加载的背景图 key
|
||||
bgPath: string // 背景图路径
|
||||
pathColor: number // 路径格颜色
|
||||
buildColor: number // 可建格颜色
|
||||
waypoints: readonly { x: number; y: number }[] // 路径折线坐标
|
||||
decorations: { // 装饰物（固定摆放的非路径格）
|
||||
key: string
|
||||
col: number
|
||||
row: number
|
||||
}[]
|
||||
labels: { col: number; row: number; text: string }[]
|
||||
waveCount: number // 每张地图波次数（固定5）
|
||||
// 每波配置（相对于 normal 难度的基础配置）
|
||||
waves: WaveConfigEntry[]
|
||||
}
|
||||
|
||||
export interface WaveConfigEntry {
|
||||
enemies: {
|
||||
type: 'FreshGraduate' | 'OldEmployee' | 'TroubleMaker' | 'BossVP'
|
||||
count: number
|
||||
interval: number // ms
|
||||
}[]
|
||||
}
|
||||
|
||||
// 难度倍率
|
||||
export const DIFFICULTY_MULTIPLIER: Record<DifficultyLevel, {
|
||||
enemyCount: number // 数量倍率
|
||||
enemySpeed: number // 速度倍率
|
||||
bossHp: number // Boss HP 倍率
|
||||
hcReward: number // HC 奖励倍率（难度高奖励少）
|
||||
}> = {
|
||||
easy: { enemyCount: 0.7, enemySpeed: 0.8, bossHp: 0.7, hcReward: 1.2 },
|
||||
normal: { enemyCount: 1.0, enemySpeed: 1.0, bossHp: 1.0, hcReward: 1.0 },
|
||||
hard: { enemyCount: 1.4, enemySpeed: 1.3, bossHp: 1.5, hcReward: 0.8 },
|
||||
}
|
||||
|
||||
// 地图1：人力资源部（HR走廊，S型路径）
|
||||
// 路径：(0,2)→(11,2)→(11,9)→(15,9)
|
||||
const MAP1: MapConfig = {
|
||||
id: 1,
|
||||
name: '人力资源部 · 降本增效',
|
||||
bgKey: 'map1-bg',
|
||||
bgPath: '/game-assets/map1-bg.png',
|
||||
pathColor: 0x3d2b1f,
|
||||
buildColor: 0x1e3a5f,
|
||||
waypoints: [
|
||||
{ x: 0, y: 2 },
|
||||
{ x: 11, y: 2 },
|
||||
{ x: 11, y: 9 },
|
||||
{ x: 15, y: 9 },
|
||||
],
|
||||
decorations: [
|
||||
{ key: 'deco-coffee', col: 3, row: 0 },
|
||||
{ key: 'deco-monitor', col: 14, row: 1 },
|
||||
{ key: 'deco-desk', col: 5, row: 5 },
|
||||
{ key: 'deco-coffee', col: 9, row: 11 },
|
||||
{ key: 'deco-monitor', col: 1, row: 7 },
|
||||
{ key: 'deco-desk', col: 13, row: 4 },
|
||||
],
|
||||
labels: [
|
||||
{ col: 0, row: 0, text: '面试间' },
|
||||
{ col: 14, row: 10, text: '财务室' },
|
||||
{ col: 6, row: 5, text: 'HR办公区' },
|
||||
],
|
||||
waveCount: 5,
|
||||
waves: [
|
||||
{ enemies: [{ type: 'FreshGraduate', count: 10, interval: 800 }] },
|
||||
{ enemies: [{ type: 'FreshGraduate', count: 8, interval: 700 }, { type: 'OldEmployee', count: 2, interval: 2000 }] },
|
||||
{ enemies: [{ type: 'OldEmployee', count: 4, interval: 1800 }, { type: 'TroubleMaker', count: 3, interval: 1500 }] },
|
||||
{ enemies: [{ type: 'FreshGraduate', count: 12, interval: 600 }, { type: 'TroubleMaker', count: 3, interval: 1200 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 1, interval: 0 }, { type: 'OldEmployee', count: 3, interval: 2000 }, { type: 'FreshGraduate', count: 5, interval: 800 }] },
|
||||
],
|
||||
}
|
||||
|
||||
// 地图2：技术研发部（Z型路径，更复杂）
|
||||
// 路径：(0,1)→(8,1)→(8,5)→(3,5)→(3,10)→(15,10)
|
||||
const MAP2: MapConfig = {
|
||||
id: 2,
|
||||
name: '技术研发部 · 996福报',
|
||||
bgKey: 'map2-bg',
|
||||
bgPath: '/game-assets/map2-bg.png',
|
||||
pathColor: 0x1a3a2a,
|
||||
buildColor: 0x0f2040,
|
||||
waypoints: [
|
||||
{ x: 0, y: 1 },
|
||||
{ x: 8, y: 1 },
|
||||
{ x: 8, y: 5 },
|
||||
{ x: 3, y: 5 },
|
||||
{ x: 3, y: 10 },
|
||||
{ x: 15, y: 10 },
|
||||
],
|
||||
decorations: [
|
||||
{ key: 'deco-monitor', col: 1, row: 3 },
|
||||
{ key: 'deco-monitor', col: 10, row: 0 },
|
||||
{ key: 'deco-coffee', col: 6, row: 7 },
|
||||
{ key: 'deco-desk', col: 11, row: 3 },
|
||||
{ key: 'deco-monitor', col: 5, row: 8 },
|
||||
{ key: 'deco-coffee', col: 14, row: 7 },
|
||||
{ key: 'deco-desk', col: 0, row: 6 },
|
||||
{ key: 'deco-monitor', col: 13, row: 5 },
|
||||
],
|
||||
labels: [
|
||||
{ col: 0, row: 0, text: '研发中心' },
|
||||
{ col: 14, row: 11, text: '服务器机房' },
|
||||
{ col: 5, row: 3, text: '格子间' },
|
||||
{ col: 10, row: 8, text: 'Bug池' },
|
||||
],
|
||||
waveCount: 5,
|
||||
waves: [
|
||||
{ enemies: [{ type: 'FreshGraduate', count: 12, interval: 700 }, { type: 'OldEmployee', count: 2, interval: 2000 }] },
|
||||
{ enemies: [{ type: 'OldEmployee', count: 5, interval: 1500 }, { type: 'TroubleMaker', count: 3, interval: 1200 }] },
|
||||
{ enemies: [{ type: 'FreshGraduate', count: 15, interval: 500 }, { type: 'TroubleMaker', count: 4, interval: 1000 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 1, interval: 0 }, { type: 'OldEmployee', count: 4, interval: 1500 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 1, interval: 0 }, { type: 'FreshGraduate', count: 10, interval: 600 }, { type: 'TroubleMaker', count: 5, interval: 1000 }] },
|
||||
],
|
||||
}
|
||||
|
||||
// 地图3：高管会议室（W型路径，最难）
|
||||
// 路径：(0,0)→(5,0)→(5,6)→(10,6)→(10,2)→(15,2) 先上后下再上
|
||||
const MAP3: MapConfig = {
|
||||
id: 3,
|
||||
name: '高管会议室 · 最后决战',
|
||||
bgKey: 'map3-bg',
|
||||
bgPath: '/game-assets/map3-bg.png',
|
||||
pathColor: 0x3d1f2b,
|
||||
buildColor: 0x2d1a40,
|
||||
waypoints: [
|
||||
{ x: 0, y: 0 },
|
||||
{ x: 5, y: 0 },
|
||||
{ x: 5, y: 6 },
|
||||
{ x: 10, y: 6 },
|
||||
{ x: 10, y: 2 },
|
||||
{ x: 15, y: 2 },
|
||||
],
|
||||
decorations: [
|
||||
{ key: 'deco-desk', col: 2, row: 2 },
|
||||
{ key: 'deco-desk', col: 8, row: 0 },
|
||||
{ key: 'deco-coffee', col: 12, row: 5 },
|
||||
{ key: 'deco-desk', col: 7, row: 9 },
|
||||
{ key: 'deco-monitor', col: 2, row: 9 },
|
||||
{ key: 'deco-coffee', col: 13, row: 9 },
|
||||
{ key: 'deco-desk', col: 1, row: 4 },
|
||||
{ key: 'deco-monitor', col: 14, row: 4 },
|
||||
{ key: 'deco-desk', col: 8, row: 8 },
|
||||
],
|
||||
labels: [
|
||||
{ col: 0, row: 1, text: '董事会' },
|
||||
{ col: 14, row: 3, text: '董事长室' },
|
||||
{ col: 7, row: 4, text: '会议室' },
|
||||
],
|
||||
waveCount: 5,
|
||||
waves: [
|
||||
{ enemies: [{ type: 'OldEmployee', count: 6, interval: 1500 }, { type: 'TroubleMaker', count: 4, interval: 1000 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 1, interval: 0 }, { type: 'FreshGraduate', count: 12, interval: 600 }, { type: 'OldEmployee', count: 3, interval: 1500 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 1, interval: 0 }, { type: 'TroubleMaker', count: 6, interval: 800 }, { type: 'OldEmployee', count: 4, interval: 1500 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 2, interval: 5000 }, { type: 'OldEmployee', count: 5, interval: 1200 }, { type: 'FreshGraduate', count: 8, interval: 600 }] },
|
||||
{ enemies: [{ type: 'BossVP', count: 2, interval: 3000 }, { type: 'TroubleMaker', count: 8, interval: 600 }, { type: 'OldEmployee', count: 6, interval: 1000 }] },
|
||||
],
|
||||
}
|
||||
|
||||
export const ALL_MAPS: MapConfig[] = [MAP1, MAP2, MAP3]
|
||||
```
|
||||
|
||||
### 2. `game/constants.ts`（修改）
|
||||
- 移除硬编码的 `PATH_WAYPOINTS` 和 `MAP_LABELS`（改为从 mapConfigs 动态读取）
|
||||
- 保留其他常量不变
|
||||
- 新增 `WAVES_PER_MAP = 5`
|
||||
|
||||
### 3. `game/GameManager.ts`（修改）
|
||||
新增字段：
|
||||
```typescript
|
||||
public difficulty: DifficultyLevel = 'normal'
|
||||
public currentMapIndex: number = 0 // 0=地图1, 1=地图2, 2=地图3
|
||||
public totalWaveCleared: number = 0 // 总计已清理波次
|
||||
```
|
||||
`reset()` 时保留 difficulty，重置其他字段。
|
||||
新增方法：`setDifficulty(d: DifficultyLevel)`
|
||||
|
||||
### 4. `game/mapRenderer.ts`（修改）
|
||||
- `buildPathTiles` 和 `PATH_TILES` 改为接受参数（不再使用全局常量）
|
||||
- `drawAllTiles` 接受 `pathTiles` 参数
|
||||
- 新增 `renderMapBackground(scene, bgKey)` — 绘制地图背景图（铺满地图区域）
|
||||
- 新增 `renderDecorations(scene, decorations, pathTiles)` — 在非路径格随机摆放装饰物
|
||||
- `getCellSize()` 不变
|
||||
|
||||
### 5. `game/enemies/WaveManager.ts`（重构）
|
||||
接受动态波次配置，而非硬编码 WAVE_CONFIG：
|
||||
```typescript
|
||||
constructor(
|
||||
scene,
|
||||
waveConfigs: WaveConfigEntry[], // 从外部传入，支持多地图
|
||||
difficultyMultiplier, // 难度倍率
|
||||
callbacks: { onWaveComplete, onAllWavesComplete, onDestroyRandomTower }
|
||||
)
|
||||
```
|
||||
难度影响：
|
||||
- `enemyCount *= multiplier.enemyCount`（向上取整）
|
||||
- 怪物创建时将速度和HP通过参数传入子类
|
||||
- Boss HP 乘以 `multiplier.bossHp`
|
||||
|
||||
### 6. `game/enemies/EnemyBase.ts`（修改）
|
||||
构造函数新增 `speedMultiplier = 1.0` 和 `hpMultiplier = 1.0` 参数（可选，默认1），子类创建时传入。
|
||||
|
||||
### 7. `game/GameScene.ts`（重构）
|
||||
支持多地图流程：
|
||||
```typescript
|
||||
private currentMapIndex = 0
|
||||
private mapConfigs = ALL_MAPS
|
||||
|
||||
// create() 时加载当前地图
|
||||
// 5波清空后：showMapClearModal → 延迟2s → loadNextMap()
|
||||
// loadNextMap()：销毁当前地图装饰物，重新 renderMapBackground/renderDecorations，重置 waveManager
|
||||
```
|
||||
|
||||
新增方法：
|
||||
- `loadMap(mapConfig: MapConfig)` — 初始化地图背景、路径、装饰物、重置 WaveManager
|
||||
- `onMapCleared()` — 5波清场后显示过关弹窗，然后切换下一张地图
|
||||
- 地图切换时：重新计算 PATH_TILES（传给 tileGraphics 重绘）、清除装饰物、加载新背景
|
||||
|
||||
### 8. `game/ui/MapTransitionModal.ts`（新建）
|
||||
地图切换过渡弹窗（Phaser DOM或Canvas Text）：
|
||||
```
|
||||
过关！人力资源部已清场
|
||||
KPI: 87% | 获得奖励: +100 HC
|
||||
[下一关：技术研发部 996福报] (3秒自动关闭)
|
||||
```
|
||||
3秒后自动关闭并触发下一张地图加载。
|
||||
|
||||
### 9. `app/page.tsx`（修改）— 主页加难度选择
|
||||
在「开始游戏」按钮前增加难度选择器（三个按钮：简单/普通/困难）：
|
||||
|
||||
```tsx
|
||||
// 选择难度后存入 localStorage，游戏页面读取
|
||||
localStorage.setItem('game-difficulty', selectedDifficulty)
|
||||
```
|
||||
|
||||
难度卡片设计：
|
||||
- 简单：绿色 — "带薪摸鱼，准点下班"
|
||||
- 普通：蓝色 — "常规打工，偶有加班"
|
||||
- 困难：红色 — "地狱模式，007全开"
|
||||
|
||||
### 10. `app/game/page.tsx`（修改）
|
||||
`useEffect` 初始化时从 localStorage 读取难度，通过 `window.__gameDifficulty` 传给场景。
|
||||
|
||||
## 注意事项
|
||||
- 每张地图preload对应背景图（key不同），场景重用时用 `this.textures.exists(key)` 检查避免重复加载
|
||||
- PATH_TILES 不再是模块级常量，改为每次渲染时动态计算后传参
|
||||
- `mapRenderer.ts` 导出的 `PATH_TILES` 保持向后兼容（先用地图1的配置初始化），GameScene 内部用局部变量覆盖
|
||||
- 地图背景图用 `scene.add.image(x, y, key).setDisplaySize(mapW, mapH).setDepth(-1).setOrigin(0,0)` 铺在地图区域（HUD 下方）
|
||||
- 装饰物图片 `setDisplaySize(cellW*0.7, cellH*0.7)`，`setDepth(1)`，`setAlpha(0.6)`，不影响塔的放置逻辑（只是视觉装饰）
|
||||
- 地图切换时必须 destroy 掉所有装饰物 Phaser 对象，避免内存泄漏
|
||||
|
||||
## 验收标准
|
||||
1. 主页有三个难度按钮，选中高亮，点击「开始游戏」带难度跳转
|
||||
2. 游戏开始后可见地图背景图（不是纯色格子）
|
||||
3. 装饰物（咖啡杯、电脑、桌子）散布在非路径格子上
|
||||
4. 第5波清场后弹出过关弹窗，3秒后自动切换到下一张地图
|
||||
5. 地图2路径形状与地图1不同（Z型 vs S型）
|
||||
6. 困难模式下怪物数量明显增多，Boss更频繁出现
|
||||
7. 三张地图全部通关后显示最终胜利界面
|
||||
|
||||
## 相关文件
|
||||
- 需求文档：`.docs/prd-tower-defense-game.md`
|
||||
- 设计系统：`design-system/大厂保卫战/MASTER.md`
|
||||
- 开发规范：`@rules/dev-best-practices.md`（**必须先阅读**）
|
||||
- 原子提交：`@rules/atomic-commit.md`
|
||||
|
||||
完成后按原子提交规范提交，禁止 `git add .`。
|
||||
Reference in New Issue
Block a user