Skill.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
// 技能系统：数据驱动的 SkillDefinition（消耗、冷却、读条时间、命中后授予的效果……）。
//
// 灵活性/可定制点：
//  - targetType 是自由字符串（"self"/"single"/"area"/... 或游戏自定义值），
//    引擎不解释其含义——具体的目标选取逻辑完全由脚本/游戏代码实现，
//    SkillSystem 只负责冷却/消耗/读条与授予效果的通用流程。
//  - extra 字段是任意 string->string 的自定义数据（动画名、投射物速度……），
//    不需要为每个新技能特性修改引擎结构体。
//  - 消耗使用 common/resource 的 CostSpec，可以是内建的 "mana"，也可以是
//    任何自定义资源；RPG 不再维护一份私有 Cost 类型。
 
#include "common/ResourceAccount.h"
#include "decision/Condition.h"
#include "definitions/Definitions.h"
 
#include <optional>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::rpg {
 
struct SkillDefinition {
    std::string id;
    float cooldown = 0.f;
    float castTime = 0.f;  
    std::string targetType = "self";
    std::optional<eve::resource::CostSpec> cost;
    std::vector<std::string> grantedEffects;  
    std::vector<std::string> tags;
    eve::decision::Condition                     castCondition;
    std::unordered_map<std::string, std::string> extra;  
 
    bool hasTag(const std::string &tag) const;
};
 
class EVENGINE_API_PLATFORM SkillRegistry {
public:
    [[nodiscard]] static eve::definitions::DefinitionRegistry &definitionRegistry();
 
    static void registerSkill(const SkillDefinition &def);
    static const SkillDefinition *find(const std::string &id);
    static bool remove(const std::string &id);
    static void clear();
    static int count();
 
    static int loadFromJson(const std::string &json, std::string *error = nullptr);
};
 
}  // namespace eve::rpg