2048游戏开发工具

# PROJECT_STRUCTURE.md

## 游戏概述
**游戏类型**: 2048变体 - 数字合成消除游戏
**平台**: iOS + Android
**核心玩法**: 滑动合并相同数字，达到目标分数
**变现**: 激励广告 + 去广告内购

## Unity项目设置
- Unity版本: 2022.3 LTS
- 渲染管线: URP
- 输入系统: New Input System
- 架构模式: MVC

## 文件夹结构
Assets/
├── _Project/
│   ├── Scripts/
│   │   ├── Core/          # 核心游戏逻辑
│   │   ├── UI/            # UI控制器
│   │   ├── Managers/      # 单例管理器
│   │   ├── Data/          # 数据模型和SO
│   │   └── Utilities/     # 工具类
│   ├── Prefabs/
│   ├── Scenes/
│   ├── Materials/
│   ├── Audio/
│   └── Resources/
├── Plugins/               # 第三方插件
└── TextMesh Pro/

# TECH_SPECS.md

## 编码规范
- 命名: PascalCase类/方法, camelCase私有字段, _camelCase序列化字段
- 注释: 所有public方法必须有XML注释
- 架构: 使用事件系统解耦，避免GetComponent在Update

## 性能要求
- 目标帧率: 60 FPS
- 内存限制: < 150MB
- 启动时间: < 3秒

## 必用组件
- DOTween: 动画补间
- Unity Ads: 广告变现
- TextMesh Pro: 文本渲染

## Git忽略规则
.gitignore包含: Library/, Temp/, Logs/, UserSettings/

我正在用Unity 2022.3 LTS开发一款2048变体手游。请按照以下步骤初始化项目：

## 项目背景
参考文档：@PROJECT_STRUCTURE.md @TECH_SPECS.md

## 立即执行任务
1. 创建完整的文件夹结构（如PROJECT_STRUCTURE.md所示）
2. 生成核心管理器基类：
   - GameManager.cs（单例，游戏状态机）
   - AudioManager.cs（音效/音乐管理）
   - UIManager.cs（UI栈管理）
   - DataManager.cs（存档/配置）

3. 每个管理器需要：
   - 单例模式（线程安全）
   - XML文档注释
   - 基础事件系统
   - 初始化/清理方法

4. 创建游戏状态枚举：
   public enum GameState { MainMenu, Playing, Paused, GameOver, Loading }

请逐个生成完整代码，每个文件包含完整命名空间和using语句。

现在开发2048游戏的核心逻辑。参考 @TECH_SPECS.md 的性能要求。

## 需要生成的脚本

### 1. GridSystem.cs
- 4x4网格数据结构（使用int[,]数组）
- 方法：InitializeGrid(), GetTile(x,y), SetTile(x,y,value)
- 空格检测：HasEmptySpace()
- 可合并检测：CanMerge()

### 2. TileController.cs (MonoBehaviour)
- 属性：int value, Vector2Int gridPosition
- 方法：SetValue(), AnimateMove(target), AnimateMerge(), AnimateSpawn()
- 使用DOTween实现动画（duration 0.2s, Ease.OutQuad）

### 3. InputHandler.cs
- 使用New Input System
- 检测滑动方向（上下左右）
- 触摸灵敏度：50像素最小距离
- 事件：OnSwipe(Vector2Int direction)

### 4. MoveProcessor.cs
- ProcessMove(direction) 处理一次滑动
- 瓦片移动逻辑（先移动再合并）
- 返回：移动的瓦片列表 + 得分增量
- 算法要高效，避免重复遍历

### 5. ScoreSystem.cs
- 当前分数、最高分、连击数
- CalculateScore(mergedValue, comboCount)
- 事件：OnScoreChanged, OnNewHighScore

要求：
- 所有类都要有详细注释
- 性能优化：对象池复用TileController
- 使用UnityEvent解耦
- 代码遵循 @TECH_SPECS.md 规范

开发游戏UI系统。参考 @PROJECT_STRUCTURE.md 的UI文件夹结构。

## 需要的UI脚本

### 1. BasePanel.cs（抽象基类）
- 方法：Show(), Hide(), OnShow(), OnHide()
- 使用CanvasGroup控制显示（alpha + interactable）
- DOTween渐入渐出动画

