Formal Specification
Snap Apple / Irish Halloween Apple Games — Formal Specification
Ireland · festival-ritual · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: abstractedGap-fills: 1
# Cleas na nÚll — AI-optimized specification
## General idea
A high-timing dexterity game where players take turns timing lunges with their mouth to bite into a spinning, oscillating apple suspended on a rotating crossbeam while avoiding counter-weight penalty hazards without using hands.
## Formal model
- **Abstraction taken:** The rotating cross is modeled as a periodic harmonic oscillator with rotational angle `θ(t) = ω * t` and vertical pendulum bobbing `y(t) = y_0 + A * sin(ω_y * t)`. The player's bite action is declared with a specific timing offset `t_lunge` and vertical jaw height `y_bite`. Accuracy is corrupted by Gaussian execution noise.
- **Player/agent count:** 4 competing agents (`P_1, P_2, P_3, P_4`).
- **Turn model:** Sequential rounds of 3 bite attempts per agent across 5 rounds.
## Formal rules
R1. Game state setup: Cross apparatus angular velocity `ω = 2π rad/s`, vertical oscillation amplitude `A = 10 cm`. Cross has 2 apple targets at `θ = 0, π` and 2 penalty candle/flour hazards at `θ = π/2, 3π/2`. Scores initialized: `score[P_i] = 0`.
R2. On an agent's turn, the active agent executes 3 bite attempts: `attempt_bite(t_offset, elevation)`.
R3. Bite attempt resolution:
- Evaluated target state at tick `t = t_offset`:
* Angular position: `θ_actual = (ω * t) mod 2π`.
* Target coordinate `(x_target, y_target)` computed from geometry.
* Player bite landing: `(X_bite, Y_bite) ~ N((0, elevation), σ² * I)`.
- Contact checking:
* If `||(X_bite, Y_bite) - pos(Apple)|| ≤ 4.0 cm`: Outcome is `APPLE_BITE` (+10 points).
* If `||(X_bite, Y_bite) - pos(Hazard)|| ≤ 4.0 cm`: Outcome is `HAZARD_HIT` (-5 penalty points).
* Otherwise: Outcome is `MISS` (0 points).
R4. Cumulative score update:
- Scored points are added to `score[P_i]`.
R5. Turn alternation: Active agent index advances clockwise `(active_id % 4) + 1`.
R6. Match victory:
- After all agents complete 5 rounds (15 total attempts each), the agent with `argmax(score[P_i])` is declared the winner.
- [gap-fill] Sudden-death tie-breaker: If scores are tied after 5 rounds, tied agents execute 1 sudden-death bite attempt against a single high-speed spinning apple.
## Edge cases
- Tie at the end condition: Resolved via 1 sudden-death round of single-lunge attempts.
- A player with no legal move: Not applicable; an agent always selects time and elevation parameters within continuous ranges.
- Repetition / cycles: Governed by the strict 5-round (15 attempts) limit per player.
- Simultaneous claims on the same resource or position: Attempts are performed sequentially.
- Player elimination mid-round: If an agent disconnects, remaining agents finish their round quota.
- Resource exhaustion: Attempts and round numbers are strictly conserved.
- Termination guarantee: Monotonically progressing round and attempt counters guarantee termination.
## State representation
- Persistent state: Scores `score[agent_id]`, current round index (1..5), active agent ID.
- Per-player state: Skill rating `timing_precision`, history of attempts.
- Per-turn ephemeral state: Attempt index (1..3), simulated kinematics `(θ, y)`, collision outcomes.
- Observable information: Continuous tracking of cross angular velocity, vertical oscillation frequency, and current player scores.
## Action space
- `attempt_bite(t_offset: [0.0..1.0], elevation: [-10..+10] cm)`: Timed lunge with mouth open at predicted intercept point.
## Playability notes
- Single-player-vs-AI: Playable as a timing prediction challenge against periodic harmonic motion.
- Group games (n>4): Naturally scales across 2 to 12 players.
- Physical-skill games: Mouth dexterity and visual-spatial interception parameterized into kinematic intersection tests.
- What is lost: The cold splash of water and the sweet smell of apples in a turf-warmed Irish cottage.
## Implementation hints
Treat cross kinematics as an analytical trigonometric equation evaluated at `t = t_offset`. Collision resolution is a simple distance check between 2D circles.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Snap Apple / Irish Halloween Apple Games (Ireland). (n.d.). Games of Countries. https://gamesofcountries.com/games/ie-ireland/cleas-na-null
@misc{gamesofcountries-ie-ireland-cleas-na-null,
title = {Snap Apple / Irish Halloween Apple Games (Ireland)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ie-ireland/cleas-na-null}
}