@pikehub/warpass-bot 62.0.1 → 63.0.1

package/CHANGELOG.md

@@ -1,3 +1,63 @@
-# Changes in 62.0.1
+# Changes in 63.0.1
 
-Compared with engine 62.
+Compared with engine 63.
+
+## Buildings
+
+- changed `templars:keep`: armor: null → {"melee":3,"pierce":6}; attack: null → {"damage":4,"range":1792,"minRange":0,"cooldown":40,"splash":0,"onlyBuildings":false}
+- changed `templars:house`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `templars:farm`: armor: null → {"melee":0,"pierce":0}; attack: null → null
+- changed `templars:granary`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `templars:lumberMill`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `templars:miningCamp`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `templars:barracks`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:archeryRange`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:blacksmith`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:stable`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:chapel`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:masonsLodge`: armor: null → {"melee":2,"pierce":8}; attack: null → null
+- changed `templars:siegeWorkshop`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:powderMill`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `templars:palisade`: armor: null → {"melee":0,"pierce":3}; attack: null → null
+- changed `templars:stoneWall`: armor: null → {"melee":6,"pierce":8}; attack: null → null
+- changed `templars:gate`: armor: null → {"melee":6,"pierce":10}; attack: null → null
+- changed `templars:watchtower`: armor: null → {"melee":1,"pierce":7}; attack: null → {"damage":5,"range":2048,"minRange":256,"cooldown":40,"splash":0,"onlyBuildings":false}
+- changed `orcs:skullHall`: armor: null → {"melee":3,"pierce":5}; attack: null → {"damage":4,"range":1792,"minRange":0,"cooldown":40,"splash":0,"onlyBuildings":false}
+- changed `orcs:burrow`: armor: null → {"melee":1,"pierce":5}; attack: null → null
+- changed `orcs:mushroomBed`: armor: null → {"melee":0,"pierce":0}; attack: null → null
+- changed `orcs:gutLarder`: armor: null → {"melee":1,"pierce":5}; attack: null → null
+- changed `orcs:boneYard`: armor: null → {"melee":1,"pierce":5}; attack: null → null
+- changed `orcs:goldPit`: armor: null → {"melee":1,"pierce":5}; attack: null → null
+- changed `orcs:spawningPit`: armor: null → {"melee":1,"pierce":7}; attack: null → null
+- changed `orcs:totemLodge`: armor: null → {"melee":1,"pierce":7}; attack: null → null
+- changed `orcs:fleshDen`: armor: null → {"melee":1,"pierce":7}; attack: null → null
+- changed `orcs:bloodAltar`: armor: null → {"melee":2,"pierce":7}; attack: null → null
+- changed `orcs:spikeTower`: armor: null → {"melee":1,"pierce":7}; attack: null → {"damage":6,"range":1792,"minRange":256,"cooldown":40,"splash":0,"onlyBuildings":false}
+- changed `witches:covenSpire`: armor: null → {"melee":3,"pierce":5}; attack: null → {"damage":4,"range":1792,"minRange":0,"cooldown":40,"splash":0,"onlyBuildings":false}
+- changed `witches:starlitCottage`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `witches:moonGarden`: armor: null → {"melee":0,"pierce":0}; attack: null → null
+- changed `witches:stillroom`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `witches:sylvanLodge`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `witches:geodeVault`: armor: null → {"melee":1,"pierce":6}; attack: null → null
+- changed `witches:wayshrine`: armor: null → {"melee":1,"pierce":5}; attack: null → null
+- changed `witches:sanctum`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `witches:aerie`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `witches:observatory`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `witches:atelier`: armor: null → {"melee":1,"pierce":8}; attack: null → null
+- changed `witches:gargoyleRoost`: armor: null → {"melee":2,"pierce":8}; attack: null → null
+- changed `witches:wardstone`: armor: null → {"melee":1,"pierce":6}; attack: null → {"damage":4,"range":1792,"minRange":256,"cooldown":32,"splash":0,"onlyBuildings":false}
+- changed `witches:hexSpire`: armor: null → {"melee":1,"pierce":7}; attack: null → {"damage":5,"range":2048,"minRange":256,"cooldown":50,"splash":0,"onlyBuildings":false}
+- changed `witches:starfallBeacon`: armor: null → {"melee":2,"pierce":8}; attack: null → {"damage":30,"range":2816,"minRange":1024,"cooldown":120,"splash":256,"onlyBuildings":false}
+- changed `witches:leyObelisk`: armor: null → {"melee":0,"pierce":4}; attack: null → null
+- changed `witches:hexCircle`: armor: null → {"melee":0,"pierce":2}; attack: null → null
+- changed `witches:thornSnare`: armor: null → {"melee":0,"pierce":2}; attack: null → null
+- changed `witches:briarHedge`: armor: null → {"melee":0,"pierce":3}; attack: null → null
+- changed `witches:moonstoneWall`: armor: null → {"melee":5,"pierce":8}; attack: null → null
+- changed `witches:moonGate`: armor: null → {"melee":5,"pierce":10}; attack: null → null
+- changed `-:sawmillWeir`: armor: null → {"melee":2,"pierce":6}; attack: null → null
+- changed `-:deepMine`: armor: null → {"melee":3,"pierce":8}; attack: null → null
+- changed `-:quarry`: armor: null → {"melee":3,"pierce":8}; attack: null → null
+- changed `-:horseRanch`: armor: null → {"melee":2,"pierce":6}; attack: null → null
+- changed `-:warCamp`: armor: null → {"melee":2,"pierce":6}; attack: null → null
+- changed `-:engineersYard`: armor: null → {"melee":2,"pierce":8}; attack: null → null
+- changed `-:holyWell`: armor: null → {"melee":2,"pierce":6}; attack: null → null

