Skip to main content
Formal Specification

Guatemalan Cup-and-Ball — Formal Specification

Guatemala · dexterity-small · Confidence: low

← Back to game page

Implementation 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 JSON
Cite 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}
}