Skip to main content
Formal Specification

Cymbergaj (Polish Tabletop Coin Hockey) — Formal Specification

Poland · dexterity-small · Confidence: low

← Back to game page

Implementation 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 F→=(fx,fy) applied to the active agent's striker coin Ci. Coin-to-coin collisions (striker Ci vs. ball B, striker Ci vs. opponent striker Cj) 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 [0,W]×[0,H] (W=1.0 m,H=0.6 m). Goals span y∈[0.225,0.375] at x=0 (Goal 0) and x=W (Goal 1). Ball coin B starts at center (0.5,0.3). Striker 0 starts at (0.25,0.3); Striker 1 starts at (0.75,0.3). Target score Starget=5 goals. R2. **Action execution:** On agent i's turn, agent i chooses `strike(power: Float[0..1], angle_rad: Float[0..2\pi])`. - Strike applies initial velocity v→0=sample_vector(power,angle,skill) to coin Ci. R3. **Physics integration:** - Positions integrate forward in time Δt under deceleration a=−μg. - Elastic collisions between coins resolve conservation of linear momentum. - Table borders reflect coins elastically (v⟂←−e⋅v⟂). - Simulation stops when all coins reach velocity 0. R4. **Goal & foul scoring:** - **Goal scored:** If ball coin B enters Goal 1: Agent 0 scores +1 point. If B enters Goal 0: Agent 1 scores +1 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 Ci fails to collide with ball B: No penalty; turn simply passes to opponent. R5. **Turn transfer:** After all coins stop and fouls are resolved, active turn passes to (i+1)mod2. R6. **Victory condition:** The first agent to score Starget=5 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 (x,y) 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 (S0,S1)∈{0..5}2 whose absorbing boundary max⁡(S0,S1)=5 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 (v→0). - **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 JSON
Cite 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}
}