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

3.1 KiB

任务配置文件结构说明

概述

任务配置文件定义了游戏中可用的各种任务。每个任务都有特定的条件和奖励。

配置字段说明

字段名 类型 必需 描述
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: 金币数量

示例配置文件

登录任务示例

{
  "id": "login_task_1",
  "name": "每日登录",
  "desc": "每日登录游戏",
  "condition": 1,
  "value1": 1,
  "value2": "",
  "value3": "",
  "rewardTypes": [0],
  "rewardNums": [100],
  "isDailyTask": true,
  "durationHours": 24
}

胜利任务示例

{
  "id": "win_task_1",
  "name": "胜利之路",
  "desc": "获得3场对战胜利",
  "condition": 3,
  "value1": 3,
  "value2": "",
  "value3": "",
  "rewardTypes": [0],
  "rewardNums": [200],
  "isDailyTask": true,
  "durationHours": 24
}

击败英雄任务示例

{
  "id": "defeat_hero_task_1",
  "name": "阵营克星",
  "desc": "击败5个义勇军或帝国军英雄",
  "condition": 4,
  "value1": 5,
  "value2": "YiYongJun",
  "value3": "DiGuoJun",
  "rewardTypes": [0],
  "rewardNums": [300],
  "isDailyTask": true,
  "durationHours": 24
}