Formal Specification
Traditional Croatian Boules — Formal Specification
Croatia · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Balote — AI-optimized specification
## General idea
A turn-based 2D precision boules simulation on a bounded lane where agents alternate throws based on dynamic point possession, aiming to position boules closer to the target sphere (*bulin*) than the opponent, with tactical options for ground rolling, high-arc aerial strikes (*volo*), and sideboard carom shots.
## Formal model
- **Abstraction taken:** Boule rolling friction, surface gravel imperfections, and high aerial impacts are abstracted into 2D landing coordinates centered on an intended aim coordinate with elastic ball-to-ball momentum transfer and sideboard wall reflections.
- **Player/agent count:** 2 agents () with 4 boules each (or 2 teams of 2 agents with 2 boules each). Total boules .
- **Turn model:** Sequential turn order controlled dynamically by point possession state.
## Formal rules
R1. Setup: Lane bounds: m, m. Sideboard walls at m. State scores . Win score .
R2. Opening Target Toss:
- Active leader casts target ball to coordinate with legal range m, m.
R3. Action Selection:
- `valjanje_roll(aim_x, aim_y)`: Rolling shot with low dispersion along longitudinal axis.
- `volo_strike(target_id)`: High-velocity aerial strike targeting a specific ball coordinate; if hit succeeds, target ball is displaced by momentum vector.
- `carom_shot(wall_aim_x, wall_side: enum[LEFT, RIGHT])`: Sideboard bank shot bouncing at incident angle with friction damping.
R4. Dynamic Turn Order:
- Let .
- Current leader is . Trailing agent is .
- must take the next throw while holding remaining boules ().
- If , plays all remaining boules sequentially.
R5. Round Scoring:
- When all 8 boules are on court, let winning agent be with minimum distance .
- Let closest opponent boule distance be .
- Points awarded: .
- .
R6. Match Victory:
- If , agent wins immediately.
- Otherwise, leads next round casting target from R2.
## Edge cases
- Tie at the end condition: Not applicable; scoring is strictly one-sided per round.
- A player with no legal move: Not applicable; throwing actions are always legal while boules remain.
- Repetition / cycles: [gap-fill] If opposing closest boules are equidistant at end of round, round is null (0 points) and replayed.
- Simultaneous claims on the same resource or position: Physical collision physics ensures balls disperse upon impact.
- Player elimination mid-round; turn order repair: In doubles, remaining teammate takes all remaining throws for their side.
- Resource exhaustion: Boule inventory resets to full count at the start of each round.
- Termination guarantee: [gap-fill] Positive expected points per round () guarantees match termination in finite rounds.
## State representation
- Persistent state: `score_A1: int`, `score_A2: int`, `round_index: int`, `leader_id: int`.
- Ephemeral round state: `bulin_pos: tuple[float, float]`, `boules_on_court: list[dict(id, agent_id, pos, is_active)]`, `boules_in_hand: dict[int, int]`.
- Observable information: Fully observable (all positions and scores are public).
## Action space
- `cast_bulin(x: float, y: float)`: Target toss.
- `valjanje_roll(x: float, y: float)`: Ground pointing throw.
- `volo_strike(target_id: int)`: Direct aerial displacement shot.
- `carom_shot(wall_x: float, side: enum[LEFT, RIGHT])`: Sideboard bounce shot.
## Playability notes
- Single-player-vs-AI: Engine-ready; standard spatial evaluation of pointing vs striking vs carom risk profiles.
- Group games (n>4): Generalizes to 2v2 doubles or 4v4 fours without changing core mechanics.
- Physical-skill games: Parameterized by 2D Gaussian covariance matrices for pointing and shooting.
- What is lost: Dalmatian tavern ambiance, lively spectators arguing over millimeter measurements with twigs.
## Implementation hints
Standard target toss architecture with 2D line reflection physics for sideboards. First milestone: implement 1v1 pointing and shooting with deterministic outcomes, verifying dynamic possession rules before calibrating collision dynamics.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Traditional Croatian Boules (Croatia). (n.d.). Games of Countries. https://gamesofcountries.com/games/hr-croatia/balote
@misc{gamesofcountries-hr-croatia-balote,
title = {Traditional Croatian Boules (Croatia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/hr-croatia/balote}
}