Damage.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "action/Action.h"
#include "common/Result.h"
#include "common/SubjectRef.h"
#include "settlement/Settlement.h"
#include "settlement/SettlementRules.h"
 
#include <optional>
#include <string>
 
namespace eve::combat {
 
struct Impulse3 {
    double x = 0.0;
    double y = 0.0;
    double z = 0.0;
};
 
enum class HitReaction : std::uint8_t { None, Flinch, Stagger, Knockdown, Death };
 
enum class DamageRuleSource : std::uint8_t { Default, Provider };
 
struct EVENGINE_API_BACKENDS CombatState {
    SubjectRef subject;
    double     health    = 0.0;
    double     maxHealth = 0.0;
    double     poise     = 0.0;
    double     maxPoise  = 0.0;
 
    [[nodiscard]] Result<void> validate() const;
};
 
struct DamageRequest {
    SubjectRef                               source;
    SubjectRef                               target;
    std::optional<action::ActionExecutionId> actionExecution;
    std::string                              damageType;
    double                                   healthDamage = 0.0;
    double                                   poiseDamage  = 0.0;
    double                                   incomingDamageMultiplier = 1.0;
    double                                   availableShield = 0.0;
    Impulse3                                 knockback;
 
    [[nodiscard]] Result<void> validate() const;
};
 
struct DamageAmounts {
    double healthDamage   = 0.0;
    double poiseDamage    = 0.0;
    double knockbackScale = 1.0;
};
 
class IDamageRule {
public:
    virtual ~IDamageRule() = default;
    [[nodiscard]] virtual Result<DamageAmounts> evaluate(const DamageRequest& request,
                                                         const CombatState&   target) const = 0;
};
 
struct HitReactionPolicy {
    double flinchDamageThreshold = 0.0;
    double staggerPoiseFraction  = 0.5;
 
    [[nodiscard]] Result<void> validate() const;
};
 
struct DamageOutcome {
    SubjectRef       source;
    SubjectRef       target;
    double           previousHealth      = 0.0;
    double           health              = 0.0;
    double           previousPoise       = 0.0;
    double           poise               = 0.0;
    double           appliedHealthDamage = 0.0;
    double           appliedPoiseDamage  = 0.0;
    double           absorbedShieldDamage = 0.0;
    Impulse3         knockback;
    HitReaction      reaction   = HitReaction::None;
    DamageRuleSource ruleSource = DamageRuleSource::Default;
    settlement::SettlementRequest settlementRequest;
    settlement::SettlementResult settlementResult;
};
 
class EVENGINE_API_BACKENDS DamageRuntime {
public:
    explicit DamageRuntime(const IDamageRule* rule = nullptr, HitReactionPolicy policy = {})
        : rule_(rule), policy_(policy) {}
 
    [[nodiscard]] Result<void> configureSettlementRules(const settlement::SettlementRuleSet& rules);
 
    [[nodiscard]] Result<DamageAmounts> preview(const CombatState& target, const DamageRequest& request) const;
    [[nodiscard]] Result<DamageOutcome> previewSettlement(const CombatState& target,
                                                          const DamageRequest& request) const;
    [[nodiscard]] Result<DamageOutcome> apply(CombatState& target, const DamageRequest& request) const;
    [[nodiscard]] Result<settlement::SettlementResult> heal(CombatState& target, SubjectRef source,
                                                             double amount) const;
    [[nodiscard]] Result<double> recoverPoise(CombatState& target, double amount) const;
 
private:
    const IDamageRule*             rule_ = nullptr;
    HitReactionPolicy              policy_;
    settlement::SettlementPipeline settlement_;
};
 
}  // namespace eve::combat