Skip to main content
Formal Specification

Herzegovinian Boules — Formal Specification

Bosnia & Herzegovina · dexterity-throw · Confidence: low

← Back to game page

Implementation 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 [0,3.0]×[0,20.0] meters contains a small target ball (bulin) at position B∈ℝ2 and thrown boules at resting positions pi∈ℝ2. 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), K=4 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 [0,Wcourt]×[0,Lcourt] with Wcourt=3.0,Lcourt=20.0. Target match score Mwin=16. Score totals SA=0,SB=0. Each team holds K=4 balls. R2. **Round initiation:** The leading team places bulin B=(xb,yb) randomly or targeted in [0.5,2.5]×[12.0,18.0], then throws their first ball a1. R3. **Dynamic turn execution:** - Team B throws ball b1. - While both teams hold remaining balls: - Let dA∗=mins∈ThrownA⁡‖ps−B‖2 and dB∗=mins∈ThrownB⁡‖ps−B‖2. - If dA∗<dB∗: Team B is currently losing; Team B must throw next. - If dB∗<dA∗: 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 (xtarget,ytarget) with standard deviation σroll=0.20⋅(1.1−skill). - `technique == STRIKING`: Ball flies aerially to landing zone with standard deviation σstrike=0.35⋅(1.1−skill). On direct hit with a target ball within contact radius rcontact=0.15 m, the target ball is displaced by impact vector Δp. R5. **Round scoring:** When all 2K balls are thrown: - Find absolute closest ball to B: s∗=arg⁡mins⁡‖ps−B‖2. - Let winning team be Twin=owner(s∗) and losing team be Tloss. - Let dloss=mins∈ThrownTloss⁡‖ps−B‖2. - Points awarded to Twin: Count of thrown balls s∈ThrownTwin satisfying ‖ps−B‖2<dloss. - Update match score: STwin←STwin+Points. R6. **Win condition:** The first team to achieve score S≥Mwin wins the match. ## Edge cases - **Tie at the end condition:** [gap-fill] If both teams have a ball at identical distance to B at round end (Δd≤1 mm), 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 (S≥0); 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 K per team at the start of each new round. - **Termination guarantee:** Each round strictly consumes 2K throw actions, and positive integer points are awarded in each decisive round toward target Mwin=16. ## 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 x∈[0.0,3.0],y∈[0.0,20.0]. ## 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 JSON
Cite 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}
}