Formal Specification
Egyptian Marbles — Formal Specification
Egypt · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# El-Beeli — AI-optimized specification
## General idea
A turn-based marble flicking and target-ejection game played on a 2D plane. Agents aim their shooter marble at target marbles inside a bounded triangular zone. Successful ejections award captures and grant bonus shots, while trapping the shooter inside the triangle forfeits the turn.
## Formal model
- **Abstraction taken:** Knuckle-flick mechanics and surface friction are modeled as a 2D vector impulse with Gaussian angular and velocity error, resolved via standard 2D elastic circular disk collision physics.
- **Player/agent count:** 2 agents (extensible to ).
- **Turn model:** Sequential turns; active agent retains turn upon making a successful capture.
## Formal rules
R1. Setup: A triangular region is defined in with vertices at . target marbles (default , 3 per player) are initialized at rest inside . Agents start with their shooter marbles at baseline .
R2. On a turn, active agent executes `shoot(angle, force)`:
- Initial impulse: where .
R3. Physics Simulation (per shot):
- Trajectory and disk collisions are integrated until all marbles come to rest.
- If a target marble crosses outside the boundary of : it is `CAPTURED` by the active agent and removed from play.
- If an opponent shooter is struck: the opponent is `ELIMINATED` from the round; all remaining marbles inside are awarded to the active agent.
R4. Turn Transition:
- If target marble was captured (and shooter remains outside ): active agent is granted an immediate bonus shot from the shooter's new resting position.
- If shooter comes to rest *inside* : shooter becomes `TRAPPED` (cannot move until knocked out) and turn ends.
- Otherwise: turn passes to the next agent in rotation.
R5. [gap-fill] Miss Penalty: If an agent takes 3 consecutive shots without hitting any target or entering the triangle, their shooter is reset to the baseline.
R6. [gap-fill] Round Termination: Round ends when 0 target marbles remain in , or an agent eliminates the other. Agent with the most captures wins.
## Edge cases
- Tie at the end condition: If both agents capture exactly equal marbles ( each), 1 tiebreaker marble is placed in ; first to eject wins.
- A player with no legal move: If trapped inside , the agent's turn is skipped until the shooter is freed.
- Repetition / cycles: Friction strictly drains all kinetic energy each shot; marble count in strictly decreases.
- Simultaneous claims on the same resource or position: Disc collision physics resolves elastic displacement; no overlap is possible.
- Player elimination mid-round; turn order repair: Striking opponent shooter eliminates that agent immediately, concluding the round.
- Resource exhaustion (pieces, tokens, space, time): Target marbles strictly deplete to 0.
- Termination guarantee: Monotonic reduction of target marbles guaranteed by R3.
## State representation
- Persistent state:
- `target_marbles`: list of 2D coordinates `[(x, y), ...]`.
- `shooter_positions`: `{AGENT_0: (x, y), AGENT_1: (x, y)}`.
- `shooter_trapped`: `{AGENT_0: bool, AGENT_1: bool}`.
- `captured_counts`: `{AGENT_0: int, AGENT_1: int}`.
- Ephemeral state: `shot_velocities`: vectors during physics integration.
- Observable information: Fully observable by all agents.
## Action space
- `shoot(angle, force)`: `angle ∈ [0, 360^\circ]`, `force ∈ [0, 100]`.
## Playability notes
- Single-player-vs-AI: Engine-ready; play as human vs AI in target clearing or duel modes.
- Group games (n>4): Generalizes to multi-player rotation around the triangle.
- Physical-skill games: Thumb flicking torque is parameterized as impulse magnitude with skill-dependent variance.
- What is lost in adaptation: Dirt surface micro-roughness and physical finger positioning.
## Implementation hints
Standard 2D rigid-body circle collision simulation. First milestone: implement triangle boundary check, elastic 2-circle collision, and rolling friction before implementing trapped shooter state.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Egyptian Marbles (Egypt). (n.d.). Games of Countries. https://gamesofcountries.com/games/eg-egypt/el-beeli
@misc{gamesofcountries-eg-egypt-el-beeli,
title = {Egyptian Marbles (Egypt)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/eg-egypt/el-beeli}
}