Formal Specification
Indonesian Marbles / Gundu — Formal Specification
Indonesia · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Nekeran — AI-optimized specification
## General idea
A turn-based 2D precision physics and target-clearing game. Agents shoot a master projectile at a cluster of target tokens located inside a circular ring. The shot outcome (collision trajectory, target displacement, shooter final position) is determined by an aiming angle and velocity vector resolved via a stochastic collision model.
## Formal model
- **Abstraction taken:** Physical finger flicking and surface friction are modeled as a 2D continuous planar vector space with stochastic Gaussian scatter around the intended shot vector .
- **Player/agent count:** 2 to 6 agents in a fixed turn order.
- **Turn model:** Sequential. An agent continues shooting as long as they achieve a successful capture without fouling.
## Formal rules
R1. Setup: Arena is a 2D circle centered at with radius . target marbles are initialized near the center with small random offsets. Agents' shooters start at baseline .
R2. Turn action:
- Active agent chooses shot angle and impulse magnitude .
- Realized trajectory vector is perturbed by agent skill: .
R3. Collision resolution:
- 2D elastic collisions with friction are simulated until all objects come to rest [gap-fill].
- Any target marble whose final position is removed from the arena and credited to the active agent's score.
- If the shooter's final position and a target was displaced out, the shot is a FAULT: displaced marbles are returned to center, and shooter is placed at [gap-fill].
- If target marble was legally displaced out and no fault occurred, the agent earns a BONUS shot from the shooter's current position.
- Otherwise, turn passes to the next agent in rotation.
R4. Opponent hit (*Nyekil*): If an agent's shooter strikes an opponent shooter outside the ring, the opponent pays 1 collected marble to the shooter (or is eliminated if having 0 marbles) [gap-fill].
R5. Win condition: The game terminates when all target marbles are removed from the ring. The agent with the highest count of captured marbles wins.
## Edge cases
- Tie at the end condition: If two agents have equal marble counts when the ring is cleared, a 1-shot closest-to-pin playoff from baseline to center is conducted.
- A player with no legal move: Not applicable; shooting in any direction is always legal.
- Repetition / cycles: Bounded by finite target marbles () and monotonic depletion of available targets.
- Simultaneous claims on the same resource or position: Resolved sequentially; each agent acts exclusively during their turn.
- Player elimination mid-round: An eliminated agent is removed from turn rotation; their shooter is removed from the board.
- Resource exhaustion: When target marbles reach 0, terminal state triggers immediately.
- Termination guarantee: Every legal shot has a positive probability of clearing targets or ending turns, guaranteeing finite game duration.
## State representation
- Persistent state:
- `target_marbles`: list of 2D coordinates .
- `shooter_positions`: mapping of `agent_id -> (x, y)`.
- `scores`: mapping of `agent_id -> int`.
- `active_agent_idx`: integer.
- Per-turn ephemeral state:
- `shot_vector`: .
- Observable information: Fully observable (all coordinates, scores, and ring radius are public).
## Action space
- `shoot(angle, velocity)`: , .
## Playability notes
- Single-player-vs-AI: Excellent as a billiard-style 2D physics puzzle against an AI using vector optimization.
- Group games (n>4): Reduces smoothly to 2 agents (1v1) without modifying rules.
- Physical-skill games: Finger flicking precision is mapped to a 2D Gaussian error covariance matrix.
- What is lost in the adaptation: The tactile feel of glass marbles rolling across dirt ridges and thumb muscle memory is abstracted.
## Implementation hints
Standard 2D circle-circle collision solver with damping friction coefficient . First milestone: Implement 2D physics sandbox with circular boundary trigger and score counters.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Indonesian Marbles / Gundu (Indonesia). (n.d.). Games of Countries. https://gamesofcountries.com/games/id-indonesia/nekeran
@misc{gamesofcountries-id-indonesia-nekeran,
title = {Indonesian Marbles / Gundu (Indonesia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/id-indonesia/nekeran}
}