Formal Specification
Pendulum Skittles / String Bowling — Formal Specification
Slovenia · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Kegljanje na vrvici — AI-optimized specification
## General idea
A pendulum trajectory target game where an agent launches a tethered spherical bob in an orbital arc around a vertical gallows axis. The bob must clear the target platform on the outward swing and strike a 3×3 diamond cluster of standing skittle pins strictly on its return arc, with scoring determined by the count of pins knocked down.
## Formal model
- **Abstraction taken:** The 3D spherical pendulum physics (rope tension, gravity, impact collisions) is abstracted into an initial launch angle and velocity . Return arc intersection with the pin diamond is modeled via a stochastic hit-mask generator conditioned on swing trajectory parameters.
- **Player/agent count:** agents (, with , standard ).
- **Turn model:** Strictly sequential series of throws per agent.
## Formal rules
R1. Setup:
- 9 pins arranged in a diamond grid .
- State of pins: . Full rack .
R2. Launch Action:
- Active agent commits action `launch_pendulum(angle: float, force: float)`.
- Arc validity check: If (direct forward throw), launch is `FOUL` and scores 0 points.
R3. Return Arc Pin Collision:
- On valid outward arc, return trajectory sweeps across platform along path .
- Each standing pin has topple probability .
- Felled pins are removed from the board.
- Score for throw: .
- Standing pins update: .
R4. Discipline Protocol:
- In "In Full" (*V polno*) mode: is reset to all 9 pins before every throw.
- In "Clearing" (*Čiščenje*) mode: resets to 9 ONLY when .
R5. Match Scoring & Victory:
- [gap-fill] Each agent executes exactly 10 throws "In Full" and 10 throws "Clearing" (total 20 throws).
- The agent with the highest cumulative fallen pin total wins the competition.
## Edge cases
- Tie at the end condition: Tied scores resolved by sudden-death single throw "In Full" until a score differential occurs.
- A player with no legal move: Launch action is always legal while throw quota remains.
- Repetition / cycles: Bounded by finite fixed throw quota (20 throws per agent).
- Simultaneous claims on the same resource or position: Throws are strictly sequential; the apparatus is occupied by one agent at a time.
- Player elimination mid-round; turn order repair: If an agent disconnects, their remaining throw scores are recorded as 0; next agent throws.
- Resource exhaustion: Pin rack is automatically replenished per discipline rules.
- Termination guarantee: Exact 20-throw counter per agent guarantees deterministically finite termination.
## State representation
- Persistent state: `agent_scores: dict[int, int]`, `throws_completed: dict[int, int]`, `active_agent_idx: int`.
- Ephemeral turn state: `standing_pins: set[int]`, `swing_trajectory: tuple[float, float]`, `felled_pins: set[int]`.
- Observable information: Fully observable (pin configuration and scores are public).
## Action space
- `launch_pendulum(angle_degrees: float, release_speed: float)`: Launch trajectory parameters.
## Playability notes
- Single-player-vs-AI: Natural as a solitaire score-attack or 1v1 turn-alternating contest.
- Group games (n>4): Natively scales to large leagues via cumulative score tallying.
- Physical-skill games: Elliptical pendulum kinematics parameterized via orbital release angle and velocity.
- What is lost: Visual rope oscillation, wooden clatter of splintering pins on the platform.
## Implementation hints
Low complexity. The core is an elliptical trajectory intersection test against a 9-point grid. First milestone: implement a 1v1 game with 10 throws per agent and deterministic hit-mask lookups.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Pendulum Skittles / String Bowling (Slovenia). (n.d.). Games of Countries. https://gamesofcountries.com/games/si-slovenia/kegljanje-na-vrvici
@misc{gamesofcountries-si-slovenia-kegljanje-na-vrvici,
title = {Pendulum Skittles / String Bowling (Slovenia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/si-slovenia/kegljanje-na-vrvici}
}