Documentation: 0.5.0 (source: v0.5.0).
# combat

Markdown source of https://docs-v0-5-0.atlas-kit-docs.pages.dev/reference/combat/ — see https://docs-v0-5-0.atlas-kit-docs.pages.dev/ai/ for the full machine-readable surface.

## Interfaces

<a id="combatconfigurationsnapshot"></a>

### CombatConfigurationSnapshot

Defined in: [packages/sage/src/combat/index.ts:129](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L129)

Immutable Game combat configuration and stimulant catalog.

#### Example

```ts
declare const configuration: CombatConfigurationSnapshot;
console.log(configuration.globalCeasefire, configuration.maxFleetSize);
```

#### Extends

- `Omit`\<[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata), `"stimulantDefinitions"`\>

#### Properties

<a id="address"></a>

##### address

```ts
readonly address: Address;
```

Defined in: [packages/sage/src/combat/index.ts:134](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L134)

<a id="cargorespawntimeseconds"></a>

##### cargoRespawnTimeSeconds

```ts
readonly cargoRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:243](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L243)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`cargoRespawnTimeSeconds`](/reference/combat/#gamecombatconfigurationdata)

<a id="crewrespawntimeseconds"></a>

##### crewRespawnTimeSeconds

```ts
readonly crewRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:242](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L242)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`crewRespawnTimeSeconds`](/reference/combat/#gamecombatconfigurationdata)

<a id="globalceasefire"></a>

##### globalCeasefire

```ts
readonly globalCeasefire: boolean;
```

Defined in: [packages/sage/src/internal/c4/game.ts:237](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L237)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`globalCeasefire`](/reference/combat/#gamecombatconfigurationdata)

<a id="interactionrange"></a>

##### interactionRange

```ts
readonly interactionRange: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:238](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L238)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`interactionRange`](/reference/combat/#gamecombatconfigurationdata)

<a id="kind"></a>

##### kind

```ts
readonly kind: "combatConfiguration";
```

Defined in: [packages/sage/src/combat/index.ts:133](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L133)

<a id="lootexclusivitytimeseconds"></a>

##### lootExclusivityTimeSeconds

```ts
readonly lootExclusivityTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:239](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L239)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`lootExclusivityTimeSeconds`](/reference/combat/#gamecombatconfigurationdata)

<a id="maxfleetsize"></a>

##### maxFleetSize

```ts
readonly maxFleetSize: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:245](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L245)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`maxFleetSize`](/reference/combat/#gamecombatconfigurationdata)

<a id="maxlootrate"></a>

##### maxLootRate

```ts
readonly maxLootRate: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:240](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L240)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`maxLootRate`](/reference/combat/#gamecombatconfigurationdata)

<a id="rawshipsrespawntimeseconds"></a>

##### rawShipsRespawnTimeSeconds

```ts
readonly rawShipsRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:244](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L244)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`rawShipsRespawnTimeSeconds`](/reference/combat/#gamecombatconfigurationdata)

<a id="starbaseupgradeprogresscontinuation"></a>

##### starbaseUpgradeProgressContinuation

```ts
readonly starbaseUpgradeProgressContinuation: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:241](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L241)

###### Inherited from

[`GameCombatConfigurationData`](/reference/combat/#gamecombatconfigurationdata).[`starbaseUpgradeProgressContinuation`](/reference/combat/#gamecombatconfigurationdata)

<a id="stimulantdefinitions"></a>

##### stimulantDefinitions

```ts
readonly stimulantDefinitions: {
  definitions: readonly CombatStimulantDefinition[];
  sequenceId: number;
};
```

Defined in: [packages/sage/src/combat/index.ts:135](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L135)

###### definitions

```ts
readonly definitions: readonly CombatStimulantDefinition[];
```

###### sequenceId

```ts
readonly sequenceId: number;
```

#### Methods

<a id="tojson"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/combat/index.ts:139](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L139)

###### Returns

`unknown`

***

<a id="combatstimulantdefinition"></a>

### CombatStimulantDefinition

Defined in: [packages/sage/src/combat/index.ts:117](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L117)

One cargo-backed combat stimulant definition.

#### Example

```ts
declare const stimulant: CombatStimulantDefinition;
console.log(stimulant.cargo.name, stimulant.effects.length);
```

#### Properties

<a id="cargo"></a>

##### cargo

```ts
readonly cargo: CargoDefinitionSummary;
```

