Skip to main content
Formal Specification

The Buzzer (Sudanese String Whirligig) — Formal Specification

Sudan · dexterity-small · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Al-Zannana — AI-optimized specification ## General idea A bimanual rhythm oscillation and kinetic endurance game. Agents synchronize tension pulls and relaxation releases with the twisting cycle of a threaded disc to maximize rotational RPM and acoustic frequency while surviving contact friction duels against an opponent's disc. ## Formal model - **Abstraction taken:** Torsional string spring dynamics are modeled as a non-linear oscillator: θ(t) (twist angle), ω(t) (angular velocity), and string tension T(t) controlled by discrete agent pull actions. - **Player/agent count:** 2 agents in a direct duel. - **Turn model:** Synchronous discrete ticks (50ms per tick). ## Formal rules R1. State Variables per agent: `twist_angle` θ∈[−θmax⁡,θmax⁡], `angular_velocity` ω∈ℝ, `string_health` H∈[0,100], `rpm_score: float`. R2. On each tick, active agent selects hand action: `PULL_TENSION(force)` (F∈[0,10]) or `RELAX_SLACK()`. R3. Dynamic Oscillator Equations: - Torsional torque: τspring=−kθ. - Pull torque: τpull=F⋅sgn(ω) if tension is applied while unwinding (|θ| decreasing). - Angular acceleration: α=τspring+τpull−bωIdisc. - State updates: ωt+1=ωt+αΔt, θt+1=θt+ωtΔt. R4. Mistiming & String Stress: - If agent executes `PULL_TENSION` while the string is already fully wound (|θ|≈θmax⁡), string stress causes damage: Ht+1=Ht−5.0. - If disc stalls (ω≈0 at θ=0), the whirligig dies (`STALLED`, agent must spend 10 ticks rewinding). R5. Mid-Air Cutting Contact: - When agents engage in contact duel: - Relative RPM advantage Δω=|ωA|−|ωB|. - Damage inflicted on inferior disc: ΔHB=0.05×Δω. - If string health H≤0, string snaps (`SEVERED`); the other agent wins immediately (+10 points). R6. [gap-fill] Time Limit: Maximum 100 ticks per duel. If neither string is severed, the agent with higher accumulated average RPM wins. ## Edge cases - Tie at the end condition: If accumulated average RPM is within ±1% at tick 100, the duel is declared a draw. - A player with no legal move: Actions `PULL_TENSION` and `RELAX_SLACK` are always available. - Repetition / cycles: Bounded by the 100-tick hard limit (R6). - Simultaneous claims on the same resource or position: Handled by continuous torque integration and differential damage calculations (R5). - Player elimination mid-round; turn order repair: Snapping of either agent's string ends the duel instantly. - Resource exhaustion (pieces, tokens, space, time): String health H strictly depletes under contact; ticks capped at 100. - Termination guarantee: Monotonic time progression to 100 ticks and string health depletion. ## State representation - Persistent state: `match_scores`: `{AGENT_A: int, AGENT_B: int}`. - Per-tick state: - `agent_states`: map of `agent_id` to `{theta: float, omega: float, string_health: float, avg_rpm: float}`. - `tick_counter`: integer in `0..100`. - Observable information: Both agents' rotational RPM, string health, and match scores are public. ## Action space - `act(choice, force)`: `choice ∈ {PULL_TENSION, RELAX_SLACK}`, `force ∈ [0, 10]`. ## Playability notes - Single-player-vs-AI: Engine-ready; play as human rhythmic puller testing harmonic synchronization and RPM against AI. - Group games (n>4): Extends to multi-agent acoustic volume contests or tournament brackets. - Physical-skill games: Bimanual rhythmic pull-relax timing is modeled as torsional oscillator phase coordination. - What is lost in adaptation: The physical vibrations through the fingers and the distinctive auditory drone sound. ## Implementation hints Standard torsional harmonic oscillator integration. First milestone: implement θ and ω state updates, verify alternating bidirectional spin cycles, before adding cutting contact damage.

Download as JSON

Download the full game corpus entry for this game as structured JSON.

Download JSON
Cite this page

The Buzzer (Sudanese String Whirligig) (Sudan). (n.d.). Games of Countries. https://gamesofcountries.com/games/sd-sudan/al-zannana

@misc{gamesofcountries-sd-sudan-al-zannana,
  title = {The Buzzer (Sudanese String Whirligig) (Sudan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/sd-sudan/al-zannana}
}