Formal Specification
Gibraltar Spinning Top — Formal Specification
Gibraltar · top-spinning · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Trompo — AI-optimized specification
## General idea
A spinning top contest modeling both ring ejection battles and spin endurance. Agents launch tops with parameterized velocity and spin vectors into a bounded 2D circle, attempting to knock opponent tops across the perimeter line while maintaining their own spin equilibrium.
## Formal model
- **Abstraction taken:** The 3D rotational mechanics and friction dynamics of the wooden top (*trompo*) on pavement are abstracted into 2D circle physics with an angular momentum decay scalar `Spin_RPM(t) = RPM_0 * exp(-lambda * t)`. Collisions are modeled via 2D elastic impulse resolution.
- **Player/agent count:** 2 to 8 players.
- **Turn model:** Round-based. Within each round, players take sequential aim-and-launch actions into the ring.
## Formal rules
R1. Setup: A circle of radius `R_ring = 0.75` meters is centered at `(0, 0)`. Target top starts stationary at `(0, 0)`.
R2. Round execution:
R2.1. On their turn, an active agent inputs a launch vector `(target_x, target_y)` and launch power `W in [0, 1]`.
R2.2. The resolver samples landing coordinate `pos_land ~ Normal(target, sigma(skill))` and initial spin `RPM_0 ~ Normal(3000 * W, 200)`.
R2.3. If `pos_land` falls outside `R_ring`, the launch is a foul, scoring 0 points.
R2.4. If `pos_land` collides with a top inside the ring, momentum transfer is resolved: target top acquires velocity `v_target`, displacing it.
R2.5. If the target top's position exceeds `R_ring` (`||pos_target|| > R_ring`), the active player scores 1 point (*ejection success*).
R2.6. If the active top ceases spinning (`Spin_RPM <= 0`) while remaining inside `R_ring`, it becomes a stationary target for subsequent players.
R3. [gap-fill] Scoring & victory: A match consists of 5 rounds. The player with the most cumulative ejection points and spin victories wins the match.
R4. [gap-fill] Turn order rotation: The player with the lowest score launches first in the subsequent round.
## Edge cases
- Tie at the end condition: If top players are tied after 5 rounds, a 1-round simultaneous spin endurance trial determines the winner.
- A player with no legal move: Not applicable — launch actions are always available.
- Repetition / cycles: Bounded by the fixed 5-round limit (R3).
- Simultaneous claims on the same resource or position: In sequential mode, launches occur one at a time. In simultaneous endurance mode, collisions between spinning tops are resolved in order of contact timestamp.
- Player elimination mid-round: If an agent disconnects, their top is removed from the ring and turn order continues.
- Resource exhaustion: Not applicable — tops are retrieved after each round.
- Termination guarantee: Guaranteed by the finite round count and positive friction decay `lambda > 0` which forces all spin to zero in finite time.
## State representation
- Persistent state: `match_round` (int 1..5), `scores` (map of player_id -> int), `turn_order` (list of player_ids).
- Per-round ephemeral state: `active_tops` (list of entities with `pos (x,y)`, `velocity (vx,vy)`, `spin_rpm (float)`, `is_spinning (bool)`).
- Observable information: Fully observable by all agents.
## Action space
- `launch_top(target_x, target_y, power)`: Specify launch aim coordinates within the ring and release power scalar.
## Playability notes
- Single-player-vs-AI: Natural — human player competes against AI in precision targeting and collision physics.
- Group games (n>4): Ring battle scales cleanly with sequential turns.
- Physical-skill games: String winding tension and wrist snap abstracted into `power` and `sigma(skill)`.
- What is lost: The tactile mastery of cord tension and the kinetic spectacle of wooden tops buzzing on pavement.
## Implementation hints
Standard 2D rigid-body circle physics simulation with rotational friction dampening. Suggested milestone: Verify R2.4–R2.5 ejection boundary checks with a single stationary target before adding multi-top collisions.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Gibraltar Spinning Top (Gibraltar). (n.d.). Games of Countries. https://gamesofcountries.com/games/gi-gibraltar/trompo-gibraltar
@misc{gamesofcountries-gi-gibraltar-trompo-gibraltar,
title = {Gibraltar Spinning Top (Gibraltar)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/gi-gibraltar/trompo-gibraltar}
}