AttributeTypes.h

浏览该文件的文档.

#pragma once
 
// 属性系统的纯数据类型 + 纯函数计算核心。
//
// 设计要点（对应"高度灵活可定制化"目标）：
// 1. 属性名不是枚举，而是任意字符串 —— 新增属性无需修改引擎代码。
// 2. 修改器（modifier）的运算方式（op）同样是字符串：内置几种常见语义，
//    同时允许通过 AttributeSystem::registerOp() 注册任意自定义运算，
//    使得游戏可以在不修改引擎源码的情况下扩展全新的数值叠加规则。
// 3. computeAttributeValue() 是不依赖 ECS 的纯函数，方便单元测试与脚本外验证。
 
#include <string>
#include <vector>
 
namespace eve::rpg {
 
struct AttributeModifier {
    std::string id;      
    std::string source;  
    std::string op = "add";
    double value = 0.0;
    int priority = 0;  
};
 
struct AttributeValue {
    double base = 0.0;
    std::vector<AttributeModifier> modifiers;
    mutable double cached = 0.0;
    mutable bool dirty = true;
};
 
double computeAttributeValue(const AttributeValue &attr,
                              const struct AttributeOpTable *customOps = nullptr);
 
}  // namespace eve::rpg