Defined in: [packages/sage/src/combat/index.ts:118](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L118)

<a id="effects"></a>

##### effects

```ts
readonly effects: readonly GameStimulantEffectData[];
```

Defined in: [packages/sage/src/combat/index.ts:119](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L119)

***

<a id="fleetcombatstatsdata"></a>

### FleetCombatStatsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:232](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L232)

Translated Fleet combat statistics.

#### Example

```ts
declare const stats: FleetCombatStatsData;
const hitPoints = stats.hp;
```

#### Properties

<a id="aimability"></a>

##### aimAbility

```ts
readonly aimAbility: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:273](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L273)

<a id="ammoconsumptionrate"></a>

##### ammoConsumptionRate

```ts
readonly ammoConsumptionRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:236](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L236)

<a id="ap"></a>

##### ap

```ts
readonly ap: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:233](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L233)

<a id="apregenrate"></a>

##### apRegenRate

```ts
readonly apRegenRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:237](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L237)

<a id="counterdecoy"></a>

##### counterDecoy

```ts
readonly counterDecoy: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:262](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L262)

<a id="counterenergycapacitor"></a>

##### counterEnergyCapacitor

```ts
readonly counterEnergyCapacitor: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:263](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L263)

<a id="counterfaradayshielding"></a>

##### counterFaradayShielding

```ts
readonly counterFaradayShielding: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:270](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L270)

<a id="counterfiresuppressor"></a>

##### counterFireSuppressor

```ts
readonly counterFireSuppressor: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:264](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L264)

<a id="counterflare"></a>

##### counterFlare

```ts
readonly counterFlare: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:265](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L265)

<a id="counterhealingnanobots"></a>

##### counterHealingNanobots

```ts
readonly counterHealingNanobots: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:266](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L266)

<a id="countermine"></a>

##### counterMine

```ts
readonly counterMine: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:267](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L267)

<a id="counternegativeremplating"></a>

##### counterNegativeRemPlating

```ts
readonly counterNegativeRemPlating: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:268](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L268)

<a id="counterwarmingplates"></a>

##### counterWarmingPlates

```ts
readonly counterWarmingPlates: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:269](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L269)

<a id="critchance"></a>

##### critChance

```ts
readonly critChance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:274](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L274)

<a id="critmultiplier"></a>

##### critMultiplier

```ts
readonly critMultiplier: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:275](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L275)

<a id="damagebomb"></a>

##### damageBomb

```ts
readonly damageBomb: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:260](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L260)

<a id="damagebombvariance"></a>

##### damageBombVariance

```ts
readonly damageBombVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:261](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L261)

<a id="damageemp"></a>

##### damageEmp

```ts
readonly damageEmp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:250](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L250)

<a id="damageempvariance"></a>

##### damageEmpVariance

```ts
readonly damageEmpVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:251](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L251)

<a id="damageenergy"></a>

##### damageEnergy

```ts
readonly damageEnergy: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:248](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L248)

<a id="damageenergyvariance"></a>

##### damageEnergyVariance

```ts
readonly damageEnergyVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:249](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L249)

<a id="damagegraygoo"></a>

##### damageGraygoo

```ts
readonly damageGraygoo: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:256](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L256)

<a id="damagegraygoovariance"></a>

##### damageGraygooVariance

```ts
readonly damageGraygooVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:257](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L257)

<a id="damageheat"></a>

##### damageHeat

```ts
readonly damageHeat: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:258](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L258)

<a id="damageheatvariance"></a>

##### damageHeatVariance

```ts
readonly damageHeatVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:259](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L259)

<a id="damagekinetic"></a>

##### damageKinetic

```ts
readonly damageKinetic: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:246](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L246)

<a id="damagekineticvariance"></a>

##### damageKineticVariance

```ts
readonly damageKineticVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:247](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L247)

<a id="damageshockwave"></a>

##### damageShockwave

```ts
readonly damageShockwave: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:254](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L254)

<a id="damageshockwavevariance"></a>

##### damageShockwaveVariance

```ts
readonly damageShockwaveVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:255](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L255)

<a id="damagesuperchill"></a>

##### damageSuperchill

```ts
readonly damageSuperchill: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:252](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L252)

<a id="damagesuperchillvariance"></a>

##### damageSuperchillVariance

