# FormationFive

**Repository Path**: chi-wq/FormationFive

## Basic Information

- **Project Name**: FormationFive
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 森林战歌(FormationFive) - 二次元Q版竖版5v5回合制站位对战游戏

基于 Cocos Creator 3.8.8 开发的竖版回合制对战游戏。

## 环境要求

- **Cocos Creator** 3.8.8 
- **Spine** 3.8（引擎内置 WASM 运行时）

## 快速开始

### 1. 用 Cocos Creator 3.8.8 打开项目

启动 Cocos Creator 3.8.8，点击 **打开项目** → 选择本目录。

### 2. 清理缓存（重要）

因引擎的Spine版本切换似乎有问题，首次打开或遇到 Spine 角色不显示时，请执行以下步骤：

**第一步：** 删除引擎缓存文件夹
```
editors\Creator\3.8.8\resources\resources\3d\engine\bin\.cache
```

**第二步：** 删除项目临时文件
```
（项目目录下的）temp\
```

**第三步：** 重启 Cocos Creator

引擎会自动重新生成缓存，包含 Spine 3.8 的 WASM 映射。

### 3. 运行游戏

1. 在 **资源管理器** 中依次打开场景: `Boot.scene` → `Title.scene` → `Loading.scene` → `Game.scene`
2. 默认入口为 `Boot.scene`，双击打开
3. **注意：确保当前激活的场景为 `Boot.scene`**。如果当前场景不是 `Boot.scene`，请在资源管理器中双击 `Boot.scene` 切换到该场景。
4. 点击编辑器上方的 **Play** 按钮
5. 在标题画面点击 **"⚔ 开始战斗"** 进入战斗

### 场景列表

| 场景文件 | 说明 |
|---------|------|
| `Boot.scene` | 启动场景，初始化全局管理器 |
| `Title.scene` | 标题画面，含开始战斗/规则说明/角色编辑入口 |
| `Loading.scene` | 加载场景，预加载 Spine 资源 |
| `Game.scene` | 战斗主场景 |
| `Rule.scene` | 游戏规则说明 |
| `Edit.scene` | 角色属性编辑 |


## 常见问题

### Spine 角色显示为灰色方块或不显示

执行上述 **清理缓存** 步骤即可。这是缓存问题。


## 项目结构

```
assets/
├── Scripts/
│   ├── config/
│   │   └── GameConfig.ts       # 游戏全局配置
│   ├── entities/
│   │   └── Character.ts        # 角色组件
│   ├── managers/
│   │   ├── GlobalManager.ts    # 全局资源管理器
│   │   └── BattleManager.ts    # 战斗逻辑
│   ├── scenes/
│   │   ├── BootScene.ts        # 启动
│   │   ├── TitleScene.ts       # 标题
│   │   ├── LoadingScene.ts     # 加载
│   │   ├── GameScene.ts        # 战斗
│   │   ├── RuleScene.ts        # 规则
│   │   └── EditScene.ts        # 角色编辑
│   └── ui/
│       ├── BattleUI.ts         # 战斗UI
│       └── Dialog.ts           # 通用弹窗
├── Boot.scene / Title.scene / Game.scene / ...
└── resources/
    ├── Spine/                  # Spine 角色文件
    ├── ui/                     # UI 贴图
    └── sound/                  # 音效
```