package/docs/api/act.md

@@ -14,7 +14,7 @@ Every order a bot can give, on `act` during a think (and on the builder passed t
 | `target(who, target, { queued })` | `target(who, target, queued=False)` | the right-click order: attack an enemy, gather a resource, repair your building |
 | `repair(who, target, { queued })` | `repair(who, target, queued=False)` | workers repair one of your buildings |
 | `gather(who, tile, { queued })` | `gather(who, tile, queued=False)` | workers gather the resource on a tile (from `nearestResource`) |
-| `build(who, building, at, { queued })` | `build(who, building, at, queued=False)` | workers place and build a building with its top-left at `at`; pays on placement |
+| `build(who, building, at, { queued })` | `build(who, building, at, queued=False)` | workers place and build a building with its top-left at `at` (the footprint must be in view); pays on placement |
 | `buildLine(who, building, from, to, { queued })` | `build_line(who, building, start, end, queued=False)` | a line of wall segments |
 | `train(building, unit, count = 1)` | `train(building, unit, count=1)` | queue units (pays now) |
 | `research(building, upgrade)` | `research(building, upgrade)` | queue an upgrade (pays now) |

package/docs/api/custom.md

@@ -51,7 +51,31 @@ Ops after the first step still apply but make the game unreplayable.
 | `until(maxTicks, (observer, tick) => done)` | `until(max_ticks, lambda observer, tick: done)` | step until `done`; returns ticks taken or `-1` |
 | `view(slot)` | `view(slot)` | the fogged [view](view.md) of a slot |
 | `observer()` | `observer()` | the full view of everything, no fog |
+| `events(slot)` | `events(slot)` | the [events](events.md) that slot got since the last call, fog-filtered exactly as in a match |
+| `observerEvents()` | `observer_events()` | every event since the last call, unfiltered |
 | `game(slot)` | `game(slot)` | [queries](game.md) as that slot |
 | `map()` | `map()` | map size, starts, chokes, sites |
 | `replay()` | `replay()` | a [Replay](replay.md) of setup and orders so far |
 | `tick`, `winner` | `tick`, `winner` | current tick; winning slot once over |
+
+The first `events` call for a slot (or `observerEvents`) starts recording for it and returns `[]`, so call it once before stepping. After that, each call returns what that player would have received in its `think` during a [local match](local.md):
+
+```js
+import { CustomGame, rules } from "@pikehub/warpass-bot";
+
+const r = rules();
+const [a, b] = r.races;
+const g = new CustomGame({ seed: 5, races: [a, b] });
+const [x0, y0] = g.flattenArea(24, 12);
+const fighter = (race) => r.units.find((u) => u.race === race && !u.worker && u.attack);
+const ours = [0, 1, 2].map((k) => g.spawn(0, fighter(a).id, (x0 + 4) * 256, (y0 + 3 + k) * 256));
+[0, 1, 2].forEach((k) => g.spawn(1, fighter(b).id, (x0 + 10) * 256, (y0 + 3 + k) * 256));
+g.events(0);
+g.events(1);
+g.order(0, (act) => act.attackMove(ours, (x0 + 12) * 256, (y0 + 4) * 256));
+g.step(20 * 30);
+const mine = g.events(0);
+const theirs = g.events(1);
+console.log(`slot 0: ${mine.filter((e) => e.t === "hit").length} hits, ${mine.filter((e) => e.t === "death").length} deaths`);
+console.log(`slot 1: ${theirs.filter((e) => e.t === "hit").length} hits`);
+```

package/docs/api/events.md

@@ -2,6 +2,8 @@
 
 What happened to your player since the last think, in `events` (oldest first). Each event is an object with a type tag `t` and its own fields; ids are numbers that index the rules (unit, building and upgrade lists in `rules()` order).
 
+In a [custom game](custom.md), `events(slot)` returns the same events for any slot.
+
 | `t` | When |
 |---|---|
 | `trained` | one of your units finished training |

package/docs/api/game.md

@@ -12,7 +12,7 @@ Questions a bot can ask during a think (`game`, or `match.game` online). Queries
 | `canResearch(building, upgrade)` | `can_research(building, upgrade)` | |
 | `placeRefusal(building, at)` | `place_refusal(building, at)` | `null` if a building id fits with its top-left at tile `at`, else a reason |
 | `canPlace(building, at)` | `can_place(building, at)` | |
-| `findPlacement(building, near, radius = 16)` | `find_placement(building, near, radius=16)` | `[tx, ty]` where it fits closest to `near`, or `null` |
+| `findPlacement(building, near, radius = 16)` | `find_placement(building, near, radius=16)` | `[tx, ty]` where it fits closest to `near` and is in view now, or `null` |
 | `nearestResource(from, resource, radius = 40)` | `nearest_resource(start, resource, radius=40)` | `[tx, ty]` of the nearest tile with `food`, `wood`, `stone` or `gold` left |
 | `reachable(from, to)` | `reachable(start, end)` | `true` if your units can walk between the two tiles |
 | `front(toward?)` | `front(toward=None)` | `[tx, ty]`: the tile where your army should gather to face tile `toward` (default: the map centre), usually a choke near your base |
@@ -23,4 +23,4 @@ Questions a bot can ask during a think (`game`, or `match.game` online). Queries
 - `building` arguments take a view object or an eid; `unit`, `upgrade` and building ids are strings from the rules.
 - Tile arguments take `[tx, ty]` or an object with `x`, `y` in tiles.
 - Training and research refusals: `notEnough` (resources), `supplyLimit`, `needHousing`, `queueFull`, `requirementsNotMet`, `limitReached`, `invalid` (wrong building, not finished, not yours).
-- Placement refusals: `outOfBounds`, `somethingInWay`, `cannotBuildThere`, `unevenGround`, `rampBlocked`, `buildOnSite` / `siteGround` (site buildings must stand on their site), `alreadyBuilt`, `limitReached`, `requirementsNotMet`, `unknownBuilding`.
+- Placement refusals: `outOfBounds`, `notVisible` (every footprint tile must be in your current vision; send a unit to look first), `somethingInWay`, `cannotBuildThere`, `unevenGround`, `rampBlocked`, `buildOnSite` / `siteGround` (site buildings must stand on their site), `alreadyBuilt`, `limitReached`, `requirementsNotMet`, `unknownBuilding`.

package/docs/api/online.md

@@ -9,6 +9,7 @@ Connect a bot account, queue or join a lobby by code, play a match and read the
 | `await offer.accept({ everyTicks? })` | `offer.accept(every_ticks=10)` | `OnlineMatch` once both accepted |
 | `await wp.lobby({ code, race, everyTicks? })` | `wp.lobby(code, race, every_ticks=10)` | `OnlineMatch` once the host starts: joins a player's lobby by its code, marks ready (again after the host changes the map or race) and waits |
 | `await offer.decline()` | `offer.decline()` | declines; the queue may give you a short penalty |
+| `wp.close()` | `wp.close()` | leaves the queue or lobby and closes the socket; a pending `connect`, `queue`, `accept` or `lobby` fails with `closed` (`stopped`). Call it before exiting on Ctrl-C |
 | `await Warpass.join({ token, matchId, url?, everyTicks? })` | `Warpass.join(match_id, token=, url=, every_ticks=10)` | `OnlineMatch`: rejoin a match you are in after a crash |
 | `match.onThink(think, { everyTicks? })` | `match.on_think(think, every_ticks=None)` | registers your think; returns the match |
 | `await match.ended()` | `match.ended()` | `{ reason }` when the match ends |
@@ -17,8 +18,10 @@ Connect a bot account, queue or join a lobby by code, play a match and read the
 | `match.id`, `match.slot` | `match.id`, `match.slot` | the match id and your slot |
 
 - `url` defaults to `DEFAULT_URL` (`https://warpass.pike.com.br`).
+- A match takes over the connection; after it ends, `queue` and `lobby` on the same `Warpass` reconnect by themselves, so one `Warpass` can play match after match.
 - `Offer.opponent` is `{ name, bot, rating, race }`.
 - `lobby` fails with `refused` (`missing`, `full`, `started`) when the code is wrong or taken, and with `cancelled` (`closed`) when the host closes the lobby.
+- In Python, Ctrl-C during `connect`, `queue`, `accept` or `lobby` closes the session and raises `KeyboardInterrupt`.
 - In Python, `ended()` and `result()` run your think loop on the calling thread until the match ends; an `async def` think is awaited.
 - In JS, the think loop runs in the background after `onThink`; `ended()` and `result()` wait for it.
 

package/docs/api/rules.md

@@ -18,11 +18,11 @@ Static facts about the bundled engine, and these docs, from code.
 ```
 { engineVersion, races, resources, terrains: { name: id }, tile, ticksPerSecond, mapSize,
   units: [{ id, race, cost, supply, hp, speed, sight, trainTicks, trainedAt, requires, abilities, worker, lane, armor: { melee, pierce }, attack }],
-  buildings: [{ id, race, size, cost, hp, buildTicks, supply, trains, researches, requires, site }],
+  buildings: [{ id, race, size, cost, hp, buildTicks, supply, trains, researches, requires, site, armor: { melee, pierce }, attack }],
   upgrades: [{ id, race, cost, ticks, requires, group }] }
 ```
 
-`requires` is `{ buildings, anyBuildings, upgrades, anyUpgrades }` (ids). `attack` is `{ damage, range, minRange, cooldown, splash, onlyBuildings }` or `null`. Units of measure are in [../rules/index.md](../rules/index.md); the same data as tables is under `rules/`.
+`requires` is `{ buildings, anyBuildings, upgrades, anyUpgrades }` (ids). `attack` (units and buildings) is `{ damage, range, minRange, cooldown, splash, onlyBuildings }` or `null`. Units of measure are in [../rules/index.md](../rules/index.md); the same data as tables is under `rules/`.
 
 ```js
 import { docs, docsIndex } from "@pikehub/warpass-bot";

package/docs/errors.md

@@ -8,7 +8,7 @@ Every SDK call that fails throws a `WarpassError` with a `kind` and the fields b
 | `unauthenticated` | | the key is wrong, rotated, or the bot was deleted | create or rotate the key on the Developer page |
 | `refused` | `about`, `reason`, `message` | the server refused a request | see reasons below |
 | `cancelled` | `reason` | the offer fell through (`declined`, `timeout`, the rival left) or the host closed the lobby (`closed`) | queue again |
-| `closed` | `reason` | the socket closed and could not reconnect | connect again; `Warpass.join` resumes a running match |
+| `closed` | `reason` | the socket closed and could not reconnect, or you called `close()` (`stopped`) | connect again; `Warpass.join` resumes a running match |
 | `timeout` | | no answer in time (`result` waits 120 s by default) | retry `result()`; the match may still be sealing |
 | `network` | `message` | DNS, TLS or HTTP failure | check `url` and connectivity |
 

package/docs/llms-full.txt

@@ -285,6 +285,7 @@ Connect a bot account, queue or join a lobby by code, play a match and read the
 | `await offer.accept({ everyTicks? })` | `offer.accept(every_ticks=10)` | `OnlineMatch` once both accepted |
 | `await wp.lobby({ code, race, everyTicks? })` | `wp.lobby(code, race, every_ticks=10)` | `OnlineMatch` once the host starts: joins a player's lobby by its code, marks ready (again after the host changes the map or race) and waits |
 | `await offer.decline()` | `offer.decline()` | declines; the queue may give you a short penalty |
+| `wp.close()` | `wp.close()` | leaves the queue or lobby and closes the socket; a pending `connect`, `queue`, `accept` or `lobby` fails with `closed` (`stopped`). Call it before exiting on Ctrl-C |
 | `await Warpass.join({ token, matchId, url?, everyTicks? })` | `Warpass.join(match_id, token=, url=, every_ticks=10)` | `OnlineMatch`: rejoin a match you are in after a crash |
 | `match.onThink(think, { everyTicks? })` | `match.on_think(think, every_ticks=None)` | registers your think; returns the match |
 | `await match.ended()` | `match.ended()` | `{ reason }` when the match ends |
@@ -293,8 +294,10 @@ Connect a bot account, queue or join a lobby by code, play a match and read the
 | `match.id`, `match.slot` | `match.id`, `match.slot` | the match id and your slot |
 
 - `url` defaults to `DEFAULT_URL` (`https://warpass.pike.com.br`).
+- A match takes over the connection; after it ends, `queue` and `lobby` on the same `Warpass` reconnect by themselves, so one `Warpass` can play match after match.
 - `Offer.opponent` is `{ name, bot, rating, race }`.
 - `lobby` fails with `refused` (`missing`, `full`, `started`) when the code is wrong or taken, and with `cancelled` (`closed`) when the host closes the lobby.
+- In Python, Ctrl-C during `connect`, `queue`, `accept` or `lobby` closes the session and raises `KeyboardInterrupt`.
 - In Python, `ended()` and `result()` run your think loop on the calling thread until the match ends; an `async def` think is awaited.
 - In JS, the think loop runs in the background after `onThink`; `ended()` and `result()` wait for it.
 
@@ -423,7 +426,7 @@ Questions a bot can ask during a think (`game`, or `match.game` online). Queries
 | `canResearch(building, upgrade)` | `can_research(building, upgrade)` | |
 | `placeRefusal(building, at)` | `place_refusal(building, at)` | `null` if a building id fits with its top-left at tile `at`, else a reason |
 | `canPlace(building, at)` | `can_place(building, at)` | |
-| `findPlacement(building, near, radius = 16)` | `find_placement(building, near, radius=16)` | `[tx, ty]` where it fits closest to `near`, or `null` |
+| `findPlacement(building, near, radius = 16)` | `find_placement(building, near, radius=16)` | `[tx, ty]` where it fits closest to `near` and is in view now, or `null` |
 | `nearestResource(from, resource, radius = 40)` | `nearest_resource(start, resource, radius=40)` | `[tx, ty]` of the nearest tile with `food`, `wood`, `stone` or `gold` left |
 | `reachable(from, to)` | `reachable(start, end)` | `true` if your units can walk between the two tiles |
 | `front(toward?)` | `front(toward=None)` | `[tx, ty]`: the tile where your army should gather to face tile `toward` (default: the map centre), usually a choke near your base |
@@ -434,7 +437,7 @@ Questions a bot can ask during a think (`game`, or `match.game` online). Queries
 - `building` arguments take a view object or an eid; `unit`, `upgrade` and building ids are strings from the rules.
 - Tile arguments take `[tx, ty]` or an object with `x`, `y` in tiles.
 - Training and research refusals: `notEnough` (resources), `supplyLimit`, `needHousing`, `queueFull`, `requirementsNotMet`, `limitReached`, `invalid` (wrong building, not finished, not yours).
-- Placement refusals: `outOfBounds`, `somethingInWay`, `cannotBuildThere`, `unevenGround`, `rampBlocked`, `buildOnSite` / `siteGround` (site buildings must stand on their site), `alreadyBuilt`, `limitReached`, `requirementsNotMet`, `unknownBuilding`.
+- Placement refusals: `outOfBounds`, `notVisible` (every footprint tile must be in your current vision; send a unit to look first), `somethingInWay`, `cannotBuildThere`, `unevenGround`, `rampBlocked`, `buildOnSite` / `siteGround` (site buildings must stand on their site), `alreadyBuilt`, `limitReached`, `requirementsNotMet`, `unknownBuilding`.
 
 <!-- api/act.md -->
 
@@ -454,7 +457,7 @@ Every order a bot can give, on `act` during a think (and on the builder passed t
 | `target(who, target, { queued })` | `target(who, target, queued=False)` | the right-click order: attack an enemy, gather a resource, repair your building |
 | `repair(who, target, { queued })` | `repair(who, target, queued=False)` | workers repair one of your buildings |
 | `gather(who, tile, { queued })` | `gather(who, tile, queued=False)` | workers gather the resource on a tile (from `nearestResource`) |
-| `build(who, building, at, { queued })` | `build(who, building, at, queued=False)` | workers place and build a building with its top-left at `at`; pays on placement |
+| `build(who, building, at, { queued })` | `build(who, building, at, queued=False)` | workers place and build a building with its top-left at `at` (the footprint must be in view); pays on placement |
 | `buildLine(who, building, from, to, { queued })` | `build_line(who, building, start, end, queued=False)` | a line of wall segments |
 | `train(building, unit, count = 1)` | `train(building, unit, count=1)` | queue units (pays now) |
 | `research(building, upgrade)` | `research(building, upgrade)` | queue an upgrade (pays now) |
@@ -475,6 +478,8 @@ Every order a bot can give, on `act` during a think (and on the builder passed t
 
 What happened to your player since the last think, in `events` (oldest first). Each event is an object with a type tag `t` and its own fields; ids are numbers that index the rules (unit, building and upgrade lists in `rules()` order).
 
+In a [custom game](custom.md), `events(slot)` returns the same events for any slot.
+
 | `t` | When |
 |---|---|
 | `trained` | one of your units finished training |
@@ -560,11 +565,35 @@ Ops after the first step still apply but make the game unreplayable.
 | `until(maxTicks, (observer, tick) => done)` | `until(max_ticks, lambda observer, tick: done)` | step until `done`; returns ticks taken or `-1` |
 | `view(slot)` | `view(slot)` | the fogged [view](view.md) of a slot |
 | `observer()` | `observer()` | the full view of everything, no fog |
+| `events(slot)` | `events(slot)` | the [events](events.md) that slot got since the last call, fog-filtered exactly as in a match |
+| `observerEvents()` | `observer_events()` | every event since the last call, unfiltered |
 | `game(slot)` | `game(slot)` | [queries](game.md) as that slot |
 | `map()` | `map()` | map size, starts, chokes, sites |
 | `replay()` | `replay()` | a [Replay](replay.md) of setup and orders so far |
 | `tick`, `winner` | `tick`, `winner` | current tick; winning slot once over |
 
+The first `events` call for a slot (or `observerEvents`) starts recording for it and returns `[]`, so call it once before stepping. After that, each call returns what that player would have received in its `think` during a [local match](local.md):
+
+```js
+import { CustomGame, rules } from "@pikehub/warpass-bot";
+
+const r = rules();
+const [a, b] = r.races;
+const g = new CustomGame({ seed: 5, races: [a, b] });
+const [x0, y0] = g.flattenArea(24, 12);
+const fighter = (race) => r.units.find((u) => u.race === race && !u.worker && u.attack);
+const ours = [0, 1, 2].map((k) => g.spawn(0, fighter(a).id, (x0 + 4) * 256, (y0 + 3 + k) * 256));
+[0, 1, 2].forEach((k) => g.spawn(1, fighter(b).id, (x0 + 10) * 256, (y0 + 3 + k) * 256));
+g.events(0);
+g.events(1);
+g.order(0, (act) => act.attackMove(ours, (x0 + 12) * 256, (y0 + 4) * 256));
+g.step(20 * 30);
+const mine = g.events(0);
+const theirs = g.events(1);
+console.log(`slot 0: ${mine.filter((e) => e.t === "hit").length} hits, ${mine.filter((e) => e.t === "death").length} deaths`);
+console.log(`slot 1: ${theirs.filter((e) => e.t === "hit").length} hits`);
+```
+
 <!-- api/replay.md -->
 
 # Replays
@@ -618,11 +647,11 @@ Static facts about the bundled engine, and these docs, from code.
 ```
 { engineVersion, races, resources, terrains: { name: id }, tile, ticksPerSecond, mapSize,
   units: [{ id, race, cost, supply, hp, speed, sight, trainTicks, trainedAt, requires, abilities, worker, lane, armor: { melee, pierce }, attack }],
-  buildings: [{ id, race, size, cost, hp, buildTicks, supply, trains, researches, requires, site }],
+  buildings: [{ id, race, size, cost, hp, buildTicks, supply, trains, researches, requires, site, armor: { melee, pierce }, attack }],
   upgrades: [{ id, race, cost, ticks, requires, group }] }
 ```
 
-`requires` is `{ buildings, anyBuildings, upgrades, anyUpgrades }` (ids). `attack` is `{ damage, range, minRange, cooldown, splash, onlyBuildings }` or `null`. Units of measure are in [../rules/index.md](../rules/index.md); the same data as tables is under `rules/`.
+`requires` is `{ buildings, anyBuildings, upgrades, anyUpgrades }` (ids). `attack` (units and buildings) is `{ damage, range, minRange, cooldown, splash, onlyBuildings }` or `null`. Units of measure are in [../rules/index.md](../rules/index.md); the same data as tables is under `rules/`.
 
 ```js
 import { docs, docsIndex } from "@pikehub/warpass-bot";
@@ -773,7 +802,7 @@ Every SDK call that fails throws a `WarpassError` with a `kind` and the fields b
 | `unauthenticated` | | the key is wrong, rotated, or the bot was deleted | create or rotate the key on the Developer page |
 | `refused` | `about`, `reason`, `message` | the server refused a request | see reasons below |
 | `cancelled` | `reason` | the offer fell through (`declined`, `timeout`, the rival left) or the host closed the lobby (`closed`) | queue again |
-| `closed` | `reason` | the socket closed and could not reconnect | connect again; `Warpass.join` resumes a running match |
+| `closed` | `reason` | the socket closed and could not reconnect, or you called `close()` (`stopped`) | connect again; `Warpass.join` resumes a running match |
 | `timeout` | | no answer in time (`result` waits 120 s by default) | retry `result()`; the match may still be sealing |
 | `network` | `message` | DNS, TLS or HTTP failure | check `url` and connectivity |
 
@@ -794,7 +823,7 @@ Errors from local games and custom games (unknown ids, setup ops off the map) ar
 
 <!-- rules/index.md -->
 
-# Rules for engine 62
+# Rules for engine 63
 
 Generated from the engine this SDK bundles. Every id below is what the view, the queries and the orders use.
 

package/docs/rules/index.md

@@ -1,4 +1,4 @@
-# Rules for engine 62
+# Rules for engine 63
 
 Generated from the engine this SDK bundles. Every id below is what the view, the queries and the orders use.
 

package/docs/rules/orcs.md

@@ -1,4 +1,4 @@
-# orcs (engine 62)
+# orcs (engine 63)
 
 Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
@@ -17,19 +17,19 @@ Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
 ## Buildings
 
-| id | size | cost | hp | build | supply | trains | researches | requires |
-|---|---|---|---|---|---|---|---|---|
-| skullHall | 4×4 | 275 wood, 150 stone | 2200 | 58.6 s | 10 | peon | grubRations, slaveDrivers | - |
-| burrow | 2×2 | 30 wood | 450 | 15.2 s | 8 | - | - | - |
-| mushroomBed | 3×3 | 55 wood | 200 | 10.3 s | 0 | - | - | - |
-| gutLarder | 2×2 | 100 wood | 550 | 19.3 s | 0 | - | - | - |
-| boneYard | 2×2 | 100 wood | 550 | 19.3 s | 0 | - | boneSaws | - |
-| goldPit | 2×2 | 100 wood | 550 | 19.3 s | 0 | - | deepPits | - |
-| spawningPit | 3×3 | 175 wood | 1000 | 24.1 s | 0 | - | broodMothers, feedingFrenzy, endlessHorde | all of burrow |
-| totemLodge | 3×3 | 175 wood, 50 gold | 1000 | 27.6 s | 0 | shaman, warDrummer, witchDoctor | bloodRites, deepTrance, bloodFrenzy | all of spawningPit |
-| fleshDen | 3×3 | 175 wood, 50 gold | 1000 | 27.6 s | 0 | fleshShaper, bonecaller, venomBrewer | thickHides, grislyMending, abomination | all of spawningPit |
-| bloodAltar | 2×2 | 125 wood, 50 stone | 800 | 24.1 s | 0 | - | jaggedIron, serratedIron, hideArmor, bonePlate | all of spawningPit |
-| spikeTower | 2×2 | 90 wood, 100 stone | 650 | 22.1 s | 0 | - | - | all of spawningPit |
+| id | size | cost | hp | armor m/p | attack | build | supply | trains | researches | requires |
+|---|---|---|---|---|---|---|---|---|---|---|
+| skullHall | 4×4 | 275 wood, 150 stone | 2200 | 3/5 | 4 dmg, range 7.0 tiles, every 2.0 s | 58.6 s | 10 | peon | grubRations, slaveDrivers | - |
+| burrow | 2×2 | 30 wood | 450 | 1/5 | - | 15.2 s | 8 | - | - | - |
+| mushroomBed | 3×3 | 55 wood | 200 | 0/0 | - | 10.3 s | 0 | - | - | - |
+| gutLarder | 2×2 | 100 wood | 550 | 1/5 | - | 19.3 s | 0 | - | - | - |
+| boneYard | 2×2 | 100 wood | 550 | 1/5 | - | 19.3 s | 0 | - | boneSaws | - |
+| goldPit | 2×2 | 100 wood | 550 | 1/5 | - | 19.3 s | 0 | - | deepPits | - |
+| spawningPit | 3×3 | 175 wood | 1000 | 1/7 | - | 24.1 s | 0 | - | broodMothers, feedingFrenzy, endlessHorde | all of burrow |
+| totemLodge | 3×3 | 175 wood, 50 gold | 1000 | 1/7 | - | 27.6 s | 0 | shaman, warDrummer, witchDoctor | bloodRites, deepTrance, bloodFrenzy | all of spawningPit |
+| fleshDen | 3×3 | 175 wood, 50 gold | 1000 | 1/7 | - | 27.6 s | 0 | fleshShaper, bonecaller, venomBrewer | thickHides, grislyMending, abomination | all of spawningPit |
+| bloodAltar | 2×2 | 125 wood, 50 stone | 800 | 2/7 | - | 24.1 s | 0 | - | jaggedIron, serratedIron, hideArmor, bonePlate | all of spawningPit |
+| spikeTower | 2×2 | 90 wood, 100 stone | 650 | 1/7 | 6 dmg, range 7.0 tiles, every 2.0 s | 22.1 s | 0 | - | - | all of spawningPit |
 
 ## Upgrades
 

package/docs/rules/templars.md

@@ -1,4 +1,4 @@
-# templars (engine 62)
+# templars (engine 63)
 
 Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
@@ -21,26 +21,26 @@ Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
 ## Buildings
 
-| id | size | cost | hp | build | supply | trains | researches | requires |
-|---|---|---|---|---|---|---|---|---|
-| keep | 4×4 | 300 wood, 175 stone | 2400 | 62.0 s | 10 | peasant | guildCharter, merchantGuilds, guildmasters, wheelbarrow, townWatch | - |
-| house | 2×2 | 30 wood | 550 | 17.2 s | 8 | - | - | - |
-| farm | 3×3 | 60 wood | 200 | 10.3 s | 0 | - | - | - |
-| granary | 2×2 | 100 wood | 600 | 20.6 s | 0 | - | horseCollar, heavyPlow | - |
-| lumberMill | 2×2 | 100 wood | 600 | 20.6 s | 0 | - | doubleBitAxe, bowSaw | - |
-| miningCamp | 2×2 | 100 wood | 600 | 20.6 s | 0 | - | goldMining, stoneMining | - |
-| barracks | 3×3 | 175 wood | 1200 | 27.6 s | 0 | spearman, swordsman | levyRights, drillYards, warhost | all of house |
-| archeryRange | 3×3 | 175 wood | 1200 | 27.6 s | 0 | archer, crossbowman | crossbowDrill, fireArrows | all of barracks |
-| blacksmith | 3×3 | 150 wood | 1200 | 27.6 s | 0 | - | forging, steel, mail, plate, fletching, bodkin, shieldWall, saltpeter | all of barracks |
-| stable | 3×3 | 175 wood | 1200 | 31.0 s | 0 | outrider, knight | squires, lanceCharge, knightsOrder | all of barracks |
-| chapel | 3×3 | 150 wood, 75 stone | 1000 | 27.6 s | 0 | cleric | sanctify | all of barracks |
-| masonsLodge | 3×3 | 150 wood, 50 stone | 1200 | 31.0 s | 0 | - | masterMasons, guardTowers, fortress | all of barracks |
-| siegeWorkshop | 3×3 | 200 wood | 1200 | 34.5 s | 0 | ram, mangonel, bombard | engineersCorps, siegeTrain, grandBattery | all of barracks |
-| powderMill | 3×3 | 150 wood, 100 stone | 1300 | 27.6 s | 0 | handgunner | volleyFire, arsenal | researched saltpeter |
-| palisade | 1×1 | 6 wood | 160 | 4.1 s | 0 | - | - | - |
-| stoneWall | 1×1 | 12 stone | 900 | 6.8 s | 0 | - | - | all of masonsLodge |
-| gate | 1×1 | 40 stone | 1200 | 10.3 s | 0 | - | - | all of masonsLodge |
-| watchtower | 2×2 | 75 wood, 125 stone | 700 | 24.1 s | 0 | - | - | all of barracks |
+| id | size | cost | hp | armor m/p | attack | build | supply | trains | researches | requires |
+|---|---|---|---|---|---|---|---|---|---|---|
+| keep | 4×4 | 300 wood, 175 stone | 2400 | 3/6 | 4 dmg, range 7.0 tiles, every 2.0 s | 62.0 s | 10 | peasant | guildCharter, merchantGuilds, guildmasters, wheelbarrow, townWatch | - |
+| house | 2×2 | 30 wood | 550 | 1/6 | - | 17.2 s | 8 | - | - | - |
+| farm | 3×3 | 60 wood | 200 | 0/0 | - | 10.3 s | 0 | - | - | - |
+| granary | 2×2 | 100 wood | 600 | 1/6 | - | 20.6 s | 0 | - | horseCollar, heavyPlow | - |
+| lumberMill | 2×2 | 100 wood | 600 | 1/6 | - | 20.6 s | 0 | - | doubleBitAxe, bowSaw | - |
+| miningCamp | 2×2 | 100 wood | 600 | 1/6 | - | 20.6 s | 0 | - | goldMining, stoneMining | - |
+| barracks | 3×3 | 175 wood | 1200 | 1/8 | - | 27.6 s | 0 | spearman, swordsman | levyRights, drillYards, warhost | all of house |
+| archeryRange | 3×3 | 175 wood | 1200 | 1/8 | - | 27.6 s | 0 | archer, crossbowman | crossbowDrill, fireArrows | all of barracks |
+| blacksmith | 3×3 | 150 wood | 1200 | 1/8 | - | 27.6 s | 0 | - | forging, steel, mail, plate, fletching, bodkin, shieldWall, saltpeter | all of barracks |
+| stable | 3×3 | 175 wood | 1200 | 1/8 | - | 31.0 s | 0 | outrider, knight | squires, lanceCharge, knightsOrder | all of barracks |
+| chapel | 3×3 | 150 wood, 75 stone | 1000 | 1/8 | - | 27.6 s | 0 | cleric | sanctify | all of barracks |
+| masonsLodge | 3×3 | 150 wood, 50 stone | 1200 | 2/8 | - | 31.0 s | 0 | - | masterMasons, guardTowers, fortress | all of barracks |
+| siegeWorkshop | 3×3 | 200 wood | 1200 | 1/8 | - | 34.5 s | 0 | ram, mangonel, bombard | engineersCorps, siegeTrain, grandBattery | all of barracks |
+| powderMill | 3×3 | 150 wood, 100 stone | 1300 | 1/8 | - | 27.6 s | 0 | handgunner | volleyFire, arsenal | researched saltpeter |
+| palisade | 1×1 | 6 wood | 160 | 0/3 | - | 4.1 s | 0 | - | - | - |
+| stoneWall | 1×1 | 12 stone | 900 | 6/8 | - | 6.8 s | 0 | - | - | all of masonsLodge |
+| gate | 1×1 | 40 stone | 1200 | 6/10 | - | 10.3 s | 0 | - | - | all of masonsLodge |
+| watchtower | 2×2 | 75 wood, 125 stone | 700 | 1/7 | 5 dmg, range 8.0 tiles, every 2.0 s | 24.1 s | 0 | - | - | all of barracks |
 
 ## Upgrades
 

package/docs/rules/witches.md

@@ -1,4 +1,4 @@
-# witches (engine 62)
+# witches (engine 63)
 
 Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
@@ -16,29 +16,29 @@ Generated from the bundled engine. Units of measure are in [index.md](index.md).
 
 ## Buildings
 
-| id | size | cost | hp | build | supply | trains | researches | requires |
-|---|---|---|---|---|---|---|---|---|
-| covenSpire | 4×4 | 300 wood, 175 stone | 2400 | 51.7 s | 10 | acolyte | spindleCarry, starChart, swiftLooms, seedstones, moonrise | - |
-| starlitCottage | 2×2 | 30 wood | 500 | 15.2 s | 8 | - | - | - |
-| moonGarden | 3×3 | 45 wood | 200 | 10.3 s | 0 | - | - | - |
-| stillroom | 2×2 | 100 wood | 600 | 20.6 s | 0 | - | herbLore, deepRoots | - |
-| sylvanLodge | 2×2 | 100 wood | 600 | 20.6 s | 0 | - | whisperingAxe, heartwood | - |
-| geodeVault | 2×2 | 100 wood | 650 | 20.6 s | 0 | - | veinSight, stoneSong | - |
-| wayshrine | 2×2 | 90 wood, 80 stone | 400 | 17.2 s | 4 | acolyte, moonblade, hexer | - | all of sanctum |
-| sanctum | 3×3 | 140 wood, 40 stone | 1150 | 27.6 s | 0 | moonblade, hexer | silverGlaives, moonsteel, wardedRobes, starweave, hexcraft, deepHexes | all of starlitCottage |
-| aerie | 3×3 | 110 wood, 75 gold | 1100 | 27.6 s | 0 | broomrider | tailwinds | all of sanctum |
-| observatory | 3×3 | 100 wood, 125 stone | 1100 | 31.0 s | 0 | astromancer | astralDrill, constellations, nightOfFallingStars, leyAttunement, wellspring, grandConvergence | all of starlitCottage |
-| atelier | 3×3 | 100 wood, 100 stone | 1100 | 27.6 s | 0 | weaver | bitterSoil, creepingMire, blightCrown, briarcraft, hollowGround, gardenOfThorns, wardMasonry, crystalLenses | all of starlitCottage |
-| gargoyleRoost | 2×2 | 80 wood, 60 stone | 800 | 24.1 s | 0 | - | - | all of starlitCottage |
-| wardstone | 2×2 | 120 stone, 20 gold | 550 | 20.6 s | 0 | - | - | all of sanctum |
-| hexSpire | 2×2 | 150 stone, 75 gold | 600 | 27.6 s | 0 | - | - | all of atelier |
-| starfallBeacon | 3×3 | 250 stone, 150 gold | 900 | 37.9 s | 0 | - | - | all of observatory |
-| leyObelisk | 1×1 | 60 stone, 40 gold | 250 | 13.8 s | 0 | - | - | all of sanctum |
-| hexCircle | 3×3 | 50 stone, 100 gold | 300 | 17.2 s | 0 | - | - | all of atelier |
-| thornSnare | 1×1 | 25 wood, 15 gold | 60 | 6.8 s | 0 | - | - | all of sanctum |
-| briarHedge | 1×1 | 8 wood | 220 | 4.1 s | 0 | - | - | - |
-| moonstoneWall | 1×1 | 14 stone | 850 | 6.8 s | 0 | - | - | all of atelier |
-| moonGate | 1×1 | 40 stone | 1100 | 10.3 s | 0 | - | - | all of atelier |
+| id | size | cost | hp | armor m/p | attack | build | supply | trains | researches | requires |
+|---|---|---|---|---|---|---|---|---|---|---|
+| covenSpire | 4×4 | 300 wood, 175 stone | 2400 | 3/5 | 4 dmg, range 7.0 tiles, every 2.0 s | 51.7 s | 10 | acolyte | spindleCarry, starChart, swiftLooms, seedstones, moonrise | - |
+| starlitCottage | 2×2 | 30 wood | 500 | 1/6 | - | 15.2 s | 8 | - | - | - |
+| moonGarden | 3×3 | 45 wood | 200 | 0/0 | - | 10.3 s | 0 | - | - | - |
+| stillroom | 2×2 | 100 wood | 600 | 1/6 | - | 20.6 s | 0 | - | herbLore, deepRoots | - |
+| sylvanLodge | 2×2 | 100 wood | 600 | 1/6 | - | 20.6 s | 0 | - | whisperingAxe, heartwood | - |
+| geodeVault | 2×2 | 100 wood | 650 | 1/6 | - | 20.6 s | 0 | - | veinSight, stoneSong | - |
+| wayshrine | 2×2 | 90 wood, 80 stone | 400 | 1/5 | - | 17.2 s | 4 | acolyte, moonblade, hexer | - | all of sanctum |
+| sanctum | 3×3 | 140 wood, 40 stone | 1150 | 1/8 | - | 27.6 s | 0 | moonblade, hexer | silverGlaives, moonsteel, wardedRobes, starweave, hexcraft, deepHexes | all of starlitCottage |
+| aerie | 3×3 | 110 wood, 75 gold | 1100 | 1/8 | - | 27.6 s | 0 | broomrider | tailwinds | all of sanctum |
+| observatory | 3×3 | 100 wood, 125 stone | 1100 | 1/8 | - | 31.0 s | 0 | astromancer | astralDrill, constellations, nightOfFallingStars, leyAttunement, wellspring, grandConvergence | all of starlitCottage |
+| atelier | 3×3 | 100 wood, 100 stone | 1100 | 1/8 | - | 27.6 s | 0 | weaver | bitterSoil, creepingMire, blightCrown, briarcraft, hollowGround, gardenOfThorns, wardMasonry, crystalLenses | all of starlitCottage |
+| gargoyleRoost | 2×2 | 80 wood, 60 stone | 800 | 2/8 | - | 24.1 s | 0 | - | - | all of starlitCottage |
+| wardstone | 2×2 | 120 stone, 20 gold | 550 | 1/6 | 4 dmg, range 7.0 tiles, every 1.6 s | 20.6 s | 0 | - | - | all of sanctum |
+| hexSpire | 2×2 | 150 stone, 75 gold | 600 | 1/7 | 5 dmg, range 8.0 tiles, every 2.5 s | 27.6 s | 0 | - | - | all of atelier |
+| starfallBeacon | 3×3 | 250 stone, 150 gold | 900 | 2/8 | 30 dmg, range 11.0 tiles, every 6.0 s | 37.9 s | 0 | - | - | all of observatory |
+| leyObelisk | 1×1 | 60 stone, 40 gold | 250 | 0/4 | - | 13.8 s | 0 | - | - | all of sanctum |
+| hexCircle | 3×3 | 50 stone, 100 gold | 300 | 0/2 | - | 17.2 s | 0 | - | - | all of atelier |
+| thornSnare | 1×1 | 25 wood, 15 gold | 60 | 0/2 | - | 6.8 s | 0 | - | - | all of sanctum |
+| briarHedge | 1×1 | 8 wood | 220 | 0/3 | - | 4.1 s | 0 | - | - | - |
+| moonstoneWall | 1×1 | 14 stone | 850 | 5/8 | - | 6.8 s | 0 | - | - | all of atelier |
+| moonGate | 1×1 | 40 stone | 1100 | 5/10 | - | 10.3 s | 0 | - | - | all of atelier |
 
 ## Upgrades