```ts
readonly damageSuperchillVariance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:253](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L253)

<a id="fuelconsumptionrate"></a>

##### fuelConsumptionRate

```ts
readonly fuelConsumptionRate: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:276](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L276)

<a id="hitchance"></a>

##### hitChance

```ts
readonly hitChance: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:272](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L272)

<a id="hp"></a>

##### hp

```ts
readonly hp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:234](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L234)

<a id="lootrate"></a>

##### lootRate

```ts
readonly lootRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:243](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L243)

<a id="missiledamage"></a>

##### missileDamage

```ts
readonly missileDamage: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:277](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L277)

<a id="missilefirerate"></a>

##### missileFireRate

```ts
readonly missileFireRate: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:278](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L278)

<a id="repairability"></a>

##### repairAbility

```ts
readonly repairAbility: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:240](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L240)

<a id="repaircost"></a>

##### repairCost

```ts
readonly repairCost: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:242](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L242)

<a id="repairefficiency"></a>

##### repairEfficiency

```ts
readonly repairEfficiency: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:241](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L241)

<a id="repairrate"></a>

##### repairRate

```ts
readonly repairRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:239](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L239)

<a id="shieldbreakdelayseconds"></a>

##### shieldBreakDelaySeconds

```ts
readonly shieldBreakDelaySeconds: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:244](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L244)

<a id="shieldrechargerate"></a>

##### shieldRechargeRate

```ts
readonly shieldRechargeRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:238](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L238)

<a id="sp"></a>

##### sp

```ts
readonly sp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:235](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L235)

<a id="stealthpower"></a>

##### stealthPower

```ts
readonly stealthPower: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:271](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L271)

<a id="warpspooltimeseconds"></a>

##### warpSpoolTimeSeconds

```ts
readonly warpSpoolTimeSeconds: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:245](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/fleet.ts#L245)

***

<a id="fleetcombatstatussnapshot"></a>

### FleetCombatStatusSnapshot

Defined in: [packages/sage/src/combat/index.ts:152](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L152)

Immutable focused combat projection of one Fleet.

#### Example

```ts
declare const status: FleetCombatStatusSnapshot;
console.log(
  status.current.abilityPowerPoints,
  status.timing.abilityPowerReloadAtUnixSeconds,
);
```

#### Properties

<a id="current"></a>

##### current

```ts
readonly current: {
  abilityPowerPoints: number;
  hullPoints: number;
  pendingHullPoints: number;
  shieldPoints: number;
};
```

Defined in: [packages/sage/src/combat/index.ts:160](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L160)

###### abilityPowerPoints

```ts
readonly abilityPowerPoints: number;
```

###### hullPoints

```ts
readonly hullPoints: number;
```

###### pendingHullPoints

```ts
readonly pendingHullPoints: number;
```

###### shieldPoints

```ts
readonly shieldPoints: number;
```

<a id="faction"></a>

##### faction

```ts
readonly faction: CombatFaction;
```

Defined in: [packages/sage/src/combat/index.ts:156](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L156)

<a id="fleet"></a>

##### fleet

```ts
readonly fleet: EntityRef<"fleet">;
```

Defined in: [packages/sage/src/combat/index.ts:154](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L154)

<a id="kind-1"></a>

##### kind

```ts
readonly kind: "fleetCombatStatus";
```

Defined in: [packages/sage/src/combat/index.ts:153](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L153)

<a id="ownerprofile"></a>

##### ownerProfile

```ts
readonly ownerProfile: EntityRef<"profile">;
```

Defined in: [packages/sage/src/combat/index.ts:155](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L155)

<a id="participant"></a>

##### participant

```ts
readonly participant: 
  | {
  kind: "player";
}
  | {
  factionId: number;
  kind: "npc";
};
```

Defined in: [packages/sage/src/combat/index.ts:157](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L157)

<a id="stance"></a>

##### stance

```ts
readonly stance: {
  ammoUsage: "none" | "light" | "heavy";
};
```

Defined in: [packages/sage/src/combat/index.ts:166](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L166)

###### ammoUsage

```ts
readonly ammoUsage: "none" | "light" | "heavy";
```

<a id="stats"></a>

##### stats

```ts
readonly stats: FleetCombatStatsData;
```

Defined in: [packages/sage/src/combat/index.ts:177](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L177)

<a id="stimulants"></a>

##### stimulants

```ts
readonly stimulants: readonly {
  chargesRemaining: number;
  deltaBps: number;
  statId: number;
}[];
```

Defined in: [packages/sage/src/combat/index.ts:172](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L172)

<a id="timing"></a>

##### timing

```ts
readonly timing: {
  abilityPowerReloadAtUnixSeconds: bigint;
  lastCombatUpdateAtUnixSeconds: bigint;
  shieldBreakDelayEndsAtUnixSeconds: bigint;
};
```

Defined in: [packages/sage/src/combat/index.ts:167](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L167)

###### abilityPowerReloadAtUnixSeconds

```ts
readonly abilityPowerReloadAtUnixSeconds: bigint;
```

###### lastCombatUpdateAtUnixSeconds

```ts
readonly lastCombatUpdateAtUnixSeconds: bigint;
```

###### shieldBreakDelayEndsAtUnixSeconds

```ts
readonly shieldBreakDelayEndsAtUnixSeconds: bigint;
```

#### Methods

<a id="tojson-1"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/combat/index.ts:178](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L178)

