RPGActor.h

浏览该文件的文档.

#pragma once
 
#include "common/ECS.h"
#include "rpg/AttributeTypes.h"
#include "rpg/StatusTypes.h"
#include "rpg/SkillTypes.h"
 
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::rpg {
 
class RPGActor : public ecs::Entity {
public:
    ENTITY(RPGActor, ecs::Entity)
 
    void release() override { ecs::DestroyEntity(this); }
 
    struct Attributes {
        std::unordered_map<std::string, AttributeValue> values;
    };
 
    struct Statuses {
        std::vector<StatusInstance> active;
        int nextInstanceId = 1;
    };
 
    struct Skills {
        std::unordered_map<std::string, SkillRuntime> known;
        CastingState casting;
    };
 
    COMPONENT(Attributes, attributes)
    COMPONENT(Statuses, statuses)
    COMPONENT(Skills, skills)
 
    
    static RPGActor *createActor();
 
    void setBaseAttribute(const std::string &attribute, double value);
    double getBaseAttribute(const std::string &attribute);
    void modifyBaseAttribute(const std::string &attribute, double delta);
    bool hasAttribute(const std::string &attribute);
    std::string addAttributeModifier(const std::string &attribute, const std::string &source,
                                      const std::string &op, double value, int priority = 0);
    bool removeAttributeModifier(const std::string &attribute, const std::string &modifierId);
    int removeAttributeModifiersBySource(const std::string &attribute, const std::string &source);
    int removeAllAttributeModifiersBySource(const std::string &source);
    double getFinalAttribute(const std::string &attribute);
 
    int applyEffect(const std::string &effectId, const std::string &source = "");
    bool removeStatus(int instanceId);
    int removeStatusByEffect(const std::string &effectId);
    int removeStatusBySource(const std::string &source);
    int removeStatusByTag(const std::string &tag);
    bool hasEffect(const std::string &effectId);
    bool hasStatusTag(const std::string &tag);
    int getStatusCount();
    std::string getStatusEffectId(int index);
    int getStatusStacks(int index);
    float getStatusRemaining(int index);
    int getStatusInstanceId(int index);
    std::string getStatusSource(int index);
    std::string getStatusProp(int instanceId, const std::string &key,
                              const std::string &fallback = {});
    bool setStatusProp(int instanceId, const std::string &key, const std::string &value);
 
    int applyBuff(const std::string &effectId, const std::string &source = "");
    bool removeBuff(int instanceId);
    int removeBuffByEffect(const std::string &effectId);
    int removeBuffBySource(const std::string &source);
    int removeBuffByTag(const std::string &tag);
    bool hasBuff(const std::string &effectId);
    bool hasBuffTag(const std::string &tag);
    int getBuffCount();
    std::string getBuffEffectId(int index);
    int getBuffStacks(int index);
    float getBuffRemaining(int index);
    int getBuffInstanceId(int index);
    std::string getBuffSource(int index);
    std::string getBuffProp(int instanceId, const std::string &key,
                            const std::string &fallback = {});
    bool setBuffProp(int instanceId, const std::string &key, const std::string &value);
 
    void learnSkill(const std::string &skillId);
    bool knowsSkill(const std::string &skillId);
    bool forgetSkill(const std::string &skillId);
    float getSkillCooldown(const std::string &skillId);
    void setSkillCooldown(const std::string &skillId, float seconds);
    bool canCastSkill(const std::string &skillId);
    std::string canCastSkillReason(const std::string &skillId);
    bool beginCastSkill(const std::string &skillId, RPGActor *target = nullptr);
    void cancelCastSkill();
    bool isCastingSkill();
    std::string getCastingSkillId();
    float getCastProgress();
 
    static const std::vector<RPGActor *> &liveActors();
};
 
}  // namespace eve::rpg