Formal Specification
Herzegovinian Boules — Formal Specification
Bosnia & Herzegovina · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Balote — AI-optimized specification
## General idea
A turn-based 2D precision bowling contest between two teams on a bounded rectangular alley (*zog*). Teams dynamically rotate throws according to the distance-to-jack advantage rule, choosing between precision rolling (*valjanje*) and high-impact aerial striking (*izbijanje*). Rounds award points strictly for all balls closer to the jack than the opponent's best ball.
## Formal model
- **Abstraction taken:** The 2D court contains a small target ball (bulin) at position and thrown boules at resting positions . Throws are modeled with 2D Gaussian error around intended target coordinates, coupled with rigid-body circle collision impulses when striking another ball.
- **Player/agent count:** 2 teams (Team A vs Team B), balls per team per round (pairs standard).
- **Turn model:** Dynamic sequential turn order: the team that is currently losing the point must throw next.
## Formal rules
R1. **Setup:** Court bounds with . Target match score . Score totals . Each team holds balls.
R2. **Round initiation:** The leading team places bulin randomly or targeted in , then throws their first ball .
R3. **Dynamic turn execution:**
- Team B throws ball .
- While both teams hold remaining balls:
- Let and .
- If : Team B is currently losing; Team B must throw next.
- If : Team A is currently losing; Team A must throw next.
- If one team exhausts all balls, the other team throws all its remaining balls sequentially.
R4. **Throw action mechanics:** Active agent chooses action `throw_boule(x_target, y_target, technique)`:
- `technique == ROLLING`: Ball rolls along vector to with standard deviation .
- `technique == STRIKING`: Ball flies aerially to landing zone with standard deviation . On direct hit with a target ball within contact radius , the target ball is displaced by impact vector .
R5. **Round scoring:** When all balls are thrown:
- Find absolute closest ball to : .
- Let winning team be and losing team be .
- Let .
- Points awarded to : Count of thrown balls satisfying .
- Update match score: .
R6. **Win condition:** The first team to achieve score wins the match.
## Edge cases
- **Tie at the end condition:** [gap-fill] If both teams have a ball at identical distance to at round end (), no points are awarded to either team, and the round is replayed.
- **A player with no legal move:** Not applicable; selecting coordinates within court bounds is always legal while balls remain in hand.
- **Repetition / cycles:** Score increments strictly monotonically (); match ends in finite rounds.
- **Simultaneous claims on the same resource:** Distances are continuously valued floating-point scalars; ties result in null score for that pair.
- **Player elimination mid-round / turn order repair:** Not applicable; fixed 2-team allocation.
- **Resource exhaustion:** Balls reset to per team at the start of each new round.
- **Termination guarantee:** Each round strictly consumes throw actions, and positive integer points are awarded in each decisive round toward target .
## State representation
- **Persistent state:** `score_team_A: int`, `score_team_B: int`, `lead_team: TeamID`, `round_index: int`.
- **Per-round ephemeral state:** `bulin_position: (float, float)`, `balls_on_court: List[{id: str, owner: TeamID, pos: (float, float)}]`, `balls_left: Dict[TeamID, int]`.
- **Observable information:** Fully observable state; all ball coordinates, jack position, and distances are public.
## Action space
- `throw_boule(target_x: float, target_y: float, mode: Enum{ROLLING, STRIKING})`: Continuous coordinates bounded by .
## Playability notes
- **Single-player-vs-AI:** Highly engaging; AI calculates the tactical utility of playing safe defensive rolls versus executing a high-risk strike to clear the winning ball.
- **Group reduction:** 3v3 and 2v2 team formats reduce directly to a 2-agent turn model controlling a unified pool of 4 or 6 boules.
- **Physical-skill games:** Delivery momentum and surface friction are modeled via 2D normal dispersion and linear deceleration.
- **What is lost:** Fine finger spin (backspin/curving), lane slope imperfections, and real-time court acoustics are abstracted.
## Implementation hints
- Standard 2D geometric engine; ball-to-ball collisions can be resolved as instantaneous 2D elastic disc collisions.
- Obvious trap: Misidentifying which team must throw next when multiple balls are thrown.
- Suggested first milestone: Implement the dynamic Bocce turn order loop and distance evaluator with deterministic placements.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Herzegovinian Boules (Bosnia & Herzegovina). (n.d.). Games of Countries. https://gamesofcountries.com/games/ba-bosnia-herzegovina/balote
@misc{gamesofcountries-ba-bosnia-herzegovina-balote,
title = {Herzegovinian Boules (Bosnia & Herzegovina)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ba-bosnia-herzegovina/balote}
}