### 2. MainMenuPanel.cs : BasePanel
- 按钮：开始游戏、继续游戏、设置、商店
- 显示最高分
- 检查是否有存档决定"继续"按钮状态

### 3. GameplayPanel.cs : BasePanel
- 实时显示：当前分数、最高分、移动次数
- 按钮：暂停、撤销（可选）
- 连击特效文字（"Great!" "Perfect!" "Combo x3"）

### 4. PausePanel.cs : BasePanel
- 半透明背景（Color 0,0,0,180）
- 按钮：继续、重新开始、主菜单
- 显示当前游戏统计

### 5. GameOverPanel.cs : BasePanel
- 显示最终分数、最高分、评价星级
- 按钮：看广告重生、重新开始、分享
- 星级计算逻辑（1000分=1星，2000=2星，4000=3星）

### 6. UIManager.cs 扩展
- PanelStack管理（后进先出）
- ShowPanel<T>(), HidePanel<T>(), HideAllPanels()
- 面板转场动画

要求：
- 所有UI使用TextMesh Pro
- 按钮添加音效触发
- 使用对象池优化特效文字
- 响应式布局（支持不同分辨率）

实现存档和数据持久化系统。参考 @TECH_SPECS.md。

## 需要生成

### 1. GameData.cs（可序列化数据类）
```csharp
[System.Serializable]
public class GameData
{
    public int highScore;
    public int currentScore;
    public int[,] gridState;
    public int moveCount;
    public long lastPlayTime; // Unix时间戳
    public bool soundEnabled;
    public bool musicEnabled;
    public bool adsRemoved;
}

public static class SaveKeys
{
    public const string GAME_DATA = "GameData";
    public const string HIGH_SCORE = "HighScore";
    public const string SOUND_ENABLED = "Sound";
    public const string MUSIC_ENABLED = "Music";
}

### 2.5 广告和内购 Prompt

// 功能需求：
- 初始化Unity Ads（测试模式）
- ShowRewardedAd(Action<bool> callback) // 激励广告
- ShowInterstitialAd() // 插屏广告
- IsRewardedAdReady() // 检查广告是否准备好
- 广告频率控制（关卡间隔显示插屏）

// 产品ID定义
public static class ProductIDs
{
    public const string REMOVE_ADS = "com.yourgame.removeads";
    public const string COIN_PACK_SMALL = "com.yourgame.coins100";
}

// 功能：
- 初始化IAP（Unity IAP）
- PurchaseProduct(string productID, Action<bool> callback)
- RestorePurchases()
- HasPurchased(string productID) // 检查是否已购买

// 整合广告和内购的高层逻辑
- ShowRewardedAdForContinue() // 游戏结束看广告重生
- ShowRewardedAdForHint() // 看广告获得提示
- CheckAdsRemoved() // 是否移除广告
- TrackAdRevenue() // 广告收入追踪（集成后）

### 2.6 音效系统 Prompt

public static class SoundNames
{
    // SFX
    public const string BUTTON_CLICK = "btn_click";
    public const string TILE_MOVE = "tile_move";
    public const string TILE_MERGE = "tile_merge";
    public const string SCORE_UP = "score_up";
    public const string GAME_OVER = "game_over";
    
    // Music
    public const string MENU_MUSIC = "music_menu";
    public const string GAME_MUSIC = "music_game";
}

### 2.7 特效和视觉反馈 Prompt

// 粒子效果池管理
- PlayEffect(string effectName, Vector3 position)
- 特效类型：
  * merge_particle（合并时爆炸）
  * score_particle（得分文字飘动）
  * spawn_particle（新瓦片生成）
  * clear_particle（清除特效）

// 视觉/触觉反馈
- CameraShake(float intensity, float duration) // 相机震动
- HapticFeedback(HapticType type) // 手机震动
- FlashEffect(Color color) // 屏幕闪光
- SlowMotion(float duration, float scale) // 慢动作

// 高级动画
- PunchScale() // 弹性缩放
- Rainbow() // 彩虹色过渡（高分瓦片）
- Glow() // 发光效果
- TrailEffect() // 移动拖尾

// 连击特效
- ShowComboText(int combo, Vector3 position)
  * combo 2-3: "Good!"
  * combo 4-5: "Great!"
  * combo 6-7: "Awesome!"
  * combo 8+: "PERFECT!"
- ComboMultiplier动画（x2, x3显示）

---

## 🔄 第三步：迭代优化 Prompt

### 3.1 性能优化

### 3.2 代码审查

---

## 🚀 第四步：一键部署 Prompt

### 4.1 打包配置

// 自动化打包配置
- SetupIOSBuild() // iOS设置
  * Bundle ID
  * 版本号
  * 签名配置
  * Info.plist配置
  
- SetupAndroidBuild() // Android设置
  * Package Name
  * 版本号（versionCode + versionName）
  * Keystore配置
  * AndroidManifest权限

- BuildGame(BuildTarget target, string path)
  * 自动选择场景
  * 压缩设置
  * 剥离引擎代码

public static class GameVersion
{
    public const string VERSION = "1.0.0";
    public const int BUILD_NUMBER = 1;
    public const string BUNDLE_ID = "com.yourstudio.2048pro";
}

---

## 📱 第五步：测试和调试 Prompt

### 5.1 单元测试生成

### 5.2 调试工具

---

## 💡 第六步：AI辅助内容生成 Prompt

### 6.1 关卡数据生成

{
  "levels": [
    {
      "id": 1,
      "targetScore": 1000,
      "maxMoves": 50,
      "initialTiles": [
        {"x": 0, "y": 0, "value": 2},
        {"x": 1, "y": 1, "value": 2}
      ],
      "difficulty": "easy",
      "starThresholds": [800, 1000, 1200]
    }
  ]
}

### 6.2 文案生成

{
  "ui.button.start": {
    "zh": "开始游戏",
    "en": "Start Game",
    "ja": "ゲーム開始",
    "ko": "게임 시작"
  }
}

---

## 🎨 第七步：美术资源 AI 生成指令

### 7.1 UI图标生成（Midjourney/DALL-E）

### 7.2 音效生成（Eleven Labs/AIVA）

---

## 🔥 全自动开发超级 Prompt（直接复制使用）

```markdown
# 🎮 2048 游戏全自动开发任务

