Formal Specification
Guatemalan Cup-and-Ball — Formal Specification
Guatemala · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: discretizedGap-fills: 3
# Capirucho (Guatemala) — AI-optimized specification
> **Reconstructed source.** The entry carries a provenance warning: its rules were written from
> general knowledge, not read from the two works it cites (Ministerio de Cultura; CEFOL).
## General idea
An iconic Guatemalan folk dexterity toy and competitive street pastime, hand-turned from avocado or pine
wood in traditional artisanal workshops (such as those in Totonicapán). A bell-shaped wooden cup (*Capirucho*)
is attached by a 30 cm cord to a wooden spindle handle. Players swing the weighted cup upward in aerial arcs,
attempting to impale it cleanly onto the spindle point through a sequence of increasingly complex acrobatic
tricks (simple swing, double aerial flip, reverse spindle capture). Players take turns attempting prescribed
trick routines; missing a capture forfeits the turn to the next player. The first player to successfully complete
all prescribed trick routines wins the match.
## Formal model
- **Abstraction taken:** Discretized cup-and-ball pendulum dynamics and catch alignment. Continuous string
tension, cup rotational inertia, and spindle insertion angles are discretized into per-trick stochastic success checks.
- **Player/agent count:** 1 to 6 players in turn rotation (entry §Players).
- **Turn model:** Round-robin sequential turns; an active player continues attempting trick routines until missing a catch.
## Formal rules
R1. Equipment (entry §Players & materials): a **turned wooden capirucho cup** connected to a **wooden spindle
handle by a 30 cm cord**.
R2. Trick sequence agreement (entry §1): players agree on a progressive **sequence of trick routines**
(e.g. Simple Swing, Single Flip, Double Flip, Reverse Spindle, Sombrero).
R3. Turn rotation and faults (entry §2): players take turns attempting the current trick in sequence;
**missing a capture immediately forfeits the turn** to the next player.
R4. Point values / trick progression (entry §3): points or stage advancement are awarded for successful catches
based on trick difficulty (1 point for direct swing, 3 points for aerial rotation).
R5. Win condition (entry §4): the **first player to successfully land all prescribed trick routines** wins the match.
R6. Turn resumption:
[gap-fill: on regaining a turn, a player resumes attempting the trick stage they previously missed].
R7. Discretization of aerial trick difficulty:
[gap-fill: trick success is modelled via binomial probabilities parameterized by player hand-eye coordination
and trick complexity rating].
R8. Free-style bonus trick:
[gap-fill: landing 3 consecutive tricks without missing earns a bonus attempt on the next stage].
## Edge cases
- Tie at the end: unaddressed; first player to land the final trick (R5) wins immediately; ties are impossible.
- A player with no legal move: not applicable; every active player on their turn attempts their current trick.
- Repetition / cycles: player stage progress is monotone non-decreasing; turn rotation across 1-6 players
retains individual completed tricks.
- Simultaneous claims on one position: not applicable; players execute trick attempts sequentially.
- Elimination mid-round and turn-order repair: no player elimination; turn rotation remains invariant.
- Resource exhaustion: trick stages are fixed and finite; player progress advances monotonically toward the final stage.
- Termination guarantee: guaranteed with probability 1; because stage progress is preserved and each trick attempt
has a positive probability of success, a player completes the final trick in finite turns almost surely via hazard rate.
## State representation
- Persistent state: `current_trick_idx[p]` ∈ {0..Total_Tricks}, `active_player` ∈ {0..n-1}.
- Per-attempt ephemeral state: `swing_angle`, `rotational_flips`, `catch_clean` (bool).
- Observable information: fully observable public trick progress and scores.
## Action space
- `attempt_trick(trick_id)`: active player swings and attempts to catch cup on spindle for current trick (R2, R3).
## Playability notes
- Single-player-vs-AI: delightful dexterity arcade challenge balancing trick difficulty and rhythm.
- Reducing n > 4 to 2 agents: lossless; functions identically for 2 players (or solo high score).
- Physical-skill games: continuous pendulum swinging and spindle alignment are mapped to timing window ratings.
- What is lost: the polished avocado wood fragrance, rhythmic hollow wooden "clack" on impaling, and Guatemalan highland street banter.
## Implementation hints
Define 5 progressive tricks with success probabilities: `[0.85, 0.70, 0.55, 0.40, 0.25]`. When `attempt_trick`
succeeds, increment `current_trick_idx[active_player]`; if `current_trick_idx == 5`, declare victory immediately.
On failure, advance `active_player = (active_player + 1) % n`. Suggested first milestone: 5-stage trick
state machine with single/multi-player turn rotation.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Guatemalan Cup-and-Ball (Guatemala). (n.d.). Games of Countries. https://gamesofcountries.com/games/gt-guatemala/capirucho-guatemalteco
@misc{gamesofcountries-gt-guatemala-capirucho-guatemalteco,
title = {Guatemalan Cup-and-Ball (Guatemala)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/gt-guatemala/capirucho-guatemalteco}
}