Formal Specification
Traditional Marbles — Formal Specification
North Macedonia · dexterity-small · Confidence: low
← Back to game pageImplementation 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 . Landing position and collision outcomes are resolved via 2D physics simulation with friction damping and stochastic execution jitter.
- **Player/agent count:** agents ().
- **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 meters on the plane. Target hole is located at origin with capture radius .
R2. **Lagging / Turn Order:** Each agent executes a preliminary shot from aiming at . Turn order list is sorted ascending by distance to origin .
R3. **Player State:** Each agent maintains state:
- Position .
- `Qualified` (initially `False`).
- `Active` (initially `True`).
R4. **Shot Execution:** Active agent submits `flick_marble(impulse, angle)`. The marble moves along with friction deceleration and trajectory noise .
R5. **Hole Entry Resolution:** If the marble trajectory intersects or comes to rest within :
- The marble is placed at .
- 's status updates: .
- Agent immediately receives a bonus shot from .
R6. **Collision & Elimination:**
- If marble collides with marble ():
- If : Agent is eliminated (), and earns a bonus shot from its post-collision resting spot.
- If : 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 of the true resting spot; forward displacement of the flick hand is disallowed.
R10. **Win Condition:** The last remaining agent with 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 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 [gap-fill].
- Player elimination mid-round; turn order repair: Eliminated players are removed from ; turn rotation advances to .
- Resource exhaustion: Marbles are persistent; eliminated marbles are removed from the active arena.
- Termination guarantee: [gap-fill] Monotonic elimination guarantees that at most eliminations conclude the game in a finite number of turns.
## State representation
- **Persistent state:** Number of players , turn order , current turn index.
- **Per-player state:** 2D coordinates , `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` , `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 JSONCite 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}
}