Formal Specification
Philippine Top Spinning / Battle Tops — Formal Specification
Philippines · top-spinning · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 4
# Trumpo — AI-optimized specification
## General idea
A turn-based physics-inspired top spinning and target ejection game in a 2D circular ring of radius meter. Agents alternate throwing their spinning top into the ring to strike stationary or spinning opponent tops. Successful strikes impart momentum to displace opponent tops outside the ring boundary while attempting to maintain the attacker's own spin stability. If an attacker's throw fails to achieve a valid spin or comes to rest inside the ring, their top becomes a vulnerable target (*patay*).
## Formal model
- **Abstraction taken:** Top physics are discretized into 2D planar positions , angular momentum / spin health , and wood durability structural health . Throwing aim samples a landing point around a chosen target coordinate with variance conditioned on player throwing skill.
- **Player/agent count:** 2 to 6 agents ().
- **Turn model:** Sequential strike rotation per round.
## Formal rules
R1. Setup:
- Circular arena of radius centered at .
- Player with lowest qualification spin time places their top in the center at with state `TARGET` (`spin = 0`, `durability = 100`).
- Remaining agents form a shooting queue .
R2. Strike Launch Action:
- Active shooter selects action `hurl_top(target_pos, force_level)`:
- Aim variance: where .
- Spin initialization: .
- Spin failure check (*kuryente*): .
- If spin fails: top lands dead inside the ring; agent 's top transitions to `TARGET` status in the ring [gap-fill].
R3. Collision Resolution:
- If thrown top lands within distance of a target top :
- Impact impulse: .
- Target displacement: [gap-fill].
- Target structural damage: .
- Attacker spin recoil: .
- If target position :
- Target is successfully evicted (*basyada*); shooter scores points.
- Target owner receives 1 penalty strike.
R4. Post-Strike Settle & Ring State:
- Attacker top continues spinning, losing spin at rate per tick.
- If attacker top exits ring () before , shooter remains safe.
- If attacker top stops spinning () while inside the ring (), it becomes an additional `TARGET` inside the ring.
R5. Match Termination:
- Match runs for full shooting cycles [gap-fill]. The agent with the highest accumulated score (and fewest penalty strikes) wins.
## Edge cases
- Tie at the end condition: If scores are tied after , a 1v1 spin-duration duel on flat ground breaks the tie (longest continuous spin wins) [gap-fill].
- A player with no legal move: `hurl_top()` is always available to active shooters.
- Repetition / cycles: Bounded by hard cycle cap and monotonic spin decay.
- Simultaneous claims on the same resource or position: Inapplicable under sequential turn execution.
- Player elimination mid-round: If a top's structural health reaches (split wood / *basag*), that top is permanently broken and its owner eliminated from the round.
- Resource exhaustion: Not applicable.
- Termination guarantee: Enforced by the finite round limit and deterministic spin damping.
## State representation
- Persistent state:
- `ring_radius`: float ().
- `target_tops`: list of struct `{owner_id, pos, health}` currently in the ring.
- `agent_scores`: array of size .
- `penalty_strikes`: array of size .
- `current_shooter_index`: integer .
- `cycle_count`: integer .
- Observable information: Fully observable public state (all top coordinates, ring boundary, and damage states are visible).
## Action space
- `hurl_top(target_x, target_y, force_level)`: coordinates , force float .
## Playability notes
- Single-player-vs-AI: Highly playable as a target billiards/battle-arena game with physics-driven risk calculation.
- Group games (n>4): Accommodates up to 6 players comfortably in a battle-royale ring setup.
- Physical-skill games: String winding tension and flick release are mapped to calibrated bivariate Gaussian landing distributions.
- What is lost in the adaptation: The tactile feel of wooden top grain, manual string winding rhythm, and real-world gyroscopic precession wobbles.
## Implementation hints
2D rigid body point-mass physics with radial boundary checks. Simple impulse transfer equations. First milestone: Implement 1 shooter vs 1 center target on a circular ring to calibrate impulse displacement thresholds.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Philippine Top Spinning / Battle Tops (Philippines). (n.d.). Games of Countries. https://gamesofcountries.com/games/ph-philippines/trumpo
@misc{gamesofcountries-ph-philippines-trumpo,
title = {Philippine Top Spinning / Battle Tops (Philippines)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ph-philippines/trumpo}
}