Formal Specification
Cymbergaj (Polish Tabletop Coin Hockey) — Formal Specification
Poland · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 0
# Cymbergaj — AI-optimized specification
## General idea
A turn-based 2D physical billiard/hockey duel on a bounded rectangular surface. Agents alternate applying impulse vectors to their respective striker coins to trigger elastic collisions with a target puck coin, aiming to ricochet the puck into the opposing goal mouth while avoiding boundary fouls.
## Formal model
- **Abstraction taken:** The comb-strike impulse is modeled as a 2D vector applied to the active agent's striker coin . Coin-to-coin collisions (striker vs. ball , striker vs. opponent striker ) and coin-to-border reflections are resolved using standard 2D rigid-body elastic collision dynamics with Coulomb sliding friction.
- **Player/agent count:** 2 agents (Agent 0, Agent 1).
- **Turn model:** Strictly alternating sequential turns.
## Formal rules
R1. **Table geometry & setup:** Table is a bounded 2D box (). Goals span at (Goal 0) and (Goal 1). Ball coin starts at center . Striker 0 starts at ; Striker 1 starts at . Target score goals.
R2. **Action execution:** On agent 's turn, agent chooses `strike(power: Float[0..1], angle_rad: Float[0..2\pi])`.
- Strike applies initial velocity to coin .
R3. **Physics integration:**
- Positions integrate forward in time under deceleration .
- Elastic collisions between coins resolve conservation of linear momentum.
- Table borders reflect coins elastically ().
- Simulation stops when all coins reach velocity 0.
R4. **Goal & foul scoring:**
- **Goal scored:** If ball coin enters Goal 1: Agent 0 scores point. If enters Goal 0: Agent 1 scores point. Positions reset to R1 setup.
- **Off-table foul:** If any coin exits the table boundary outside the goal mouths: The innocent opponent is awarded a free direct strike with the ball placed on the center spot.
- **Empty move (*Pusty ruch*):** If fails to collide with ball : No penalty; turn simply passes to opponent.
R5. **Turn transfer:** After all coins stop and fouls are resolved, active turn passes to .
R6. **Victory condition:** The first agent to score goals wins immediately.
## Edge cases
- **Tie at the end condition:** Not applicable; goals increment monotonically until one agent reaches exactly 5 goals.
- **A player with no legal move:** Not applicable; `strike(power, angle)` is always legally available in any continuous direction.
- **Repetition / cycles:** Bounded because any goal event strictly advances the score, and random shot dispersion guarantees non-zero probability of goal scoring across turns.
- **Simultaneous claims on the same resource or position:** Rigid-body collision physics prevents coins from overlapping in space.
- **Player elimination mid-round; turn order repair:** Not applicable; fixed 2-agent duel.
- **Resource exhaustion:** Not applicable; coins and table are persistent.
- **Termination guarantee:** The game state is an absorbing Markov chain over score pairs whose absorbing boundary is reached with probability 1.
## State representation
- **Persistent state:** `scores` (Pair[Int, Int]), `active_agent_id` (0..1).
- **Continuous spatial state:** `pos_C0` (Coord2D), `pos_C1` (Coord2D), `pos_Ball` (Coord2D).
- **Observable information:** Fully observable state; all coin positions, table dimensions, and scores are common knowledge.
## Action space
- `strike(power: Float[0.05..1.0], angle_rad: Float[0..2\pi])`: Impulse vector applied to the agent's striker coin.
## Playability notes
- **Single-player-vs-AI:** Highly natural — tactical tabletop billiard duel against AI evaluating geometric bank shots and defensive positioning.
- **Group games (n>4):** Solitaire tournament bracket of 1v1 duels.
- **Physical-skill games:** Finger-comb tactile pressure modeled via Gaussian dispersion on intended strike vector .
- **What is lost:** Plastic comb tooth vibration, ruler flexibility, and table surface wood-grain texture.
## Implementation hints
Standard 2D circular rigid-body physics integrator (3 circle objects on a bounded box). First milestone: implement 2D elastic collision and bank reflection, then write the turn-based referee state machine tracking goal events and score resets.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Cymbergaj (Polish Tabletop Coin Hockey) (Poland). (n.d.). Games of Countries. https://gamesofcountries.com/games/pl-poland/cymbergaj
@misc{gamesofcountries-pl-poland-cymbergaj,
title = {Cymbergaj (Polish Tabletop Coin Hockey) (Poland)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/pl-poland/cymbergaj}
}