Formal Specification
Canokes (Manx Ring Marbles) — Formal Specification
Isle of Man · dexterity-throw · Confidence: high
← Back to game pageImplementation 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 with . 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:** agents (, 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 . Each agent holds 1 unique shooter . Score counters .
R2. Shot Selection: Active agent shoots from position (perimeter or current resting location of ) along aim vector with power .
R3. Physics & Ejection Resolution:
- Collision dynamics update positions of and impacted target marbles.
- Any target marble whose final coordinate satisfies is removed from play; agent claims the marble ().
- Opponent elimination: If strikes an opponent shooter resting inside and knocks it outside (or strikes it directly), agent is eliminated from the current round, and agent scores bonus points.
R4. Turn Continuance & Handover:
- If at least 1 marble was ejected on the shot: Agent retains the turn and shoots again from 's new resting position.
- If zero marbles were ejected: Agent 's turn ends; turn passes to agent .
R5. Win condition: When all 13 target marbles have been cleared from , the agent with the highest score 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 , active player index , eliminated player flags.
- Per-shot state: Shooter positions , active target marble coordinates , chain shot counter.
- Observable information: Fully observable public game.
## Action space
- `shoot_marble(angle, power)`: Select release angle and impulse power .
## 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 JSONCite 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}
}