SkillSystem.h

浏览该文件的文档.

#pragma once
 
// 技能释放流程：冷却 / 消耗 / 读条 / 授予效果。
//
// 可定制点：registerCastCondition() 允许 C++ 侧插入任意额外的"能否释放"判断
// （例如"沉默状态不能施法"），无需修改 SkillSystem 本身——引擎不内置任何
// 状态互斥概念（沉默/眩晕等完全是游戏自定义的 tag/effect）。
 
#include "rpg/SkillTypes.h"
 
#include <functional>
#include <string>
#include <vector>
 
namespace eve::rpg {
 
class RPGActor;
struct SkillDefinition;
 
class SkillSystem {
public:
    using CastCondition =
        std::function<bool(RPGActor *actor, const SkillDefinition &def, std::string &outReason)>;
 
    static void registerCastCondition(const std::string &name, CastCondition fn);
    static void unregisterCastCondition(const std::string &name);
    static void clearCastConditions();
 
    static void learn(RPGActor *actor, const std::string &skillId);
    static bool knows(RPGActor *actor, const std::string &skillId);
    static bool forget(RPGActor *actor, const std::string &skillId);
 
    static float getCooldownRemaining(RPGActor *actor, const std::string &skillId);
    static void setCooldownRemaining(RPGActor *actor, const std::string &skillId, float seconds);
 
    static bool canCast(RPGActor *actor, const std::string &skillId, std::string *reason = nullptr);
 
    static bool beginCast(RPGActor *actor, const std::string &skillId, RPGActor *target = nullptr,
                           std::string *reason = nullptr);
 
    static void cancelCast(RPGActor *actor);
 
    static bool isCasting(RPGActor *actor);
    static std::string getCastingSkillId(RPGActor *actor);
    static float getCastProgress(RPGActor *actor);  
 
    static void update(float dt);
 
    static void pollCastEvents(std::vector<SkillCastEvent> &out);
};
 
}  // namespace eve::rpg