Skip to main content
Formal Specification

Traditional Marbles — Formal Specification

North Macedonia · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 4
# Џамлии (Скокалче) — AI-optimized specification ## General idea A turn-based 2D precision flicking game played on an earth surface. Players compete to land their marble in a central target hole to earn "armed" status (*pechen*), after which they can target and eliminate opponents' marbles with direct impact shots. Sinking the hole or hitting a target grants an immediate bonus turn. ## Formal model - **Abstraction taken:** Continuous surface friction, thumb-flick impulse, and sphere collisions are abstracted into a 2D vector flick action v→=(v,θ). Landing position and collision outcomes are resolved via 2D physics simulation with friction damping and stochastic execution jitter. - **Player/agent count:** N agents (N∈[2,6]). - **Turn model:** Sequential cyclic turn order determined by initial lag throw, with bonus turns awarded upon successful hits or hole sinking. ## Formal rules R1. **Setup:** Arena is a square [−1.5,1.5]×[−1.5,1.5] meters on the (x,y) plane. Target hole is located at origin (0,0) with capture radius Rhole=0.05 m. R2. **Lagging / Turn Order:** Each agent executes a preliminary shot from (0,−1.5) aiming at (0,0). Turn order list 𝒪=⟨p1,p2…pN⟩ is sorted ascending by distance to origin ‖(xi,yi)‖. R3. **Player State:** Each agent p maintains state: - Position (xp,yp)∈ℝ2. - `Qualified` ∈{False,True} (initially `False`). - `Active` ∈{False,True} (initially `True`). R4. **Shot Execution:** Active agent p submits `flick_marble(impulse, angle)`. The marble moves along v→ with friction deceleration μ=2.0 m/s2 and trajectory noise ϵ∼𝒩(0,σ2). R5. **Hole Entry Resolution:** If the marble trajectory intersects or comes to rest within ‖(xp,yp)‖≤Rhole: - The marble is placed at (0,0). - p's status updates: Qualifiedp←True. - Agent p immediately receives a bonus shot from (0,0). R6. **Collision & Elimination:** - If marble p collides with marble q (d(p,q)≤2Rmarble): - If Qualifiedp=True: Agent q is eliminated (Activeq←False), and p earns a bonus shot from its post-collision resting spot. - If Qualifiedp=False: Both marbles bounce elastically without elimination; turn ends. R7. **Turn Transition:** If a shot does not enter the hole and does not eliminate an opponent, the turn passes to the next active player in 𝒪. R8. [gap-fill] Boundary Rebound:** If a marble exceeds arena bounds, it is repositioned at the nearest boundary perimeter coordinate. R9. [gap-fill] Creeping Penalty:** All shots must originate from within 0.01 m of the true resting spot; forward displacement of the flick hand is disallowed. R10. **Win Condition:** The last remaining agent with Active=True wins the match. ## Edge cases - Tie at the end condition: Not applicable; match concludes by sequential elimination leaving exactly one survivor. - A player with no legal move: `flick_marble` is always available from current resting coordinates while active. - Repetition / cycles: Bounded; the number of active targets strictly decreases monotonically from N toward 1. - Simultaneous claims on the same resource or position: Turns are strictly sequential; marbles occupy distinct coordinates. If a marble stops in the hole while another is present, the previous marble is nudged outside Rhole [gap-fill]. - Player elimination mid-round; turn order repair: Eliminated players are removed from 𝒪; turn rotation advances to (curr(mod|𝒪|))+1. - Resource exhaustion: Marbles are persistent; eliminated marbles are removed from the active arena. - Termination guarantee: [gap-fill] Monotonic elimination guarantees that at most N−1 eliminations conclude the game in a finite number of turns. ## State representation - **Persistent state:** Number of players N, turn order 𝒪, current turn index. - **Per-player state:** 2D coordinates (xi,yi), `Qualified` boolean, `Active` status. - **Observable information:** Fully observable; all marble positions, qualification statuses, and arena boundaries are public knowledge. ## Action space - `flick_marble(impulse, angle)`: Parameters `impulse` ∈(0,1.0], `angle` ∈[−π,π). Precondition: caller is the active agent. ## Playability notes - Single-player-vs-AI: Natural; human controls 1 marble against 1 to 5 AI agents on a physics canvas. - Group games (n>4): Natively supports 2 to 6 players in cyclic rotation. - Physical-skill games: Fine motor thumb mechanics are parameterized into directional vector impulse and aim precision. - What is lost in the adaptation: The tactile feel of cool glass spheres, digging dirt trenches with small fingers, and neighborhood marble-trading bargaining. ## Implementation hints Low complexity. Requires basic 2D rigid-body kinematics with friction and circle-circle collision detection. First milestone: implement R1–R5 (lagging and hole entry with bonus turns) before adding collision elimination.

Download as JSON

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

Download JSON
Cite this page

Traditional Marbles (North Macedonia). (n.d.). Games of Countries. https://gamesofcountries.com/games/mk-north-macedonia/dzhamlii

@misc{gamesofcountries-mk-north-macedonia-dzhamlii,
  title = {Traditional Marbles (North Macedonia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/mk-north-macedonia/dzhamlii}
}