Formal Specification
The Needle Game — Formal Specification
Estonia · singing-circle · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: discretizedGap-fills: 8
# Nõelamäng (The Needle Game) — AI-optimized specification
## General idea
A dramatic snake-chain pursuit game rooted in archaic runic song dialogue. A single buyer attempts to sprint around a protective "Needle Mother" to tag the rearmost "needle" at the tail of a linked human file, while the mother shields her brood through agile angular positioning and the chain sways to evade flank attacks.
## Formal model
- **Abstraction taken:** The continuous physical linked-waist human chain is modeled as a discrete kinematic snake chain on a 2D planar grid. The Mother controls the root node orientation, and linked needles follow with 1-tick segment lag. Tagging is evaluated on open-contact adjacency with the tail node.
- **Player/agent count:** 1 Buyer agent (), 1 Needle Mother agent (), Needle agents (, ). Total agents .
- **Turn model:** Synchronous discrete ticks; each successful capture initiates a new verse iteration.
## Formal rules
R1. Setup:
- 2D grid coordinates with Mother at origin .
- Needle chain: needles linked sequentially at positions directly behind Mother along vector [gap-fill: grid cell distance between links fixed at 1 unit].
- Buyer starts facing Mother at distance cells.
R2. Verse Dialogue Phase:
- Prior to each chase wave, the engine executes the fixed 4-line runic verse dialogue, locking positions for ticks [gap-fill: verse duration fixed at 4 ticks].
R3. Active Chase Phase:
- Both Buyer and Mother submit simultaneous directional movement actions:
- Buyer moves up to cells per tick in any unblocked direction.
- Mother moves up to cells per tick and rotates her defensive shield orientation .
- Kinematic chain update: Each needle segment advances to the prior position of segment with damping, modeling snake-like trailing dynamics [gap-fill: discrete inverse-kinematics segment lag formula].
R4. Defensive Shielding & Tagging:
- Mother projects a frontal/lateral blocking cone of radius cells; Buyer cannot cross through Mother's shield arc.
- Buyer's objective is to reach spatial adjacency () with the rearmost active needle (the tail).
- If Buyer achieves contact with :
1. Needle is captured and removed from Mother's chain.
2. joins a trailing chain behind Buyer ('s captured retinue).
3. Active needle count decrements: .
4. If , the wave resets to R2.
R5. Wave Timeout and Reset:
- [gap-fill: If Buyer fails to capture the tail within ticks, the Mother earns a defensive victory for that wave, and the Buyer is penalized with an extra 10-tick exhaustion slowdown in the next wave].
R6. Match End and Role Succession:
- The game concludes when all needles have been captured ().
- [gap-fill: The first needle captured during the match becomes the Buyer for the next match; if Buyer fails to capture all needles within waves, the Mother wins the overall game].
## Edge cases
- Tie at the end condition: If the final needle is captured on the exact final tick , capture takes strict priority [gap-fill: capture priority on timeout].
- A player with no legal move: Not applicable; Buyer and Mother always have valid unblocked directional movement vectors.
- Repetition / cycles: Bounded by the per-wave tick limit and finite total needle count [gap-fill: finite wave cap bounds cycles].
- Simultaneous claims on the same resource or position: Buyer cannot occupy cells within Mother's blocking cone; collisions are resolved as positional deflections.
- Player elimination mid-round; turn order repair: Captured needles transfer to Buyer's retinue; the chain length decreases cleanly without altering agent identity order.
- Resource exhaustion: Needles are strictly conserved; decreases monotonically by 1 per successful capture.
- Termination guarantee: Enforced by the finite needle count and the wave limit [gap-fill: termination guarantee via bounded waves and finite needles].
## State representation
- Persistent state:
- `active_needles`: Ordered list of remaining needle IDs in Mother's chain ().
- `captured_needles`: Ordered list of captured needle IDs.
- `mother_id`, `buyer_id`: Agent IDs.
- `wave_number`: Integer .
- Per-tick ephemeral state:
- `mother_pos`, `mother_heading`: .
- `buyer_pos`: .
- `needle_positions`: Array of coordinates .
- `wave_tick`: Integer .
- Observable information: Positions of all agents, chain links, and blocking cones are fully observable.
## Action space
- `move(dx, dy)`: (Buyer) Move up to cells.
- `steer_shield(dx, dy, dtheta)`: (Mother) Move and adjust protective arc angle.
- `brace()`: (Needles) Maintain chain link tension.
## Playability notes
- Single-player-vs-AI: Highly playable tactical action game. Human plays Buyer attempting to outmaneuver an AI Mother, or human plays Mother coordinating defensive shielding.
- Group games (n>4): Reduces to 1 Mother, 1 Buyer, and 1 Needle (). With 1 needle, chain lag disappears and becomes a 3-body orbital shielding problem.
- Physical-skill games: Physical chain momentum, waist gripping, and centrifugal swinging are abstracted into discrete segment lag equations.
- What is lost in the adaptation: The archaic runic chanting atmosphere, physical centrifugal whip forces on the tail player, and cooperative physical holding.
## Implementation hints
Model the needle chain using a standard discrete Verlet or kinematic follow-the-leader chain algorithm. First milestone: Implement Mother shielding cone and Buyer avoidance before building trailing needle segment lag.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
The Needle Game (Estonia). (n.d.). Games of Countries. https://gamesofcountries.com/games/ee-estonia/noelamang
@misc{gamesofcountries-ee-estonia-noelamang,
title = {The Needle Game (Estonia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ee-estonia/noelamang}
}