TacticsBattle.h

浏览该文件的文档.

#pragma once
 
#include "tactics/TacticsTypes.h"
#include "tactics/TacticsPath.h"
 
#include <cstddef>
#include <vector>
 
#include "common/Export.h"
 
namespace eve::tactics {
 
struct MoveReceipt {
    SubjectRef        actor;
    std::vector<Cell> path;
    int               cost                = 0;
    int               remainingMovePoints = 0;
};
 
struct AbilityReceipt {
    SubjectRef actor;
    LogicalId  action;
    SubjectRef targetUnit;
    Cell       targetCell;
    int        remainingActionPoints = 0;
};
 
class EVENGINE_API_DOMAINS BattleSystem final {
public:
    [[nodiscard]] static Result<void> addSide(Battle& battle, ecs::EntityHandle side);
 
    [[nodiscard]] static Result<void> addUnit(Battle& battle, ecs::EntityHandle unit, ecs::EntityHandle side,
                                              Cell cell);
 
    [[nodiscard]] static Result<void> start(Battle& battle, std::string policyId);
 
    [[nodiscard]] static Result<BattlePhase> advance(Battle& battle, const SimulationStep& step);
 
    [[nodiscard]] static Result<void> endTurn(Battle& battle, SubjectRef actor);
 
    [[nodiscard]] static Result<MoveReceipt> moveUnit(Battle& battle, SubjectRef actor, Cell destination);
    [[nodiscard]] static Result<MoveReceipt> moveUnit(Battle& battle, SubjectRef actor, Cell destination,
                                                      SimulationTick commandTick);
 
    [[nodiscard]] static Result<void> faceUnit(Battle& battle, SubjectRef actor, int facing);
    [[nodiscard]] static Result<void> faceUnit(Battle& battle, SubjectRef actor, int facing,
                                               SimulationTick commandTick);
    [[nodiscard]] static Result<void> previewFace(Battle& battle, SubjectRef actor, int facing);
 
    [[nodiscard]] static Result<void> waitUnit(Battle& battle, SubjectRef actor);
    [[nodiscard]] static Result<void> waitUnit(Battle& battle, SubjectRef actor, SimulationTick commandTick);
    [[nodiscard]] static Result<void> previewWait(Battle& battle, SubjectRef actor);
 
    [[nodiscard]] static Result<AbilityReceipt> useAbility(Battle& battle, SubjectRef actor, const LogicalId& action,
                                                           Cell targetCell, SubjectRef targetUnit = {},
                                                           std::string payload = {});
 
    [[nodiscard]] static Result<AbilityReceipt> previewAbility(Battle& battle, SubjectRef actor,
                                                               const LogicalId& action, Cell targetCell,
                                                               SubjectRef targetUnit = {},
                                                               std::string_view payload = {});
 
    [[nodiscard]] static Result<MoveReceipt> previewMove(Battle& battle, SubjectRef actor, Cell destination);
 
    [[nodiscard]] static Result<void> finish(Battle& battle);
 
    [[nodiscard]] static Result<std::size_t> openReaction(Battle& battle, std::uint64_t triggerSequence,
                                                          std::vector<ReactionCandidate> candidates);
    [[nodiscard]] static Result<ReactionReceipt> acceptReaction(Battle& battle, SubjectRef reactor,
                                                                 const LogicalId& action);
    [[nodiscard]] static Result<void> declineReaction(Battle& battle);
 
    [[nodiscard]] static Result<void> addObjective(Battle& battle, ObjectiveSpec objective);
 
    [[nodiscard]] static Result<void> defeatUnit(Battle& battle, SubjectRef unit);
 
    [[nodiscard]] static Result<std::uint64_t> roll(Battle& battle, const LogicalId& stream);
 
private:
    [[nodiscard]] static Result<std::vector<ecs::EntityHandle>> orderedUnits(Battle& battle);
};
 
}  // namespace eve::tactics