Formal Specification
The Buzzer (Sudanese String Whirligig) — Formal Specification
Sudan · dexterity-small · Confidence: medium
← Back to game pageImplementation 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: (twist angle), (angular velocity), and string tension 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` , `angular_velocity` , `string_health` , `rpm_score: float`.
R2. On each tick, active agent selects hand action: `PULL_TENSION(force)` () or `RELAX_SLACK()`.
R3. Dynamic Oscillator Equations:
- Torsional torque: .
- Pull torque: if tension is applied while unwinding ( decreasing).
- Angular acceleration: .
- State updates: , .
R4. Mistiming & String Stress:
- If agent executes `PULL_TENSION` while the string is already fully wound (), string stress causes damage: .
- If disc stalls ( at ), the whirligig dies (`STALLED`, agent must spend 10 ticks rewinding).
R5. Mid-Air Cutting Contact:
- When agents engage in contact duel:
- Relative RPM advantage .
- Damage inflicted on inferior disc: .
- If string health , 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 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 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 JSONCite 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}
}