StatusTypes.h

浏览该文件的文档.

#pragma once
 
// 状态（buff/debuff）系统的运行时数据类型。
//
// 术语区分：
//   Effect（效果，见 Effect.h）  — 数据驱动的"定义/模板"（伤害多少、持续多久、如何叠加……）
//   Status（状态，本文件）        — Effect 被施加到某个 RPGActor 后产生的"运行时实例"
//   Buff                          — 与 Status 同义的游戏侧称呼；API 同时提供 applyBuff 等别名
//
// 一个 EffectDefinition 可以同时被多个 actor、多次实例化为独立的 StatusInstance。
 
#include <string>
#include <unordered_map>
#include <utility>
#include <vector>
 
namespace eve::rpg {
 
struct StatusInstance {
    int instanceId = 0;
    std::string effectId;
    std::string source;  
    int stacks = 1;
    float remaining = -1.f;  
    float periodAccum = 0.f;  
 
    std::vector<std::pair<std::string, std::string>> appliedModifiers;
 
    std::unordered_map<std::string, std::string> props;
};
 
struct StatusTickEvent {
    class RPGActor *actor = nullptr;
    int instanceId = 0;
    std::string effectId;
    std::string source;
    int stacks = 1;
};
 
struct StatusChangeEvent {
    class RPGActor *actor = nullptr;
    int instanceId = 0;
    std::string effectId;
    std::string source;
    std::string action;
    int stacks = 0;
    std::string reason;  
};
 
}  // namespace eve::rpg