Formal Specification
Gibraltar Llanito Marbles — Formal Specification
Gibraltar · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Golis (Canicas) — AI-optimized specification
## General idea
A turn-based 2D precision marble game where agents alternate taking flick shots. An agent must first sink their marble into a central target hole to enter "Hunter" status, after which they can target and capture opponents' marbles via direct collision.
## Formal model
- **Abstraction taken:** The 2D continuous surface physics (soil friction, spin, and marble collisions) are modeled on a bounded 2D plane `[-R, +R] x [-R, +R]`. Shot execution is parameterized by an aim vector and Gaussian dispersion proportional to distance and agent skill.
- **Player/agent count:** 2 to 6 individual agents.
- **Turn model:** Sequential turn rotation with conditional consecutive turn extensions upon successful strikes.
## Formal rules
R1. Setup: Ground hole is centered at `Hole = (0.0, 0.0)` with radius `r_hole = 0.05` meters. Each player `i` controls one marble at position `pos[i]` and status `status[i] = UNQUALIFIED`. Score starts at 0.
R2. On their turn, an active agent `i` chooses an aim vector `(tx, ty)` and power `w in [0, 1]`.
R3. Shot resolution:
R3.1. Marble trajectory and stopping coordinate `pos_new` are sampled: `pos_new ~ Normal(target, sigma(skill, dist))`.
R3.2. If `status[i] == UNQUALIFIED` and `||pos_new - Hole|| <= r_hole`: Agent `i`'s status becomes `HUNTER`, and agent `i` receives an immediate bonus shot from `Hole`.
R3.3. If `status[i] == HUNTER`: Collision checks are performed along the trajectory against all opposing marbles `j`.
R3.4. If marble `j` is struck: Agent `i` captures marble `j` (`captured[j] = true`), scores 1 point, and receives an immediate bonus shot from the point of impact.
R3.5. If no capture or qualification occurs, the active turn ends and passes to the next player.
R4. [gap-fill] Boundary containment: If a marble rolls outside the arena perimeter `R = 3.0` meters, it is placed at the perimeter intersection point.
R5. Win condition: The game terminates when all opposing marbles are captured, or when an agent captures a target threshold `Win_Captures = 3`.
R6. [gap-fill] Inactivity watchdog: If 40 full turn rotations pass without a capture, the agent with the highest score wins.
## Edge cases
- Tie at the end condition: Resolved via watchdog round cap (R6) or sudden-death shootout at the hole.
- A player with no legal move: Not applicable — shooting the marble is always available.
- Repetition / cycles: Bounded by R6 watchdog limit and finite capture targets.
- Simultaneous claims on the same resource or position: Marbles occupy discrete non-overlapping coordinates via elastic displacement.
- Player elimination mid-round: An agent whose marble is captured is eliminated from the turn rotation; turn order continues to next active agent.
- Resource exhaustion: Target marbles are captured monotonically.
- Termination guarantee: Guaranteed by finite player count and R6 watchdog limit.
## State representation
- Persistent state: `scores` (map agent_id -> int), `status` (map agent_id -> enum: UNQUALIFIED / HUNTER), `captured` (map agent_id -> bool), `positions` (map agent_id -> `(x,y)`).
- Per-turn ephemeral state: `consecutive_shots` (int 0..5), `active_agent_id` (agent_id).
- Observable information: Fully observable by all agents.
## Action space
- `shoot_marble(target_x, target_y, power)`: Select target aim coordinates and release power.
## Playability notes
- Single-player-vs-AI: Natural — 1 human vs. 1-3 AI agents managing risk between qualifying at the hole vs. keeping defensive distance.
- Group games (n>4): Free-for-all elimination battle.
- Physical-skill games: Thumb flick calibration parameterized via `sigma(skill)`.
- What is lost: The tactile thumb flick friction and the fine reading of cobblestone contours.
## Implementation hints
2D coordinate engine with circle-circle raycast collision detection. Suggested milestone: Verify R3.2 qualification trigger and R3.3 hunter bonus turn loop.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Gibraltar Llanito Marbles (Gibraltar). (n.d.). Games of Countries. https://gamesofcountries.com/games/gi-gibraltar/canicas-golis
@misc{gamesofcountries-gi-gibraltar-canicas-golis,
title = {Gibraltar Llanito Marbles (Gibraltar)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/gi-gibraltar/canicas-golis}
}