Skip to main content
Formal Specification

Traditional Marble Flicking Game — Formal Specification

Malaysia · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Main Guli — AI-optimized specification ## General idea A turn-based 2D planar precision shooting and territory-control game. Agents navigate marble tokens across a continuous bounded circular arena containing a central target hole (*lubang induk*). Agents must first achieve active "hunting status" by successfully landing their marble into the center hole, after which they execute strategic ballistic flick strikes to eliminate opponents' marbles and accumulate victory points. ## Formal model - **Abstraction taken:** Ground rolling friction and 2D elastic sphere-sphere collisions are abstracted into a 2D kinematic impulse physics model on a disc arena Ω={(x,y)∈ℝ2|x2+y2≤Rarena2} with Rarena=1.5 m. Center hole is a target circle at (0,0) with radius rhole=0.05 m. - **Player/agent count:** 2 to 5 agents taking sequential turns. - **Turn model:** Sequential round-robin turns. An agent with active turn selects a 2D impulse vector (Ix,Iy); if a target marble is hit, the agent earns a continuation shot. ## Formal rules R1. State tracking per agent i∈[1..N]: - Position pi=(xi,yi)∈Ω. - Status Si∈{INACTIVE,ACTIVATED,ELIMINATED}. - Score Ci∈ℕ, starting at 0. R2. Phase 1 — Lag test (*Melerek*): - All agents start behind y=−3.0 m and commit an initial roll toward (0,0). - The turn order sequence π=(π1,π2,…,πN) is sorted by ascending Euclidean distance to the center ‖pi−(0,0)‖. R3. Phase 2 — Turn execution: - On agent i's turn (if Si≠ELIMINATED): - Agent chooses a shot angle θ∈[0,2π) and force magnitude F∈[0,Fmax]. - Execution noise: θˆ∼𝒩(θ,σθ2) and Fˆ∼𝒩(F,σF2). - Ballistic propagation: Marble moves with initial velocity v0=Fˆ/m subject to ground rolling deceleration a=−μg. R4. Center hole activation: - If agent i is `INACTIVE` and marble trajectory stops within ‖pi‖≤rhole: - Status transitions: Si←ACTIVATED. - Position snaps to hole center (0,0), and agent i receives an immediate bonus continuation shot. R5. Striking opponent marbles (*Pangkah*): - When an `ACTIVATED` marble i collides with another marble j (j≠i): - Elastic collision kinematics compute new post-collision velocities for both marbles. - Agent i receives +1 score point (Ci←Ci+1) and earns an immediate continuation shot ( [gap-fill]). - If marble j is knocked outside the boundary (‖pj‖>Rarena), agent j transitions to `ELIMINATED` ( [gap-fill]). R6. Turn termination: - If a shot fails to activate the hole or strike any valid target marble, agent i's turn ends immediately, and turn passes to the next active agent in sequence π. R7. [gap-fill] Victory condition: - The game concludes immediately when any agent reaches Ci≥TargetScore (default 10 points) OR when only one non-eliminated agent remains on the board. ## Edge cases - Tie at the end condition: Highest score wins; if equal, a single-shot closest-to-hole lag shot decides the tie. - A player with no legal move: Not applicable; an active agent always possesses valid shot angle and force options. - Repetition / cycles: Bounded because successful hits increment scores toward target, and misses pass the turn. If 50 consecutive non-scoring plies occur, game terminates in a draw. - Simultaneous claims on the same resource or position: Turns are strictly sequential; marble collisions resolve sequentially. - Player elimination mid-round; turn order repair: Eliminated agents are skipped in turn rotation; remaining agents preserve relative order. - Resource exhaustion (pieces, tokens, space, time): Exactly N marbles on a bounded 2D field. - Termination guarantee: Monotonic score accumulation, elimination events, and the 50-ply non-scoring draw ceiling guarantee termination. ## State representation - Persistent state: `scores[N]`, `statuses[N]`, `turn_order[N]`, `active_index`, `target_score`. - Ephemeral state: `marble_positions[N]`, collision events in current shot, consecutive non-scoring ply counter. - Observable information: Fully observable by all agents. ## Action space - `shoot(angle, force)`: Continuous 2D vector where angle∈[0,2π) and force∈[0,Fmax]. ## Playability notes - Single-player-vs-AI: Natural and engaging; AI agents use ray casting and geometric trajectory optimization to hunt human/AI marbles. - Group games (n>4): Up to 5 agents in standard FFA (free-for-all) elimination/point tournament. - Physical-skill games: Real finger-flicking finesse is parameterized by angular and force Gaussian noise distributions. - What is lost in the adaptation: The micro-irregularities of dirt terrain and tactile thumb-snap release sensation. ## Implementation hints Use a lightweight 2D rigid-body circle collision physics engine. Step size Δt=0.01 s during shot simulation. First milestone: implement 2-body elastic collision and out-of-bounds detection before layering the turn machine and hole activation logic.

Download as JSON

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

Download JSON
Cite this page

Traditional Marble Flicking Game (Malaysia). (n.d.). Games of Countries. https://gamesofcountries.com/games/my-malaysia/main-guli

@misc{gamesofcountries-my-malaysia-main-guli,
  title = {Traditional Marble Flicking Game (Malaysia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/my-malaysia/main-guli}
}