Formal Specification
Seven Stones — Formal Specification
Jordan · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 4
# Sab'a Hijar — AI-optimized specification
## General idea
A competitive two-team field game combining target throwing, tower construction, and dodgeball tag. The Throwing team attempts to topple a central stack of 7 stones with a ball, and then rebuild the stack one stone at a time while dodging ball throws from the Defending team.
## Formal model
- **Abstraction taken:** The playing field is modeled as a 2D grid. The 7 stones are modeled as a stack counter . Ball throwing and tagging are modeled as line-of-sight projectile checks.
- **Player/agent count:** 2 teams () of 4 to 6 agents.
- **Turn model:** 1 Phased Opening Throw, followed by simultaneous real-time state ticks.
## Formal rules
R1. **Initial stack:** Central stone tower at with height .
R2. **Opening throw:** players sequentially throw at the tower from distance .
- [gap-fill].
- If all players miss, teams swap roles immediately without points.
- If hit occurs, tower topples (), and the real-time phase begins.
R3. **Real-time phase actions:**
- **Throwers ():** Move on grid. If adjacent to and not tagged, can execute `stack_stone()`, incrementing .
- **Defenders ():** Move on grid, execute `pass_ball(defender_id)` or `throw_at_player(thrower_id)`. Defenders holding the ball cannot move (`stationary_when_holding = True`).
R4. **Elimination ("Burning"):** If a defender's ball throw hits a thrower, that thrower is eliminated from the round.
R5. **Victory conditions:**
- wins round and scores 1 point if is completed before all throwers are eliminated.
- wins round (scores 0, earns role swap) if all throwers are eliminated before .
R6. [gap-fill] Round ceiling:** Maximum 120 ticks per round to guarantee termination.
## Edge cases
- **Tie at the end condition:** If last thrower completes on the exact tick they are hit by the ball, tie resolves to the builder (success) [gap-fill].
- **A player with no legal move:** Standard grid moves or passes are available.
- **Repetition / cycles:** Bounded by 120-tick ceiling [gap-fill].
- **Simultaneous claims:** Collision resolved by spatial priority.
- **Player elimination mid-round:** Eliminated throwers enter spectator queue.
- **Resource exhaustion:** 7 stones and 1 ball are static/constant.
- **Termination guarantee:** Guaranteed by 120-tick cutoff and strict elimination monotonicity.
## State representation
- **Persistent state:** `scores: Dict[Team, int]`, `innings_played: int`.
- **Ephemeral state:** `tower_height: int \in [0,7]`, `ball_position: (x,y)`, `ball_holder: Optional[AgentID]`, `agent_positions: Dict[AgentID, (x,y)]`, `active_throwers: Set[AgentID]`.
- **Observable information:** Fully observable state.
## Action space
- `move(dx, dy)`: Grid step (valid for defenders only if not holding ball).
- `stack_stone()`: Valid for thrower at .
- `pass_ball(target_id)`: Valid for defender with ball.
- `throw_at_player(target_id)`: Valid for defender with ball.
## Playability notes
- **Single-player-vs-AI:** Highly playable as a frantic resource-gathering evasion game against AI guards.
- **Group games (n>4):** Reduces cleanly to 2v2 with scaled grid dimensions.
- **Physical-skill games:** Throwing precision and dodging agility mapped to probabilistic hit checks.
- **What is lost:** Tactile stone balancing, physical ball evasion acrobatics, and street banter.
## Implementation hints
Standard multi-agent grid game. Ball movement and passing can be implemented via simple vector raycasts.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Seven Stones (Jordan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jo-jordan/sab-a-hijar
@misc{gamesofcountries-jo-jordan-sab-a-hijar,
title = {Seven Stones (Jordan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/jo-jordan/sab-a-hijar}
}