Resource RoundResource

RoundResource (client.round)

Endpoints: • round.getById • round.getLastHits

.get()

Get a battle round by ID.

Signature

await client.round.get(round_id: 'str') -> 'Round'

Parameters

Name	Type	Default
round_id	str	*Required*

Return Models

Equipment

A single equipped item returned by inventory.fetchCurrentEquipment.

The API returns one object keyed by slot (weapon, helmet, ...); the resource flattens it into a list of Equipment with slot set.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
slot	string \| null	❌
itemId	string \| null	❌
itemCode	string \| null	❌
name	string \| null	❌
rarity	string \| null	❌
stats	object \| null	❌
type	string \| null	❌
code	string \| null	❌
skills	EquipmentSkills \| null	❌
state	number \| null	❌
maxState	number \| null	❌
quantity	integer \| null	❌
lastAcquisitionAt	string \| null	❌

EquipmentSkills

Stat bonuses granted by an equipped item.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
attack	number \| null	❌
armor	number \| null	❌
criticalChance	number \| null	❌
criticalDamages	number \| null	❌
dodge	number \| null	❌
precision	number \| null	❌

Hit

A single hit entry (round.getLastHits / round side lastHits).

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
user	string \| null	❌
mu	string \| null	❌
damages	number \| null	❌
isCriticalHit	boolean \| null	❌
isMissed	boolean \| null	❌
hitAt	string \| null	❌
ammo	string \| null	❌
weapon	Equipment \| null	❌
equipments	array[Equipment] \| null	❌

Round

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
battle	string \| null	❌
number	integer \| null	❌
isActive	boolean \| null	❌
attacker	RoundSide \| null	❌
defender	RoundSide \| null	❌
live	RoundLive \| null	❌
createdAt	string \| null	❌
updatedAt	string \| null	❌

RoundLive

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
ticksCount	integer \| null	❌
actualTickPoints	number \| null	❌
nextTickAt	string \| null	❌

RoundSide

Combat stats of one side (attacker/defender) within a round.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
country	string \| null	❌
damages	number \| null	❌
points	number \| null	❌
hitCount	integer \| null	❌
lastHits	array[Hit] \| null	❌

---

.get_last_hits()

Get the most recent hits in a battle round.

Signature

await client.round.get_last_hits(round_id: 'str') -> 'list[Hit]'

Parameters

Name	Type	Default
round_id	str	*Required*

Return Models

Equipment

A single equipped item returned by inventory.fetchCurrentEquipment.

The API returns one object keyed by slot (weapon, helmet, ...); the resource flattens it into a list of Equipment with slot set.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
slot	string \| null	❌
itemId	string \| null	❌
itemCode	string \| null	❌
name	string \| null	❌
rarity	string \| null	❌
stats	object \| null	❌
type	string \| null	❌
code	string \| null	❌
skills	EquipmentSkills \| null	❌
state	number \| null	❌
maxState	number \| null	❌
quantity	integer \| null	❌
lastAcquisitionAt	string \| null	❌

EquipmentSkills

Stat bonuses granted by an equipped item.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
attack	number \| null	❌
armor	number \| null	❌
criticalChance	number \| null	❌
criticalDamages	number \| null	❌
dodge	number \| null	❌
precision	number \| null	❌

Hit

A single hit entry (round.getLastHits / round side lastHits).

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
user	string \| null	❌
mu	string \| null	❌
damages	number \| null	❌
isCriticalHit	boolean \| null	❌
isMissed	boolean \| null	❌
hitAt	string \| null	❌
ammo	string \| null	❌
weapon	Equipment \| null	❌
equipments	array[Equipment] \| null	❌

---

.get_many()

Fetch multiple rounds by ID concurrently using the auto-batcher.

Signature

await client.round.get_many(round_ids: 'list[str]') -> 'list[Round | None]'

Parameters

Name	Type	Default
round_ids	list[str]	*Required*

Return Models

Equipment

A single equipped item returned by inventory.fetchCurrentEquipment.

The API returns one object keyed by slot (weapon, helmet, ...); the resource flattens it into a list of Equipment with slot set.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
slot	string \| null	❌
itemId	string \| null	❌
itemCode	string \| null	❌
name	string \| null	❌
rarity	string \| null	❌
stats	object \| null	❌
type	string \| null	❌
code	string \| null	❌
skills	EquipmentSkills \| null	❌
state	number \| null	❌
maxState	number \| null	❌
quantity	integer \| null	❌
lastAcquisitionAt	string \| null	❌

EquipmentSkills

Stat bonuses granted by an equipped item.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
attack	number \| null	❌
armor	number \| null	❌
criticalChance	number \| null	❌
criticalDamages	number \| null	❌
dodge	number \| null	❌
precision	number \| null	❌

Hit

A single hit entry (round.getLastHits / round side lastHits).

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
user	string \| null	❌
mu	string \| null	❌
damages	number \| null	❌
isCriticalHit	boolean \| null	❌
isMissed	boolean \| null	❌
hitAt	string \| null	❌
ammo	string \| null	❌
weapon	Equipment \| null	❌
equipments	array[Equipment] \| null	❌

Round

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
battle	string \| null	❌
number	integer \| null	❌
isActive	boolean \| null	❌
attacker	RoundSide \| null	❌
defender	RoundSide \| null	❌
live	RoundLive \| null	❌
createdAt	string \| null	❌
updatedAt	string \| null	❌

RoundLive

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
ticksCount	integer \| null	❌
actualTickPoints	number \| null	❌
nextTickAt	string \| null	❌

RoundSide

Combat stats of one side (attacker/defender) within a round.

Field	Type	Required	Description
_id	string \| null	❌
__v	integer \| null	❌
country	string \| null	❌
damages	number \| null	❌
points	number \| null	❌
hitCount	integer \| null	❌
lastHits	array[Hit] \| null	❌

---

.invalidate_cache()

Clear the SWR cache for all resources.

Signature

await client.round.invalidate_cache() -> 'None'

---