Skip to main content
Formal Specification

Rolling marbles (Swedish traditional marble games) — Formal Specification

Sweden · dexterity-small · Confidence: high

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 5
# Trilla kula — AI-optimized specification ## General idea A traditional Swedish spring ground marble game (*Spela i grop* / The Hole Game) where players flick glass or clay spheres across bare earth into a central excavated hole (*gropen*). Sinking a marble into the hole "arms" it with toxic status (*skarp* / *giftig*), enabling the armed shooter to hunt, strike, and eliminate opponent marbles on subsequent flicks to claim them as winnings. ## Formal model - **Abstraction taken:** The continuous rolling dynamics and micro-topography of dirt are replaced by a 2D kinematic point-mass simulation with Coulomb friction. An agent chooses a target aim vector (θ,F). A Gaussian velocity perturbation (vx,vy)∼𝒩(μ,Σskill) models finger-flick motor execution error. Elastic circle-circle collisions and hole-capture radii (Rhole) resolve hits. - **Player/agent count:** 2 to N players (benchmark N=2: Player 1 vs Player 2). - **Turn model:** Sequential turns; achieving a successful strike or hole entry awards an immediate consecutive action. ## Formal rules R1. **Arena & Setup:** - The playing area is a 4.0×4.0 meter ground plane. - A target cup/hole of radius Rhole=0.05m is centered at (0,0). - A scratch line is marked at y=−3.0m. - Each player places 1 shooter marble on the field via an opening toss from the line [gap-fill]. R2. **Turn Order:** - The player whose marble lies closest to (0,0) after the opening toss takes the first turn, followed by next closest in sequence. R3. **Shooting Action (*Knäppa*):** - The active player executes a flick from their marble's current coordinate (xi,yi), specifying release angle θ∈[0,2π) and initial velocity v0∈[0.5,4.0] m/s. - The executed launch vector is perturbed by motor noise: v→∼𝒩((v0cos⁡θ,v0sin⁡θ),σskill2I) [gap-fill]. R4. **Ground Roll & Hole Interaction:** - The marble rolls with deceleration a=−μg (μ=0.15 for compacted earth) [gap-fill]. - If the marble passes within distance dist((x,y),(0,0))≤Rhole with speed v≤vcapture=1.2 m/s, the marble drops into the hole. - Status Update: The marble becomes `ARMED` (*skarp*), and the player is granted an extra turn, placing the marble on the edge of the hole for their next flick. R5. **Hunting & Striking Opponents:** - An `ARMED` marble may target opponent marbles. - If an armed marble collides with an opponent marble (dist(pos→A,pos→B)≤2rmarble=0.02m): - The struck opponent marble is `CAPTURED` and permanently eliminated. - The active shooter is awarded +1 point and earns an immediate consecutive flick. R6. **Miss & Turn Transition:** - If a flick fails to enter the hole or strike an opponent, the marble rests at its final roll position (x,y), and the turn passes to the next player. R7. **Win Condition:** - A player wins immediately when they eliminate all opponent marbles on the board. R8. **Stalemate Ceiling:** - [gap-fill] If 40 turns elapse without a marble entering the hole or a capture, the game terminates; the player whose marble is closest to the hole wins. ## Edge cases - Tie at the end condition: Resolved by distance proximity to the hole per R8. - A player with no legal move: Not applicable — flicking action is always available from current rest position. - Repetition / cycles: Bounded by the 40-turn stalemate ceiling in R8. - Simultaneous claims on the same resource or position: Elastic circle collision separates colliding marbles; only 1 marble occupies the hole at a time [gap-fill]. - Player elimination mid-round: When a player's marble is captured, they are eliminated from the round; remaining players continue turn rotation. - Resource exhaustion (pieces, tokens, space, time): Each player has 1 active shooter; time bounded by 40 turns. - Termination guarantee: Captures reduce active players monotonically (N→1); stalemate ceiling guarantees termination if no captures occur. ## State representation - **Persistent state:** - `active_players`: list of player IDs. - `eliminated_players`: list of player IDs. - `scores`: map of player ID →captures. - `turn_counter`: integer ∈[1,40]. - **Per-turn ephemeral state:** - `active_player_index`: integer. - `marble_positions`: map of player ID →(x,y)∈ℝ2. - `marble_armed_status`: map of player ID →boolean. - `extra_shot_awarded`: boolean. - **Observable information:** - Fully observable: All marble coordinates, armed statuses, and hole position are visible to all players. ## Action space - `flick_marble(angle, velocity)`: float parameters θ∈[0,2π),v∈[0.5,4.0]. Precondition: player is active on their turn. ## Playability notes - Single-player-vs-AI: Highly natural — acts as a 2D billiards/croquet physics game where the player calculates rebound vectors and arming risks against an AI opponent. - Group games (n>4): Scales naturally up to 6 players on the same dirt ring without rule changes. - Physical-skill games: Physical thumb knuckle anchoring, fine-motor flicking force, and dirt trajectory reading are mapped into continuous aiming coordinates with Gaussian execution noise. - What is lost in the adaptation: The tactile child-lore economy of clinking glass marbles in schoolyard pockets, dirt stains on knees, and trading rare *kattögon* and steel *dankar*. ## Implementation hints Low-to-moderate complexity. The simulation requires a simple 2D circle-physics integrator with linear velocity decay and circle-circle collision detection. First milestone: implement marble deceleration and hole capture radius check, verifying that over-powered shots roll over the hole without dropping in.

Download as JSON

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

Download JSON
Cite this page

Rolling marbles (Swedish traditional marble games) (Sweden). (n.d.). Games of Countries. https://gamesofcountries.com/games/se-sweden/trilla-kula

@misc{gamesofcountries-se-sweden-trilla-kula,
  title = {Rolling marbles (Swedish traditional marble games) (Sweden)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/se-sweden/trilla-kula}
}