###### Returns

`unknown`

***

<a id="gamecombatconfigurationdata"></a>

### GameCombatConfigurationData

Defined in: [packages/sage/src/internal/c4/game.ts:236](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L236)

Translated Game combat configuration before cargo resolution.

#### Example

```ts
declare const configuration: GameCombatConfigurationData;
console.log(configuration.maxFleetSize);
```

#### Properties

<a id="cargorespawntimeseconds-1"></a>

##### cargoRespawnTimeSeconds

```ts
readonly cargoRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:243](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L243)

<a id="crewrespawntimeseconds-1"></a>

##### crewRespawnTimeSeconds

```ts
readonly crewRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:242](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L242)

<a id="globalceasefire-1"></a>

##### globalCeasefire

```ts
readonly globalCeasefire: boolean;
```

Defined in: [packages/sage/src/internal/c4/game.ts:237](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L237)

<a id="interactionrange-1"></a>

##### interactionRange

```ts
readonly interactionRange: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:238](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L238)

<a id="lootexclusivitytimeseconds-1"></a>

##### lootExclusivityTimeSeconds

```ts
readonly lootExclusivityTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:239](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L239)

<a id="maxfleetsize-1"></a>

##### maxFleetSize

```ts
readonly maxFleetSize: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:245](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L245)

<a id="maxlootrate-1"></a>

##### maxLootRate

```ts
readonly maxLootRate: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:240](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L240)

<a id="rawshipsrespawntimeseconds-1"></a>

##### rawShipsRespawnTimeSeconds

```ts
readonly rawShipsRespawnTimeSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/game.ts:244](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L244)

<a id="starbaseupgradeprogresscontinuation-1"></a>

##### starbaseUpgradeProgressContinuation

```ts
readonly starbaseUpgradeProgressContinuation: GameCombatFixedValueData;
```

Defined in: [packages/sage/src/internal/c4/game.ts:241](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L241)

<a id="stimulantdefinitions-1"></a>

##### stimulantDefinitions

```ts
readonly stimulantDefinitions: {
  definitions: readonly GameStimulantDefinitionData[];
  sequenceId: number;
};
```

Defined in: [packages/sage/src/internal/c4/game.ts:246](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L246)

###### definitions

```ts
readonly definitions: readonly GameStimulantDefinitionData[];
```

###### sequenceId

```ts
readonly sequenceId: number;
```

***

<a id="gamestimulanteffectdata"></a>

### GameStimulantEffectData

Defined in: [packages/sage/src/internal/c4/game.ts:224](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L224)

One translated combat stimulant effect.

#### Example

```ts
const effect: GameStimulantEffectData = {
  charges: 1,
  deltaBps: 250,
  stackRuleId: 0,
  statId: 2,
};
```

#### Properties

<a id="charges"></a>

##### charges

```ts
readonly charges: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:227](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L227)

<a id="deltabps"></a>

##### deltaBps

```ts
readonly deltaBps: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:226](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L226)

<a id="stackruleid"></a>

##### stackRuleId

```ts
readonly stackRuleId: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:228](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L228)

<a id="statid"></a>

##### statId

```ts
readonly statId: number;
```