你是Unity高级开发专家。我需要你完全自动化开发一款2048变体手游。

## 项目上下文
- 游戏类型：2048数字合成益智游戏
- 平台：iOS + Android
- Unity版本：2022.3 LTS
- 架构：MVC + 事件驱动
- 参考文档：@PROJECT_STRUCTURE.md @TECH_SPECS.md

## 自动执行步骤

### Phase 1: 项目初始化（5分钟）
1. 创建完整文件夹结构
2. 生成所有管理器基类（GameManager, UIManager, AudioManager, DataManager）
3. 创建核心数据结构和枚举
4. 设置Git仓库和.gitignore

### Phase 2: 核心玩法（30分钟）
1. 实现GridSystem（4x4网格逻辑）
2. 实现TileController（瓦片显示和动画）
3. 实现InputHandler（滑动检测）
4. 实现MoveProcessor（移动和合并算法）
5. 实现ScoreSystem（计分系统）
6. 对象池优化

### Phase 3: UI系统（20分钟）
1. 实现所有UI面板（MainMenu, Gameplay, Pause, GameOver）
2. UI动画和转场效果
3. 响应式布局适配

### Phase 4: 数据持久化（10分钟）
1. 实现SaveLoadSystem
2. 实现自动存档
3. 配置管理

### Phase 5: 变现系统（15分钟）
1. 集成Unity Ads框架
2. 实现AdsManager
3. 实现IAPManager
4. 广告展示逻辑

### Phase 6: 音效和特效（15分钟）
1. 完善AudioManager
2. 实现ParticleManager
3. 实现FeedbackController
4. 连击特效

### Phase 7: 打包和优化（10分钟）
1. 性能优化（对象池、GC优化）
2. 打包配置
3. 生成Build脚本

### Phase 8: 内容生成（10分钟）
1. 生成100关配置JSON
2. 生成本地化文案
3. 生成测试数据

## 执行要求
- 每个文件都要完整可运行，包含所有using和命名空间
- 遵循C#最佳实践和Unity规范
- 所有public方法都要有XML注释
- 关键逻辑添加性能优化注释
- 代码要优雅、可读、可维护

## 输出格式
每完成一个Phase，输出：
1. 生成的文件清单
2. 关键代码片段
3. 使用说明
4. 潜在问题和解决方案

现在立即开始 Phase 1！