Skip to main content
Formal Specification

Škuljanje (Littoral Flat-Stone Boules) — Formal Specification

Slovenia · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Škuljanje — AI-optimized specification ## General idea A turn-based spatial target game where two agents cast flat stone projectiles onto a 2D plane relative to a moveable target sphere (*balin*). Strategic turn management dictates that the trailing agent must throw until regaining point advantage, with scoring awarded exclusively to the best-placed stone cluster at the end of each round. ## Formal model - **Abstraction taken:** Physical throwing physics (surface friction, stone bounce, aerodynamic skid) are abstracted into 2D landing distribution models centered on an intended aim coordinate (xaim,yaim), with displacement physics resolving collisions between stones. - **Player/agent count:** 2 agents (A1,A2) each equipped with K=2 stones (or 2 teams of 2 agents with K=2 each). - **Turn model:** Dynamic sequential turn order determined by point possession. ## Formal rules R1. Setup: Round target score Swin=13. State scores S1=0,S2=0. R2. Opening Target Cast: - Active leader casts target stone B to coordinate (xB,yB) where xB∈[8.0,12.0] m, yB∈[−1.5,1.5] m. R3. Throw Mechanics: - Agent declares action `point_throw(x_aim, y_aim)` or `strike_throw(target_stone_id)`. - Landing coordinate (xi,yi)∼𝒩((xaim,yaim),σskill2I). - If a stone strikes another stone or B, elastic 2D collision displacement is computed. R4. Turn Order Resolution: - After initial throws from each agent, let dmin(A1)=mini∈A1⁡‖(xi,yi)−B‖ and dmin(A2)=minj∈A2⁡‖(xj,yj)−B‖. - The agent whose best stone is currently furthest from B must take the next throw. - An agent continues throwing until their stone achieves dmin<dmin(opponent) or their stones are exhausted (K=0). - If one agent exhausts all stones, the other agent throws all remaining stones in sequence. R5. Round Scoring: - When all stones are cast, let the winning agent be Aw=arg⁡minA∈{A1,A2}⁡dmin(A) and losing agent Al. - Score for round: ΔS=|{i∈Aw:‖(xi,yi)−B‖<dmin(Al)}|. - Sw←Sw+ΔS. R6. Match End Condition: - If Sw≥13, agent Aw wins immediately. - Otherwise, Aw initiates next round from R2. ## Edge cases - Tie at the end condition: Not applicable; points are awarded strictly to one side per round, so scores cannot reach 13 simultaneously. - A player with no legal move: Not applicable; throw action is always available while stones remain. - Repetition / cycles: [gap-fill] If both agents have equidistant closest stones (d1=d2) and all stones are exhausted, round is declared null (ΔS=0) and replayed. - Simultaneous claims on the same resource or position: Physical collision physics ensures stones cannot occupy the exact same 2D coordinate. - Player elimination mid-round; turn order repair: In team play, if an agent disconnects, remaining teammate throws the remaining stones. - Resource exhaustion: Stones are reset to full count K at the start of each round. - Termination guarantee: [gap-fill] Positive minimum expected point yield per round (𝔼[ΔS]≥1) guarantees match termination in finite rounds. ## State representation - Persistent state: `score_A1: int`, `score_A2: int`, `round_number: int`, `leader_id: int`. - Ephemeral round state: `balin_pos: tuple[float, float]`, `active_stones: list[dict(id, agent_id, pos, is_thrown)]`. - Observable information: Fully observable (all coordinates and scores are public). ## Action space - `cast_balin(x: float, y: float)`: Position the target within legal bounds. - `throw_skulja(target_x: float, target_y: float, shot_type: enum[POINT, STRIKE])`: Throw stone. ## Playability notes - Single-player-vs-AI: Highly suitable; directly playable against AI evaluating distance geometry and risk/reward between pointing and striking. - Group games (n>4): Reduces naturally to 2 teams of 2 or 3 agents without rule alteration. - Physical-skill games: Motor skill parameterized by variance parameter σskill. - What is lost: Uneven tactile ground friction, wind drag, and custom stone hand-feel. ## Implementation hints Very clean implementation. Core loop requires 2D Euclidean distance evaluation and turn-state tracking. First milestone: implement 1v1 point-possession loop with deterministic throws, then add Gaussian landing noise.

Download as JSON

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

Download JSON
Cite this page

Škuljanje (Littoral Flat-Stone Boules) (Slovenia). (n.d.). Games of Countries. https://gamesofcountries.com/games/si-slovenia/skuljanje

@misc{gamesofcountries-si-slovenia-skuljanje,
  title = {Škuljanje (Littoral Flat-Stone Boules) (Slovenia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/si-slovenia/skuljanje}
}