Files
ProLibertateGames/docs/RULES-golf.md
T
Claude 532c3ea48a Add President and Golf
Two more games on the existing framework — no changes were needed to the
lobby, networking, settings or update layers, which is what the shared
GameRules/GameAi contract was for.

President
- Threes low, twos high. Lead any number of one rank; follow with the
  same count of a higher rank, or pass. When everyone has passed the
  pile comes down and the last player to play leads again.
- Toggles: player count, rounds, twos clear the pile, four of a kind
  bombs, and the between-round card exchange.
- Plays are offered as whole sets rather than by selecting cards. A set
  is the unit of the game, so choosing from the legal sets is both
  easier to operate and impossible to get wrong.

Golf
- 4, 6 or 9 card grids. Draw from stock or discard, then either swap the
  card in or — only if it came off the stock — throw it and turn one of
  your own over. A card taken from the discard pile has to be used.
- Matching columns cancel to nothing; on the 3x3 board rows do too, but
  not on the shallower grids where three cards are not a line.
- Face-down cards are hidden from everyone including their owner, which
  is the point of the game: viewFor masks them with a fixed placeholder
  so the real card never reaches the device that has not turned it over.

Both engines are pure Kotlin and unit tested — 71 tests now, covering
ranking, legal moves, pile and hole resolution, scoring, redaction, wire
round-trips, and full random and AI playthroughs. The Golf test also
checks the AI actually beats random play rather than merely being legal.

Also widened the setup screen's option chips to wrap: the reveal-count
row carries up to ten, and a chip off the edge of the screen is a
setting that cannot be changed — the same failure as the Euchre Pass
button.

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_015qjfMiPUDshdKEUa6vxqzN
2026-08-06 03:25:09 +00:00

2.4 KiB
Raw Blame History

Golf — implemented rules

This is the ruleset the engine enforces. Anything marked toggle is in the game setup screen. Lowest score wins, as on a golf course.

Table

  • 2 to 6 players — toggle.

  • Each player gets a grid of face-down cards — toggle:

    Cards Layout
    4 2 rows of 2
    6 2 rows of 3
    9 3 rows of 3
  • Seen at the start — toggle. How many of your own cards you may look at before play begins; two by default. They are the leftmost cards of the top row, so everyone starts with the same shape of knowledge.

  • One card is turned up to start the discard pile; the rest is the stock.

  • Six players on the 9-card board needs more cards than a deck holds, so two decks are shuffled together whenever the deal would exceed 24 cards.

A turn

Draw one card, from either the stock or the top of the discard pile.

Then place it, in one of two ways:

  • Swap it in. Put it into any grid slot, face up, and throw out whatever was there. That slot is now face up for the rest of the hole.
  • Throw it away and turn one of your own over. Only available for a card taken from the stock — a card picked up off the discard pile has to be used.

Ending a hole

The first player to have their whole grid face up closes the hole, and everyone else gets exactly one more turn. Then every card is turned up and scored.

If the stock runs out it is refilled by shuffling the discard pile, keeping its top card in play. If there is nothing left to recycle, the hole ends there.

Scoring

Card Value
King 0
Ace 1
Two −2
Jack, Queen 10
3 to 10 face value

A column of matching ranks cancels to nothing. That is the whole tactical point: a pair of jacks in a column costs nothing instead of twenty.

On the 3×3 board, matching rows cancel as well. On the shallower boards they do not — a "row" of three unrelated cards is not a line in a two-row grid.

Scores accumulate over the holes — toggle for 3, 6 or 9 — and the lowest total wins.

Known simplifications

  • No jokers. Some house rules add them as −5 or wild. Adding a joker means adding a rank to the shared card model, which every other game would then have to account for, so it is left out rather than bolted on.
  • No knocking, and no separate penalty for a failed knock.
  • Nothing is peeked at mid-hole; the only way to learn a card is to turn it over.