territory claiming

2026-05-18 15:40:15 -05:00
parent 37a46a7b36
commit 3167558e04
5 changed files with 127 additions and 4 deletions
@@ -7,7 +7,7 @@ Tracks hex locations for the territory map.
 - `GET /api/locations` List visible locations for USER/SUPER, all known locations for SUPER.
 - `GET /api/locations?minQ=-7&maxQ=7&minR=-7&maxR=7` List a coordinate range, constrained by visibility for USER.
 - `GET /api/locations/{q}/{r}` Fetch one visible location for USER, any known location for SUPER.
- `POST /api/locations/claim` Claim a location for the authenticated user.
+- `POST /api/locations/claim` Claim visible unclaimed territory for the authenticated user. Normal players spend one completed Scout.
 - `GET /api/locations/home` Get the authenticated user's home location.
 - `POST /api/locations/home` Assign or return the authenticated user's home location.
 - `GET /api/locations/visible` Get locations visible to the authenticated user.
@@ -33,4 +33,5 @@ minute. Generation is applied lazily when the resource record is read.

 Unit training is stored server-side in the `UnitTraining` collection. The first
 unit type is `Scout`, which costs 50 gold and takes 60 seconds to train.
-Finished training is completed lazily when unit state is read.
+Finished training is completed lazily when unit state is read. Claiming an
+unclaimed visible location consumes one completed Scout.