Formal Specification
Bottle Cap Race (Peace Race on Caps) — Formal Specification
Poland · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 0
# Gra w kapsle — AI-optimized specification
## General idea
A turn-based micro-racing dexterity simulation along a constrained 2D spline track. Agents choose flick vectors (force magnitude and heading angle) to maximize track progress while mitigating the risk of centrifugal boundary violations (*wypad*) that reset progress to the turn's starting coordinate.
## Formal model
- **Abstraction taken:** The continuous finger flick and surface friction are modeled as a 2D physics impulse vector subject to Gaussian execution noise parameterized by agent dexterity. The track is represented as a sequence of connected 2D polygon segments with defined centerlines and lateral boundary widths .
- **Player/agent count:** 2 to 6 agents, sequential rotation.
- **Turn model:** Strictly sequential turns in fixed cyclic order.
## Formal rules
R1. **Track initialization:** A piecewise linear or Bezier curve from progress (Start) to (Finish) with lateral width .
R2. **Turn sequence:** The active agent records starting position and submits a chosen action `flick(power, angle)`.
R3. **Motion simulation:**
- Realized impulse .
- Cap trajectory is integrated under ground friction until velocity reaches 0, producing landing coordinate .
R4. **Boundary collision & off-track check (*Wypad*):**
- If the trajectory segment or final resting point exceeds the lateral track boundary :
- State reverts immediately to (0 progress gained).
- If remains within the track corridor:
- New state becomes with updated longitudinal progress .
R5. **Agent-to-agent collision:**
- If cap collides with cap during motion, momentum is transferred elastically. If cap is knocked outside the boundary, cap is reset to its pre-round position.
R6. **Victory condition:** The first agent whose cap reaches or exceeds the finish line within track bounds terminates the race and wins 1st place.
## Edge cases
- **Tie at the end condition:** Not applicable; turns are strictly sequential, and the first agent to cross the finish line on their turn wins immediately.
- **A player with no legal move:** Not applicable; a flick action of any valid power/angle is always available.
- **Repetition / cycles:** Bounded because an agent always has a strictly positive probability of choosing a safe, low-power forward flick that advances progress without off-track penalty.
- **Simultaneous claims on the same resource or position:** Physical collision mechanics (R5) displace resting caps slightly so no two caps occupy the exact same coordinate.
- **Player elimination mid-round; turn order repair:** Not applicable; all players remain active until crossing the finish line.
- **Resource exhaustion:** Not applicable; caps are persistent, track does not degrade.
- **Termination guarantee:** Guaranteed by the positive drift of optimal safe actions along the 1D path .
## State representation
- **Persistent state:** `track_geometry` (List of Polyline vertices), `turn_order` (List[AgentId]), `active_index` (0..N-1), `placements` (List[AgentId]).
- **Per-player state:** `current_pos` (), `last_valid_pos` (), `is_finished` (Bool).
- **Observable information:** Fully observable state; all cap coordinates and track boundaries are known to all agents.
## Action space
- `flick(power: Float[0.1..1.0], angle_degrees: Float[-180..180])`: Executes physical flick impulse.
## Playability notes
- **Single-player-vs-AI:** Highly engine-ready — time trial race against AI bots utilizing varying risk profiles (aggressive power vs. conservative cornering).
- **Group games (n>4):** Scales natively from 2 to 6 agents with zero structural modification.
- **Physical-skill games:** Skill is modeled as the standard deviation of the Gaussian noise applied to intended vectors.
- **What is lost:** Tactile thumb/index finger pressure nuances and surface micro-imperfections (pavement cracks, pebbles).
## Implementation hints
Very lightweight simulation. The core computational requirement is standard 2D point-in-polygon containment or signed distance field (SDF) evaluation against the track corridor. First milestone: implement a 2D oval track with deterministic friction and boundary penalty, then add stochastic flick dispersion.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Bottle Cap Race (Peace Race on Caps) (Poland). (n.d.). Games of Countries. https://gamesofcountries.com/games/pl-poland/gra-w-kapsle
@misc{gamesofcountries-pl-poland-gra-w-kapsle,
title = {Bottle Cap Race (Peace Race on Caps) (Poland)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/pl-poland/gra-w-kapsle}
}