Defined in: [packages/sage/src/internal/c4/game.ts:225](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/game.ts#L225)

***

<a id="lootcargoitem"></a>

### LootCargoItem

Defined in: [packages/sage/src/combat/index.ts:188](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L188)

One resolved cargo quantity inside Loot.

#### Example

```ts
declare const item: LootCargoItem;
console.log(item.cargo.name, item.quantityRaw);
```

#### Properties

<a id="cargo-1"></a>

##### cargo

```ts
readonly cargo: CargoDefinitionSummary;
```

Defined in: [packages/sage/src/combat/index.ts:189](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L189)

<a id="quantityraw"></a>

##### quantityRaw

```ts
readonly quantityRaw: bigint;
```

Defined in: [packages/sage/src/combat/index.ts:190](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L190)

***

<a id="lootinventory"></a>

### LootInventory

Defined in: [packages/sage/src/combat/index.ts:200](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L200)

Resolved inventory for one Loot leg.

#### Example

```ts
declare const inventory: LootInventory;
console.log(inventory.items.length);
```

#### Properties

<a id="items"></a>

##### items

```ts
readonly items: readonly LootCargoItem[];
```

Defined in: [packages/sage/src/combat/index.ts:203](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L203)

<a id="sequenceid"></a>

##### sequenceId

```ts
readonly sequenceId: number;
```

Defined in: [packages/sage/src/combat/index.ts:201](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L201)

<a id="storagecostraw"></a>

##### storageCostRaw

```ts
readonly storageCostRaw: bigint;
```

Defined in: [packages/sage/src/combat/index.ts:202](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L202)

***

<a id="lootitem"></a>

### LootItem

Defined in: [packages/sage/src/combat/index.ts:213](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L213)

One translated Loot item group.

#### Example

```ts
declare const item: LootItem;
console.log(item.destroyer.address, item.exclusivityUnlockAtUnixSeconds);
```

#### Properties

<a id="destroyer"></a>

##### destroyer

```ts
readonly destroyer: EntityRef<"fleet">;
```

Defined in: [packages/sage/src/combat/index.ts:214](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L214)

<a id="exclusivityunlockatunixseconds"></a>

##### exclusivityUnlockAtUnixSeconds

```ts
readonly exclusivityUnlockAtUnixSeconds: bigint;
```

Defined in: [packages/sage/src/combat/index.ts:215](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L215)

<a id="inventory"></a>

##### inventory

```ts
readonly inventory: LootInventory;
```

Defined in: [packages/sage/src/combat/index.ts:217](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L217)

<a id="rewardreclaimatunixseconds"></a>

##### rewardReclaimAtUnixSeconds

```ts
readonly rewardReclaimAtUnixSeconds: bigint;
```

Defined in: [packages/sage/src/combat/index.ts:216](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L216)

***

<a id="lootsnapshot"></a>

### LootSnapshot

Defined in: [packages/sage/src/combat/index.ts:227](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L227)

Immutable Loot snapshot with resolved cargo inventory.

#### Example

```ts
declare const loot: LootSnapshot;
console.log(loot.reward.kind, loot.items.length);
```

#### Properties

<a id="address-1"></a>

##### address

```ts
readonly address: Address;
```

Defined in: [packages/sage/src/combat/index.ts:229](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L229)

<a id="coordinates"></a>

##### coordinates

```ts
readonly coordinates: {
  x: number;
  y: number;
};
```

Defined in: [packages/sage/src/combat/index.ts:233](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L233)

###### x

```ts
readonly x: number;
```

###### y

```ts
readonly y: number;
```

<a id="game"></a>

##### game

```ts
readonly game: EntityRef<"game">;
```

Defined in: [packages/sage/src/combat/index.ts:231](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L231)

<a id="items-1"></a>

##### items

```ts
readonly items: readonly LootItem[];
```

Defined in: [packages/sage/src/combat/index.ts:235](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L235)

<a id="kind-2"></a>

##### kind

```ts
readonly kind: "loot";
```

Defined in: [packages/sage/src/combat/index.ts:228](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L228)

<a id="profile"></a>

##### profile

```ts
readonly profile: EntityRef<"profile">;
```

Defined in: [packages/sage/src/combat/index.ts:232](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L232)

<a id="reward"></a>

##### reward

```ts
readonly reward: LootRewardData;
```

Defined in: [packages/sage/src/combat/index.ts:234](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L234)

<a id="version"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/combat/index.ts:230](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L230)

#### Methods

<a id="tojson-2"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/combat/index.ts:236](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L236)

###### Returns

`unknown`

***

<a id="outlawflagaccountdata"></a>

