Formal Specification
Carrom — Formal Specification
Singapore · dexterity-small · Confidence: high
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Carrom — AI-optimized specification
## General idea
Carrom is a turn-based 2D physics tabletop billiards game on a square wooden board with four corner pockets. Players flick an acrylic striker from a designated baseline to pot designated carrom men (White vs. Black) and the high-value red Queen into corner pockets, maintaining turn momentum through successful pots while avoiding striker fouls.
## Formal model
- **Abstraction taken:** The continuous 2D board plane ( cm) with 4 corner pockets of radius cm. Friction, restitution, and disc-disc collisions are solved numerically, with aim parameterized by baseline position , strike angle , and force .
- **Player/agent count:** 2 agents (Player 1 = White, Player 2 = Black).
- **Turn model:** Alternating turns, with turn continuation granted on every valid piece pocketed.
## Formal rules
R1. Setup: 19 pieces (9 White, 9 Black, 1 Red Queen) arranged in central circular formation. P1 begins with first strike from P1 baseline.
R2. Active Shot Execution: The active agent chooses baseline position , strike angle , and impulse .
R3. Collision, Friction & Pocketing Dynamics:
- 2D multi-disc rigid body collision simulation runs until all pieces come to rest.
- Any piece whose center enters a corner pocket boundary is pocketed (*in_pocket*).
R4. Queen Covering Mechanism:
- If the active agent pockets the Queen, `queen_pending_cover` .
- The agent must pocket one of their designated colored pieces on that shot or the immediate subsequent shot.
- If covered, `queen_covered_by` .
- If the cover shot fails, the Queen is respawned at the board center circle, and the turn ends.
R5. Foul Resolution:
- If the striker disc enters a pocket (*striker foul*), the active player suffers a penalty: 1 previously pocketed friendly piece is respawned at the center, and the turn terminates immediately.
R6. Turn Continuation:
- If at least one friendly piece (or valid Queen pot) occurs without a foul, the active agent retains the turn.
- Otherwise, the turn passes to the opponent.
R7. Board Win & Scoring:
- When all pieces of one color are pocketed, the board ends.
- The winner scores 1 point per remaining unpocketed opponent piece, plus 3 bonus points if the winner claimed the Queen.
R8. Match Termination: [gap-fill] Match is won by the first agent to reach 25 cumulative points (or highest points after 8 boards). A maximum of 30 shots per board prevents indefinite looping.
## Edge cases
- Tie at the end condition: If both players reach equal points after 8 boards, a single sudden-death board is played.
- A player with no legal move: If all pieces of an agent's color are blocked or on the baseline, the agent can still legally shoot at any bank or piece.
- Repetition / cycles: Bounded by the 30-shot cap per board [gap-fill].
- Simultaneous claims on the same resource or position: Turns are strictly sequential; multi-piece collision order is resolved deterministically by the physics engine.
- Player elimination mid-round: Board ends when all 9 pieces of one color are potted.
- Resource exhaustion: Conserved count of 19 pieces.
- Termination guarantee: Monotonic pocketing of finite pieces guarantees board completion within finite shots, bounded by the 30-shot limit.
## State representation
- Persistent state:
- `match_scores`: array of size 2 (integers ).
- `board_number`: integer .
- `shot_counter`: integer .
- Per-board state:
- `piece_positions`: array of 19 2D coordinates (or `POCKETED`).
- `piece_types`: array of 19 types .
- `active_player`: integer .
- `queen_status`: enum .
- Observable information: Fully observable to both agents.
## Action space
- `strike(baseline_x, angle, power)`:
- `baseline_x` cm.
- `angle` radians.
- `power` .
## Playability notes
- Single-player-vs-AI: Exceptional; AI computes geometric bank shots and evaluates potting probabilities using raycasting.
- Group games (n>4): Adaptable to 2v2 doubles by alternating shots among 4 fixed seats.
- Physical-skill games: Finger flick accuracy is modeled with Gaussian noise applied to angle and power.
- What is lost: Powder dusting texture on wood grain, fingernail rebound sensations, and tactile micro-spin.
## Implementation hints
Standard 2D rigid-body disc physics with circle-circle elastic collision impulse resolution and linear drag deceleration.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Carrom (Singapore). (n.d.). Games of Countries. https://gamesofcountries.com/games/sg-singapore/carrom
@misc{gamesofcountries-sg-singapore-carrom,
title = {Carrom (Singapore)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/sg-singapore/carrom}
}