Skip to main content
Formal Specification

Sudanese Rag-Ball Street Soccer — Formal Specification

Sudan · ball-team · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: discretizedGap-fills: 1
# Kora Shurrab Sudaniya — AI-optimized specification ## General idea A small-sided positional street soccer game on a 2D discrete grid with wall rebounds and low goalposts. Agents execute movement, short passing, wall rebounds, tackling, and low-altitude goal strikes to outscore the opponent within the match tick duration. ## Formal model - **Abstraction taken:** Alley field is modeled as a 2D discrete grid [−5,5]×[−10,10] with side walls at x=±5 and stone goalposts at y=−10 and y=10 (goal width x∈[−1,1]). Ball physics incorporates low-bounce velocity decay and specular wall rebounds. - **Player/agent count:** 2 teams of M agents each (standard 1v1 duel or 3v3 team model). - **Turn model:** Synchronous discrete ticks (100ms per tick). ## Formal rules R1. Positions & Setup: Team A defends goal at y=−10; Team B defends goal at y=10. Ball starts at (0,0), `holder = NONE`. R2. Movement & Actions (per tick): - Agents move ≤1 cell in Chebyshev distance per tick. - Ball holder may: `DRIBBLE(dx, dy)`, `PASS(target_pos)`, `WALL_REBOUND(wall_x)`, or `SHOOT(target_x, target_y)`. R3. Ball Interception & Tackling: - If a defending agent occupies the same cell as the ball holder and executes `TACKLE()`: - Tackle success probability Ptackle=0.60+0.05×(skilldef−skillatt). - On success, defender gains possession; on failure, attacker retains ball and skips past defender. R4. Wall Rebound Dynamics: - Executing `WALL_REBOUND` at side wall x=±5 reflects the ball trajectory with specular angle of reflection, enabling self-passes past defenders. R5. Goal Scoring: - A shot passing across the goal line y=±10 within width x∈[−1,1] and strictly below low-height ceiling scores a `GOAL` (**+1 point**). - Shots exceeding target width or lofted high are `OUT` (goal kick awarded to defending team). - After a goal, ball resets to (0,0) for a kickoff by the conceding team. R6. [gap-fill] Match Duration: Match lasts 150 ticks. Team with the most goals at tick 150 wins. ## Edge cases - Tie at the end condition: If match score is tied at tick 150, a sudden-death golden-goal period of 50 ticks is played. - A player with no legal move: Directional movement on open grid is always legal. - Repetition / cycles: Bounded by the 150-tick hard match limit (R6). - Simultaneous claims on the same resource or position: Loose ball arrival on the same cell resolves via agility tiebreaker. - Player elimination mid-round; turn order repair: No player elimination; all agents play the full 150 ticks. - Resource exhaustion (pieces, tokens, space, time): Exactly 1 ball in play; ticks strictly terminate at 150. - Termination guarantee: Guaranteed by the finite 150-tick duration. ## State representation - Persistent state: `match_score`: `{TEAM_A: int, TEAM_B: int}`, `tick_counter: int in 0..150`. - Per-tick state: - `ball_pos`: `(x, y)`. - `ball_carrier`: `AgentID | None`. - `agent_positions`: map of `agent_id` to `(x, y)`. - Observable information: Fully observable by all agents. ## Action space - `move(dx, dy)`: directional movement ≤1 cell. - `pass(tx, ty)`: pass vector. - `shoot(tx, ty)`: strike at goal. - `tackle()`: attempt ball strip if adjacent. ## Playability notes - Single-player-vs-AI: Engine-ready; play as attacker/defender in close-control street soccer vs AI bots. - Group games (n>4): Standard 3v3 team configuration operates smoothly with tactical passing networks. - Physical-skill games: Barefoot sand dribbling and wall bank shots are mapped into 2D discrete grid velocities. - What is lost in adaptation: The raw barefoot feel of the heavy rag sock ball. ## Implementation hints Standard 2D grid multi-agent simulator with discrete ball possession mechanics. First milestone: implement ball dribbling, wall boundary rebounds, and goal zone collision checks.

Download as JSON

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

Download JSON
Cite this page

Sudanese Rag-Ball Street Soccer (Sudan). (n.d.). Games of Countries. https://gamesofcountries.com/games/sd-sudan/kora-shurrab-sudaniya

@misc{gamesofcountries-sd-sudan-kora-shurrab-sudaniya,
  title = {Sudanese Rag-Ball Street Soccer (Sudan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/sd-sudan/kora-shurrab-sudaniya}
}