Formal Specification
Burned Ball (Albanian Dodgeball) — Formal Specification
Albania · ball-team · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: discretizedGap-fills: 3
# Topi i djegur — AI-optimized specification
## General idea
A multi-agent team ball-elimination game played across a divided 2D court with flanking outfield zones. Agents throw a single ball to eliminate opposing inner-court agents. Catching incoming throws grants reusable "life" tokens or revives eliminated teammates from the rear outfield.
## Formal model
- **Abstraction taken:** The 18 × 9 court is discretized into 4 discrete spatial zones: `TEAM_A_INFIELD`, `TEAM_A_OUTFIELD`, `TEAM_B_INFIELD`, `TEAM_B_OUTFIELD`. Throws are resolved via a stochastic decision tree (Catch / Hit / Miss) parameterized by thrower and target skill attributes.
- **Player/agent count:** 2 teams of `K` agents (`K = 4..8`, default `K = 5`).
- **Turn model:** Alternating team possession with sequential throw actions per possession.
## Formal rules
R1. Setup: Each team has 1 designated Captain (`CAPTAIN`) and `K-1` regular players (`PLAYERS`).
- Team A regular players start in `TEAM_A_INFIELD` with `lives = 0`. Captain A starts in `TEAM_B_OUTFIELD` with `lives = 0`.
- Team B regular players start in `TEAM_B_INFIELD` with `lives = 0`. Captain B starts in `TEAM_A_OUTFIELD` with `lives = 0`.
- Ball begins in possession of Team A.
R2. On active possession, the agent holding the ball chooses a target agent `T` in the opposing inner court and executes `throw_ball(T)`.
R3. Ball Throw Resolution:
- Target agent `T` chooses between `ATTEMPT_CATCH` or `ATTEMPT_DODGE`.
- If `ATTEMPT_CATCH`:
- Catch succeeds with probability `P_catch = 0.35` [gap-fill].
- If catch succeeds: Thrower misses. Target `T` gains `+1` life (`lives[T] += 1`). Ball remains with `T`'s team.
- If catch fails: Target `T` is struck (`HIT`).
- If `ATTEMPT_DODGE`:
- Dodge succeeds with probability `P_dodge = 0.60` [gap-fill].
- If dodge succeeds: Ball misses, rolling to the outfield behind `T` (possession passes to the outfield agents).
- If dodge fails: Target `T` is struck (`HIT`).
R4. Hit Resolution:
- When agent `T` in inner court is `HIT`:
- If `lives[T] > 0`: `lives[T] -= 1`. `T` remains in the inner court.
- If `lives[T] == 0`: `T` is `BURNED` and transitions from `INFIELD` to `OUTFIELD`.
R5. Outfield Attacks and Revival:
- When an agent in `OUTFIELD` throws the ball and successfully scores a `HIT` against an opposing inner-court agent: The throwing outfield agent is `REVIVED` and transitions back to their team's `INFIELD`.
R6. Captain's Entry and Match Win Condition:
- When all regular infield players of Team A are in the outfield, Captain A enters `TEAM_A_INFIELD` and is endowed with `3` bonus lives (`lives[Captain_A] = 3`).
- When the Captain's lives reach `0` while in the infield, that team is fully eliminated. The opposing team wins the match immediately.
R7. [gap-fill] Turn Limit: If 100 throws occur without full elimination, the team with more total active lives/players wins.
## Edge cases
- Tie at the end condition: Resolved by R7 player/life count comparison.
- A player with no legal move: Not applicable; an agent with the ball always has at least one valid opposing target.
- Repetition / cycles: Bounded because net lives are depleted over time (`P_hit > P_catch`), and R7 enforces a 100-throw ceiling.
- Simultaneous claims on the same resource or position: The ball exists as a single discrete token in possession of exactly one agent at any time.
- Player elimination mid-round; turn order repair: Eliminated agents move to the outfield where they remain valid throwers and receivers.
- Resource exhaustion (pieces, tokens, space, time): Exactly one ball exists; lives are bounded integers `0..3`.
- Termination guarantee: why the game provably ends: Guaranteed because hits deplete lives with strictly positive expected rate per possession, and R7 caps total possessions.
## State representation
- Persistent state: `player_zone: map[AgentID -> ZoneEnum]`, `lives: map[AgentID -> int]`, `captain_entered: map[TeamID -> bool]`, `throw_count: int`.
- Per-turn ephemeral state: `ball_carrier_id: AgentID`, `target_id: AgentID`.
- Observable information: Fully observable by all agents.
## Action space
- `throw_ball(target_id: AgentID)`: Ball carrier action.
- `defend_action(type: {ATTEMPT_CATCH, ATTEMPT_DODGE})`: Target agent reaction.
- `donate_life(recipient_id: AgentID)`: Infield agent action to revive an outfield teammate.
## Playability notes
- Single-player-vs-AI: Natural; player commands a team squad against an AI squad.
- Group games (n>4): Natively structured for 8 to 16 agents.
- Physical-skill games: Real-time ball flight, dodging agility, and catching reflexes are discretized into probability tables.
- What is lost in the adaptation: The physical sting of the ball, diving saves on gym floors, and real-time spatial positioning.
## Implementation hints
Discrete state machine with clear zone partitions. Branching factor is `|opposing_infield|`. First milestone: Implement 1v1 throw-catch-life loop before adding full outfield revival and captain entry logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Burned Ball (Albanian Dodgeball) (Albania). (n.d.). Games of Countries. https://gamesofcountries.com/games/al-albania/topi-i-djegur
@misc{gamesofcountries-al-albania-topi-i-djegur,
title = {Burned Ball (Albanian Dodgeball) (Albania)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/al-albania/topi-i-djegur}
}