StatusSystem.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
// 状态（buff/debuff）系统：把 RPG EffectDefinition 适配到通用
// effects::EffectContainer，并由 RPG executor 驱动 modifier / 周期结算。
//
// 可插拔扩展点（与 inventory 模块同风格）：
//  - registerApplyCondition  — 免疫 / 抗性 / 互斥等"能否施加"判断
//  - registerStackPolicy     — 内置 none/refresh/extend/stack 之外的自定义叠加策略
//  - registerLifecycleHook   — 施加/刷新/叠层/移除/到期时的副作用（UI、成就、VFX）
//  - EffectDefinition::extra / StatusInstance::props — 任意自定义字段无需扩结构体
 
#include "common/Result.h"
#include "rpg/StatusTypes.h"
 
#include <functional>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::rpg {
 
class RPGActor;
struct EffectDefinition;
 
class EVENGINE_API_PLATFORM StatusSystem {
public:
    using ApplyCondition = std::function<bool(RPGActor *actor, const EffectDefinition &def,
                                               const std::string &source, std::string &outReason)>;
 
    using StackPolicyFn = std::function<int(RPGActor *actor, StatusInstance &existing,
                                             const EffectDefinition &def, const std::string &source)>;
 
    using LifecycleHook = std::function<void(const StatusChangeEvent &ev)>;
 
    static void registerApplyCondition(const std::string &name, ApplyCondition fn);
    static void unregisterApplyCondition(const std::string &name);
    static bool hasApplyCondition(const std::string &name);
    static void clearApplyConditions();
 
    static void registerStackPolicy(const std::string &name, StackPolicyFn fn);
    static void unregisterStackPolicy(const std::string &name);
    static bool hasStackPolicy(const std::string &name);
    static void clearStackPolicies();
 
    static void registerLifecycleHook(const std::string &name, LifecycleHook fn);
    static void unregisterLifecycleHook(const std::string &name);
    static bool hasLifecycleHook(const std::string &name);
    static void clearLifecycleHooks();
 
    [[nodiscard]] static eve::Result<int> apply(RPGActor *actor, const std::string &effectId,
                                                const std::string &source = "");
 
    [[nodiscard]] static eve::Result<void> remove(RPGActor *actor, int instanceId);
 
    static int removeByEffect(RPGActor *actor, const std::string &effectId);
 
    static int removeBySource(RPGActor *actor, const std::string &source);
 
    static int removeByTag(RPGActor *actor, const std::string &tag);
 
    static bool hasEffect(RPGActor *actor, const std::string &effectId);
    static bool hasTag(RPGActor *actor, const std::string &tag);
    static int getActiveCount(RPGActor *actor);
    static std::string getActiveEffectId(RPGActor *actor, int index);
    static int getActiveStacks(RPGActor *actor, int index);
    static float getActiveRemaining(RPGActor *actor, int index);
    static int getActiveInstanceId(RPGActor *actor, int index);
    static std::string getActiveSource(RPGActor *actor, int index);
 
    static std::string getProp(RPGActor *actor, int instanceId, const std::string &key,
                               const std::string &fallback = {});
    static bool setProp(RPGActor *actor, int instanceId, const std::string &key,
                        const std::string &value);
 
    [[nodiscard]] static eve::Result<StatusUpdateSummary> update(double dt);
 
    static void pollTicks(std::vector<StatusTickEvent> &out);
 
    static void pollChanges(std::vector<StatusChangeEvent> &out);
 
private:
    static void emitChange(StatusChangeEvent ev);
 
    static std::unordered_map<std::string, ApplyCondition> &applyConditions();
    static std::unordered_map<std::string, StackPolicyFn> &stackPolicies();
    static std::unordered_map<std::string, LifecycleHook> &lifecycleHooks();
};
 
}  // namespace eve::rpg