Brodgar client

Data Types: The Fight

The snapshot shapes off the manoeuvre-deck builder and the fight in progress: one manoeuvre, one card in the deck, the action-point budget, a saved school, an opponent, an opening, and a combat action. Each is what :info() copies out of a live object on session:fight. The model is on the catalogue.

local summary = hafen.session():current():fight():summary()
local snapshot = summary and summary:info()
if snapshot then hafen.log():write(snapshot.used .. "/" .. snapshot.maxact .. " action points") end

Maneuver, DeckCard, FightSummary

Shape	Fields
`Maneuver`	`{ res?, name?, avail = number, used = number }`, the counts in the window’s spelling: `avail` is `maneuver:max()` and `used` is `maneuver:copies()`.
`DeckCard`	`{ key = string?, res = string?, name = string?, used = number }`, and `nil` for an empty place. `key` is the hotkey label such as `"1"` or `"⇧1"`, absent past the labels the tab paints. `res` and `name` are absent while the resource resolves. `used` is `card:copies()`, in the window’s spelling. The place itself is read live, by `card:index()` and `card:wire()`.
`FightSummary`	`{ maxact, used }` in the window’s spelling. The live reads are `summary:maxActions()` and `:spent()`.

School

From school:info(), nil for an unused slot. { name = string }: the name the tab paints. The slot itself is read live, by school:index() and school:wire().

Opponent

From opponent:info(). { id = number, ip = { mine = number, theirs = number }?, give = { mine = boolean, theirs = boolean }?, last = string? }. ip, give and last are absent once the fight with that opponent has ended, and the snapshot is then { id }; last is absent before their first manoeuvre too. Everything about the creature itself is read off its Gob.

Opening

From opening:info(). session:fight():opening():list(), opponent:opening():list() and the opening events hand live Opening objects, not this table.

Field	Type	Notes
`res`, `name`	`string`	Resource plus display name. Optional.
`amount`	`number`	`0..1` fraction, the live `opening:amount()`. Content-defined, often absent.
`remaining`	`number`	`0..1` fraction of the run left, the live `opening:remaining()`. Content-defined, often absent, not seconds.
`number`	`number`	Integer overlay. Content-defined, often absent.

CombatAction

From action:info(), nil for an empty place. { res = string?, name = string?, cooldown = number }: cooldown is the 0..1 fraction of its own cooldown still to run, not seconds, 0 when the action can be used.