Files
tcg-client/Assets/TcgEngine/Docs/TaskConfigurations.md
2025-09-02 16:58:21 +08:00

115 lines
3.1 KiB
Markdown

# 任务配置文件结构说明
## 概述
任务配置文件定义了游戏中可用的各种任务。每个任务都有特定的条件和奖励。
## 配置字段说明
| 字段名 | 类型 | 必需 | 描述 |
|--------|------|------|------|
| id | string | 是 | 任务唯一标识符 |
| name | string | 是 | 任务显示名称 |
| desc | string | 是 | 任务描述 |
| condition | int | 是 | 任务条件类型 (参考TaskConditionType枚举) |
| value1 | int | 是 | 任务目标值 |
| value2 | string | 否 | 条件参数2 (根据任务类型可能需要) |
| value3 | string | 否 | 条件参数3 (根据任务类型可能需要) |
| rewardTypes | int[] | 是 | 奖励类型数组 (参考TaskRewardType枚举) |
| rewardNums | int[] | 是 | 奖励数量数组 (与rewardTypes一一对应) |
| isDailyTask | boolean | 是 | 是否为每日任务 |
| durationHours | int | 是 | 任务持续时间(小时) |
## 任务类型详解
### 1. 登录任务 (LoginGame - 1)
- **描述**: 玩家登录游戏即可完成
- **value1**: 无意义 (通常为1)
- **value2/value3**: 不使用
### 2. 对战任务 (PlayGames - 2)
- **描述**: 完成指定场次的游戏对战
- **value1**: 需要完成的对战场次
- **value2/value3**: 不使用
### 3. 胜利任务 (WinGames - 3)
- **描述**: 获得指定场次的对战胜利
- **value1**: 需要获得胜利的场次
- **value2/value3**: 不使用
### 4. 击败英雄任务 (DefeatHeroWithAttributes - 4)
- **描述**: 击败指定阵营的英雄
- **value1**: 需要击败的英雄数量
- **value2**: 第一个目标阵营 (如 "YiYongJun")
- **value3**: 第二个目标阵营 (如 "DiGuoJun")
### 5. 召唤英雄任务 (SummonHeroWithAttributes - 5)
- **描述**: 召唤指定阵营的英雄
- **value1**: 需要召唤的英雄数量
- **value2**: 第一个目标阵营 (如 "WangGuoJun")
- **value3**: 第二个目标阵营 (如 "ZiYouRen")
### 6. 使用技能任务 (UseHeroSkillWithAttributes - 6)
- **描述**: 使用指定阵营英雄的技能
- **value1**: 需要使用的技能次数
- **value2**: 第一个目标阵营 (如 "ShouQun")
- **value3**: 第二个目标阵营 (如 "XieMo")
## 奖励类型
### 金币奖励 (Coins - 0)
- **描述**: 给予玩家指定数量的金币
- **rewardNums**: 金币数量
## 示例配置文件
### 登录任务示例
```json
{
"id": "login_task_1",
"name": "每日登录",
"desc": "每日登录游戏",
"condition": 1,
"value1": 1,
"value2": "",
"value3": "",
"rewardTypes": [0],
"rewardNums": [100],
"isDailyTask": true,
"durationHours": 24
}
```
### 胜利任务示例
```json
{
"id": "win_task_1",
"name": "胜利之路",
"desc": "获得3场对战胜利",
"condition": 3,
"value1": 3,
"value2": "",
"value3": "",
"rewardTypes": [0],
"rewardNums": [200],
"isDailyTask": true,
"durationHours": 24
}
```
### 击败英雄任务示例
```json
{
"id": "defeat_hero_task_1",
"name": "阵营克星",
"desc": "击败5个义勇军或帝国军英雄",
"condition": 4,
"value1": 5,
"value2": "YiYongJun",
"value3": "DiGuoJun",
"rewardTypes": [0],
"rewardNums": [300],
"isDailyTask": true,
"durationHours": 24
}
```