### OutlawFlagAccountData

Defined in: [packages/sage/src/internal/c4/combat.ts:139](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L139)

Fully translated OutlawFlag account data.

#### Properties

<a id="bump"></a>

##### bump

```ts
readonly bump: number;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:146](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L146)

<a id="declaredatunixseconds"></a>

##### declaredAtUnixSeconds

```ts
readonly declaredAtUnixSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:144](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L144)

<a id="faction-1"></a>

##### faction

```ts
readonly faction: CombatFaction;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:142](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L142)

<a id="isoutlaw"></a>

##### isOutlaw

```ts
readonly isOutlaw: boolean;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:143](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L143)

<a id="profile-1"></a>

##### profile

```ts
readonly profile: Address;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:141](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L141)

<a id="pvpuntilunixseconds"></a>

##### pvpUntilUnixSeconds

```ts
readonly pvpUntilUnixSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:145](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L145)

<a id="version-1"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:140](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L140)

***

<a id="outlawflagsnapshot"></a>

### OutlawFlagSnapshot

Defined in: [packages/sage/src/combat/index.ts:246](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L246)

Immutable optional outlaw declaration derived from Profile and faction.

#### Example

```ts
declare const flag: OutlawFlagSnapshot;
console.log(flag.isOutlaw, flag.pvpUntilUnixSeconds);
```

#### Extends

- `Omit`\<[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata), `"profile"`\>

#### Properties

<a id="address-2"></a>

##### address

```ts
readonly address: Address;
```

Defined in: [packages/sage/src/combat/index.ts:251](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L251)

<a id="bump-1"></a>

##### bump

