Seafarers: interaction tests, rules and UI docs
This commit is contained in:
@@ -0,0 +1,71 @@
|
||||
# Katan: Seafarers
|
||||
|
||||
The Seafarers rule set is chosen at setup next to *Base game* and *Cities & Knights*. It is the base
|
||||
game ([RULES-catan.md](RULES-catan.md)) with a sea, ships, a pirate, gold fields and islands to
|
||||
settle. Code: `game/catan/CatanSeaRules.kt` (the additions), `CatanSeaBoard.kt` (the map),
|
||||
`CatanBoard.kt` (`Topology`, the geometry shared by every map), state behind `CatanState.sea`
|
||||
(null in the other rule sets). It cannot be combined with Cities & Knights.
|
||||
|
||||
Where the published rules leave room, or where this game differs, it says so below.
|
||||
|
||||
## The map
|
||||
|
||||
One map, *Heading for New Shores*: a large **home island** (21 hexes, one desert) and three small
|
||||
islands (3, 3 and 2 hexes) across the water, inside a ring of sea. Which land hexes are gold, which
|
||||
are the desert and where the sea lies is fixed; the **resources on the other hexes, the number tokens
|
||||
and the nine harbours are shuffled** for each game. The red numbers (6, 8) are never on neighbouring
|
||||
hexes. Players take three or four seats; the default target is **12 points** (menu: 8, 10, 12, 14).
|
||||
|
||||
The geometry is the same lattice as the base island, generalised (`Topology`): a hex is land or sea,
|
||||
a crossing can hold a town if any hex touching it is land, an edge can hold a road if any hex touching
|
||||
it is land and a ship if any hex touching it is sea (so a coastal edge takes either, never both).
|
||||
|
||||
## What changes
|
||||
|
||||
**Setup.** Both starting settlements (and their roads) go on the home island. A starting piece is a
|
||||
road, never a ship. The second settlement collects from the hexes round it as usual (gold pays nothing
|
||||
at setup).
|
||||
|
||||
**Ships.** A ship costs 1 lumber and 1 wool and lies on a sea edge.
|
||||
|
||||
* It must join your fleet or a town of yours: one end of the edge touches your town, or another of your ships.
|
||||
An opponent's town is a wall.
|
||||
* Roads and ships connect **only at a town of your own**: a road cannot start from a ship's end, nor a
|
||||
ship from a road's, unless a settlement or city of yours stands on that crossing. A settlement may be
|
||||
built at the end of a ship route exactly as at the end of a road route.
|
||||
* No more than 15 ships. Road Building may lay two roads, two ships or one of each.
|
||||
* **Sailing.** Once per turn you may move one ship, never one built or moved this turn, and only a ship at the
|
||||
**open end** of a route (one end touches nothing else of yours). It goes to any edge it could be built on
|
||||
with it lifted off.
|
||||
|
||||
**The pirate.** Starts in the open sea. On a seven (and with a Knight card) the player moves either the
|
||||
robber, to any land hex, or the pirate, to any sea hex. The robber works as before. The pirate **blocks the six
|
||||
edges round its hex**: no ship may be built or sail onto them (ships already there stay). It robs one card
|
||||
at random from a player with a ship on an edge of its hex.
|
||||
|
||||
**Gold.** A gold field has a number like any hex. When it comes up, each town beside it (one card; a city two)
|
||||
pays its owner **any resource of their choice**, chosen after the ordinary production is dealt, in seat order from
|
||||
the roller. The robber blocks a gold field like any hex. If the bank cannot supply the choice it is limited to
|
||||
what it holds.
|
||||
|
||||
**New islands.** The first player to settle on each island other than the home island scores **2 bonus points**,
|
||||
permanently (`SeaState.islandBonus`). A second settlement there earns nothing extra.
|
||||
|
||||
**Longest route.** Longest Road counts roads and ships together, as a path of your pieces that never runs
|
||||
through an opponent's town and changes between road and ship only at a town of yours. Five or more, as before.
|
||||
|
||||
Everything else (development cards, trading, harbours, Largest Army, the discard on a seven) is the base game.
|
||||
|
||||
## Not included
|
||||
|
||||
The physical expansion has more scenarios and the Catan Universe app adds more still. These are **out of scope here**:
|
||||
fog islands, treasure islands, the oasis, the great canal, the Explorers & Pirates and Cities & Knights combinations,
|
||||
the scenarios after the first, and trade ships. The `SeaScenario` enum and `SeaBoards` are built so a second map
|
||||
is a new text map and a new enum entry.
|
||||
|
||||
## How the AI plays it
|
||||
|
||||
It settles first and sails second. A ship is built when a settlement spot reachable by sea (up to five steps from its
|
||||
open end) is worth having, with a bonus for an island nobody has landed on, and ahead of a development card when that
|
||||
bonus is in play. It chooses the resource it values most from gold, always moves the robber (never the pirate) and does
|
||||
not sail ships it has already launched. See `CatanAi.shipValue`.
|
||||
@@ -192,3 +192,19 @@ Landscape screens use the control scheme of Catan Universe's match view, redrawn
|
||||
ratio under the *give* card. An offer made to you opens the same panel read-only: ✓ accepts,
|
||||
✕ declines, *Counter…* makes the rows editable.
|
||||
Cities & Knights goods trades and the counter-offer chooser still use dialogs.
|
||||
|
||||
## Seafarers on the screen
|
||||
|
||||
| Layer | What it adds |
|
||||
| --- | --- |
|
||||
| `CatanGeometry.kt` | `BoardLayout` and `CatanGeometry.fit` take the game's `Topology`, so a map of islands fits the box like the standard island does |
|
||||
| `CatanStyle.kt` | gold-field colour, the pirate's and the ship sail's colours |
|
||||
| `CatanBoardView.kt` | sea hexes (a faint grid, no fill), ships (hull with a sail), the pirate (a flagged hull), a ring on ships that can sail |
|
||||
| `CatanInteraction.kt` | `BuildKind.SHIP`; `PickShip`, `movingShip`, ship targets; the robber's and the pirate's hexes; `goldMove` |
|
||||
| `CatanDialogs.kt` | `CatanGoldDialog`, the choice of what a gold field pays |
|
||||
| `CatanScreen.kt` | the picked-up ship, the ship on the build menu / column |
|
||||
|
||||
**Interaction model.** Arm *Ship* (or drag it from the build column) and tap a lit sea edge: ✓ places it. To sail,
|
||||
tap one of your ships that has a ring, then a lit sea edge. After a seven, tap a land hex for the robber or a sea
|
||||
hex for the pirate. A gold field opens a dialog that cannot be dismissed. `CatanSeafarersInteractionTest` checks
|
||||
that every build and sail the engine offers has a tap that produces it.
|
||||
|
||||
Reference in New Issue
Block a user