AttributeSystem.h

浏览该文件的文档.

#pragma once
 
// 属性系统：面向 RPGActor 的操作入口 + 自定义 op 注册表。
//
// 灵活性/可定制点：
//  - 属性名是任意字符串，无需预先声明。
//  - 内置 op（add / mulAdd / mulMul / override / clampMin / clampMax）覆盖常见需求；
//    通过 registerOp() 可以在 C++ 侧注册任意自定义运算（例如"取当前生命百分比的平方"），
//    脚本侧只需按约定的字符串名字引用即可，无需重新编译引擎。
 
#include "rpg/AttributeTypes.h"
 
#include <functional>
#include <string>
#include <unordered_map>
 
namespace eve::rpg {
 
class RPGActor;
 
class AttributeOpTable {
public:
    using Fn = std::function<double(double current, double value)>;
 
    void registerOp(const std::string &name, Fn fn);
    void unregisterOp(const std::string &name);
    bool has(const std::string &name) const;
    double apply(const std::string &name, double current, double value) const;
 
private:
    std::unordered_map<std::string, Fn> ops_;
};
 
class AttributeSystem {
public:
    static AttributeOpTable &customOps();
 
    static void setBase(RPGActor *actor, const std::string &attribute, double value);
    static double getBase(RPGActor *actor, const std::string &attribute);
 
    static void modifyBase(RPGActor *actor, const std::string &attribute, double delta);
 
    static bool hasAttribute(RPGActor *actor, const std::string &attribute);
 
    static std::string addModifier(RPGActor *actor, const std::string &attribute,
                                    const std::string &source, const std::string &op,
                                    double value, int priority = 0);
 
    static bool removeModifier(RPGActor *actor, const std::string &attribute,
                                const std::string &modifierId);
 
    static int removeModifiersBySource(RPGActor *actor, const std::string &attribute,
                                        const std::string &source);
 
    static int removeAllModifiersBySource(RPGActor *actor, const std::string &source);
 
    static double getFinal(RPGActor *actor, const std::string &attribute);
 
    static void invalidate(RPGActor *actor, const std::string &attribute);
 
private:
    static std::string nextModifierId();
};
 
}  // namespace eve::rpg