```ts
readonly bump: number;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:146](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L146)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`bump`](/reference/combat/#outlawflagaccountdata)

<a id="declaredatunixseconds-1"></a>

##### declaredAtUnixSeconds

```ts
readonly declaredAtUnixSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:144](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L144)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`declaredAtUnixSeconds`](/reference/combat/#outlawflagaccountdata)

<a id="faction-2"></a>

##### faction

```ts
readonly faction: CombatFaction;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:142](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L142)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`faction`](/reference/combat/#outlawflagaccountdata)

<a id="isoutlaw-1"></a>

##### isOutlaw

```ts
readonly isOutlaw: boolean;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:143](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L143)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`isOutlaw`](/reference/combat/#outlawflagaccountdata)

<a id="kind-3"></a>

##### kind

```ts
readonly kind: "outlawFlag";
```

Defined in: [packages/sage/src/combat/index.ts:250](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L250)

<a id="profile-2"></a>

##### profile

```ts
readonly profile: EntityRef<"profile">;
```

Defined in: [packages/sage/src/combat/index.ts:252](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L252)

<a id="pvpuntilunixseconds-1"></a>

##### pvpUntilUnixSeconds

```ts
readonly pvpUntilUnixSeconds: bigint;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:145](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L145)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`pvpUntilUnixSeconds`](/reference/combat/#outlawflagaccountdata)

<a id="version-2"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/internal/c4/combat.ts:140](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L140)

###### Inherited from

[`OutlawFlagAccountData`](/reference/combat/#outlawflagaccountdata).[`version`](/reference/combat/#outlawflagaccountdata)

#### Methods

<a id="tojson-3"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/combat/index.ts:253](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L253)

###### Returns

`unknown`

## Type Aliases

<a id="combatfaction"></a>

### CombatFaction

```ts
type CombatFaction = "unaligned" | "mud" | "oni" | "ustur";
```

Defined in: [packages/sage/src/internal/c4/combat.ts:84](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L84)

Faction identifier accepted by combat reads.

#### Example

```ts
const faction: CombatFaction = 'mud';
```

***

<a id="lootdiscoveryoptions"></a>

### LootDiscoveryOptions

```ts
type LootDiscoveryOptions = Omit<DiscoveryRequest, "filters" | "strategy">;
```

Defined in: [packages/sage/src/combat/index.ts:105](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L105)

Options supported by targeted Loot discovery.

#### Example

```ts
const options: LootDiscoveryOptions = { commitment: 'confirmed' };
```

***

<a id="lootrewarddata"></a>

### LootRewardData

```ts
type LootRewardData = 
  | {
  kind: "none";
}
  | {
  committedAtUnixSeconds: bigint;
  configVersion: number;
  kind: "committed" | "resolved";
  legs: readonly LootRewardLegData[];
  slot: bigint;
}
  | {
  committedAtUnixSeconds: bigint;
  configVersion: number;
  kind: "unknown";
  legs: readonly LootRewardLegData[];
  rawStatus: number;
  slot: bigint;
};
```

Defined in: [packages/sage/src/internal/c4/combat.ts:110](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/internal/c4/combat.ts#L110)

Translated Loot reward state, including unknown raw status bytes.

#### Example

```ts
const reward: LootRewardData = { kind: 'none' };
```

## Functions

<a id="getcombatconfiguration"></a>

### getCombatConfiguration()

```ts
function getCombatConfiguration(context, options?): Promise<CombatConfigurationSnapshot>;
```

Defined in: [packages/sage/src/combat/index.ts:321](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L321)

Reads the configured Game's combat settings and stimulant catalog.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`CombatConfigurationSnapshot`](/reference/combat/#combatconfigurationsnapshot)\>

#### Example

```ts
declare const ctx: SageContext;
const configuration = await getCombatConfiguration(ctx);
```

***

<a id="getfleetcombatstatus"></a>

### getFleetCombatStatus()

```ts
function getFleetCombatStatus(
   context, 
   address, 
options?): Promise<FleetCombatStatusSnapshot>;
```

Defined in: [packages/sage/src/combat/index.ts:387](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L387)

Reads one Fleet and returns only its translated combat state.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-19) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`FleetCombatStatusSnapshot`](/reference/combat/#fleetcombatstatussnapshot)\>

#### Example

```ts
declare const ctx: SageContext;
declare const fleet: Address;
const status = await getFleetCombatStatus(ctx, fleet);
```

***

<a id="getloot"></a>

### getLoot()

```ts
function getLoot(
   context, 
   address, 
options?): Promise<LootSnapshot>;
```

Defined in: [packages/sage/src/combat/index.ts:483](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L483)

Reads required Loot by its signer-created account address.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-19) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`LootSnapshot`](/reference/combat/#lootsnapshot)\>

#### Example

```ts
declare const ctx: SageContext;
declare const address: Address;
const loot = await getLoot(ctx, address);
```

***

<a id="getlootbyprofile"></a>

### getLootByProfile()

```ts
function getLootByProfile(
   context, 
   profile, 
options?): Promise<readonly LootSnapshot[]>;
```

Defined in: [packages/sage/src/combat/index.ts:525](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L525)

Discovers Loot created by one Profile using stable targeted filters.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `profile` | [`Address`](/reference/#address-19) |
| `options?` | [`LootDiscoveryOptions`](/reference/combat/#lootdiscoveryoptions) |

#### Returns

`Promise`\<readonly [`LootSnapshot`](/reference/combat/#lootsnapshot)[]\>

#### Example

```ts
declare const ctx: SageContext;
declare const profile: Address;
const loot = await getLootByProfile(ctx, profile);
```

***

<a id="getoutlawflag"></a>

### getOutlawFlag()

```ts
function getOutlawFlag(
   context, 
   profile, 
   againstFaction, 
   options?): Promise<
  | OutlawFlagSnapshot
| undefined>;
```

Defined in: [packages/sage/src/combat/index.ts:567](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L567)

Derives and reads an optional OutlawFlag for a Profile/faction pair.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `profile` | [`Address`](/reference/#address-19) |
| `againstFaction` | [`CombatFaction`](/reference/combat/#combatfaction) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<
  \| [`OutlawFlagSnapshot`](/reference/combat/#outlawflagsnapshot)
  \| `undefined`\>

#### Example

```ts
declare const ctx: SageContext;
declare const profile: Address;
const flag = await getOutlawFlag(ctx, profile, 'mud');
```

***

<a id="maybegetloot"></a>

### maybeGetLoot()

```ts
function maybeGetLoot(
   context, 
   address, 
options?): Promise<LootSnapshot | undefined>;
```

Defined in: [packages/sage/src/combat/index.ts:503](https://github.com/Aephia/atlas-kit/blob/v0.5.0/packages/sage/src/combat/index.ts#L503)

Reads optional Loot by account address.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `context` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-19) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`LootSnapshot`](/reference/combat/#lootsnapshot) \| `undefined`\>

#### Example

```ts
declare const ctx: SageContext;
declare const address: Address;
const loot = await maybeGetLoot(ctx, address);
```
