Effect.h

浏览该文件的文档.

#pragma once
 
// 效果系统：数据驱动的 Effect "定义/模板"（类似 GAS 的 GameplayEffect）。
//
// 一个 EffectDefinition 描述"施加后会发生什么"，本身不含运行时状态；
// 施加到具体 actor 后由 StatusSystem 产生 StatusInstance（见 StatusTypes.h）。
//
// 灵活性/可定制点：
//  - 完全数据驱动：C++ 侧 registerEffect() 或脚本侧 loadFromJson() 均可定义新效果，
//    无需修改引擎代码；effect id、属性名、tag、op 全部是字符串。
//  - durationPolicy / stackPolicy 同样是字符串，方便未来扩展新策略而不破坏 ABI；
//    未知 stackPolicy 可走 StatusSystem::registerStackPolicy 注册的自定义策略。
//  - period > 0 的周期效果不会自动改属性，而是产生 tick 事件交给上层处理，
//    从而可以让周期伤害/治疗完整走 Settlement 结算流水线（见 Settlement.h）。
//  - extra 字段是任意 string→string 自定义数据（图标、VFX、脚本钩子名……），
//    无需为每个新效果特性修改引擎结构体。
 
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::rpg {
 
struct EffectModifierSpec {
    std::string attribute;
    std::string op = "add";
    double value = 0.0;
    int priority = 0;
};
 
struct EffectDefinition {
    std::string id;
 
    std::string durationPolicy = "instant";
    float duration = 0.f;  
 
    float period = 0.f;
 
    std::string stackPolicy = "none";
    int maxStacks = 1;
 
    std::vector<EffectModifierSpec> modifiers;
 
    std::vector<std::string> tags;
 
    std::unordered_map<std::string, std::string> extra;
 
    bool hasTag(const std::string &tag) const;
    std::string getExtra(const std::string &key, const std::string &fallback = {}) const;
};
 
class EffectRegistry {
public:
    static void registerEffect(const EffectDefinition &def);
    static const EffectDefinition *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);
 
private:
    static std::unordered_map<std::string, EffectDefinition> &table();
};
 
}  // namespace eve::rpg