Skip to main content
Formal Specification

Canokes (Manx Ring Marbles) — Formal Specification

Isle of Man · dexterity-throw · Confidence: high

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Canokes — AI-optimized specification ## General idea A turn-based 2D precision ring-clearing game based on traditional Manx ring marbles. Agents aim a heavier shooter marble (*taw*) at a cluster of 13 target marbles (*mibs*) positioned inside a circular ring, striving to maximize marble exits, chain consecutive extra shots, and avoid leaving their shooter vulnerable inside the ring to avoid the losing penalty. ## Formal model - **Abstraction taken:** The 2D ring is represented as a circular domain D={p∈ℝ2:‖p‖≤Rring} with Rring=0.6 m. Physical shot trajectories and elastic multi-body collisions are resolved via 2D vector momentum equations parameterized by aim vector and release force. - **Player/agent count:** N agents (N≥2, standard 2 to 4). - **Turn model:** Sequential turn rotation with chain-extension mechanics: an agent retains the active turn as long as at least 1 target marble is successfully ejected from the ring per shot. ## Formal rules R1. Setup: 13 target marbles initialized in cross pattern at ring center with coordinates Ctarget⊂D. Each agent holds 1 unique shooter Ti. Score counters Si=0. R2. Shot Selection: Active agent i shoots from position pshot (perimeter or current resting location of Ti) along aim vector v→=(vx,vy) with power P∈[0.5,1.0]. R3. Physics & Ejection Resolution: - Collision dynamics update positions of Ti and impacted target marbles. - Any target marble mj whose final coordinate satisfies ‖pj‖>Rring is removed from play; agent i claims the marble (Si←Si+1). - Opponent elimination: If Ti strikes an opponent shooter Tk resting inside D and knocks it outside D (or strikes it directly), agent k is eliminated from the current round, and agent i scores +2 bonus points. R4. Turn Continuance & Handover: - If at least 1 marble was ejected on the shot: Agent i retains the turn and shoots again from Ti's new resting position. - If zero marbles were ejected: Agent i's turn ends; turn passes to agent i+1(modN). R5. Win condition: When all 13 target marbles have been cleared from D, the agent with the highest score Si wins the match. R6. Canokes Loser Penalty: The agent with the lowest score is designated the loser. R7. [gap-fill] Turn cap: If marbles remain after 30 total turns, the round terminates; highest score wins. ## Edge cases - Tie at the end condition: If top scores are tied, a 1-shot lag contest toward the perimeter determines the winner. - A player with no legal move: Not applicable — aiming in any 2D vector direction is always available. - Repetition / cycles: Bounded by monotonic reduction of the 13 target marbles and hard 30-turn cap (R7). - Simultaneous claims on the same resource or position: Resolved sequentially during the physics collision resolution tick. - Player elimination mid-round; turn order repair: If an agent's shooter is knocked out, they are skipped in turn rotation; turn order proceeds to the next active agent. - Resource exhaustion: Exactly 13 target marbles; game ends when all are cleared (R5). - Termination guarantee: Provably terminates in at most 30 turns due to turn cap and target marble depletion. ## State representation - Persistent state: Scores array [S1,…,SN], active player index i, eliminated player flags. - Per-shot state: Shooter positions [T1,…,TN], active target marble coordinates {p1,…,pm}, chain shot counter. - Observable information: Fully observable public game. ## Action space - `shoot_marble(angle, power)`: Select release angle θ∈[0,2π) and impulse power P∈[0.1,1.0]. ## Playability notes - Single-player-vs-AI: Natural — player takes shots against AI agents running ray-tracing targeting heuristics to maximize pocket angle projections. - Group games (n>4): Extends smoothly to multi-agent schoolyard circles. - Physical-skill games: Abstracted to 2D vector aim selection and risk management. - What is lost: The chalk on schoolboy trousers, polished agates in cloth pockets, and the sting of knuckle punishment. ## Implementation hints Standard 2D multi-particle elastic collision simulation inside a circle. First milestone: implement 2-body elastic collision between shooter and 1 target marble with boundary escape detection.

Download as JSON

Download the full game corpus entry for this game as structured JSON.

Download JSON
Cite this page

Canokes (Manx Ring Marbles) (Isle of Man). (n.d.). Games of Countries. https://gamesofcountries.com/games/im-isle-of-man/canokes

@misc{gamesofcountries-im-isle-of-man-canokes,
  title = {Canokes (Manx Ring Marbles) (Isle of Man)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/im-isle-of-man/canokes}
}