Formal Specification
Nail Dropping — Formal Specification
Netherlands · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Spijkerpoepen — AI-optimized specification
## General idea
A physical coordination and balance challenge where an agent controls hip translation and squat depth to guide a swinging pendulum (nail) into a narrow circular aperture (bottle neck) under gravitational oscillation and time pressure without using hands.
## Formal model
- **Abstraction taken:** The dangling nail on a string is modeled as a 2D damped spherical pendulum attached to the agent's pelvis origin `(x_hip, y_hip, z_hip)`. The bottle mouth is a static circular target at `(0, 0, z_bottle)` with radius `r_target = 0.01` m. The agent executes discrete positional adjustments `(delta_x, delta_y, squat_rate)` per time tick (`dt = 0.1` s) to damp oscillation and achieve target entry.
- **Player/agent count:** 1 to n agents competing in parallel or sequential time trials.
- **Turn model:** Real-time ticked simulation (tick length `dt = 0.10` seconds) bounded by a maximum time cap `T_max = 60.0` s.
## Formal rules
R1. Setup: Bottle target fixed at origin `(0, 0, 0.30)`. Agent's initial hip position initialized at `(x_0, y_0, 0.90)`. Pendulum string length `L = 0.55` m. Nail mass `m = 0.05` kg. Time elapsed `t = 0.0`.
R2. On each tick `dt`, the agent chooses an action: `adjust_posture(delta_x, delta_y, squat_velocity)`.
R3. Dynamic State Update:
- Hip coordinates update: `(x_hip, y_hip, z_hip) += (delta_x, delta_y, -squat_velocity * dt)`.
- Pendulum swing angle `(theta_x, theta_y)` updates under damped harmonic motion:
`theta'' = -(g/L)*sin(theta) - gamma*theta' + (a_hip / L)`.
- Nail tip coordinate computed as:
`nail_pos = (x_hip + L*sin(theta_x), y_hip + L*sin(theta_y), z_hip - L*cos(theta_x)*cos(theta_y))`.
R4. Bottle Entry Check:
- If `z_nail <= z_bottle` and `sqrt(nail_x^2 + nail_y^2) <= r_target`:
- Nail successfully enters bottle neck. Attempt concludes with recorded time `t_final = t`.
- If `z_nail <= z_bottle` and `sqrt(nail_x^2 + nail_y^2) > r_target`:
- Nail strikes outer rim of the bottle; nail deflects with elastic rebound [gap-fill: kinetic bounce impulse added to pendulum velocity].
R5. Bottle Tip Fault:
- If `abs(x_hip) > 0.40` or `abs(y_hip) > 0.40` during a deep squat `(z_hip < 0.45)`, an accidental bottle collision occurs [gap-fill: P(tip) = 0.25], incurring a 5.0-second time penalty.
R6. Win / Loss Resolution:
- The agent that successfully enters the bottle with the lowest `t_final` wins.
- If `t >= T_max` without success, recorded score is `DNF` (time = infinity).
## Edge cases
- Tie at the end condition: If two agents record identical completion times to within 0.1 s, a sudden-death 1v1 heat is executed. [gap-fill]
- A player with no legal move: Not applicable; posture adjustment vectors are always available.
- Repetition / cycles: Bounded by hard maximum time limit `T_max = 60.0` seconds.
- Simultaneous claims on the same resource or position: Not applicable; each agent interacts with an independent bottle.
- Player elimination mid-round; turn order repair: Agents who exceed `T_max` are marked as DNF and ranked by lowest distance between nail and bottle neck achieved.
- Resource exhaustion: Not applicable.
- Termination guarantee: Clock tick increments strictly until `t >= T_max` or entry success, guaranteeing provable termination.
## State representation
- Persistent state:
- `agent_scores`: Map `agent_id -> completion_time (float)`.
- Per-tick ephemeral state:
- `hip_position`: 3D vector `(x, y, z)`.
- `pendulum_state`: Angles `(theta_x, theta_y)` and angular velocities `(omega_x, omega_y)`.
- `nail_coordinates`: 3D vector `(x, y, z)`.
- `elapsed_time`: Float `t`.
- Observable information:
- Full observability: real-time position of nail and bottle aperture is fully observable.
## Action space
- `adjust_posture(delta_x: float, delta_y: float, squat_velocity: float)`:
- Preconditions: `t < T_max`, `z_hip > 0.30`.
- Parameters: `delta_x, delta_y in [-0.05, 0.05]` m, `squat_velocity in [0.0, 0.20]` m/s.
## Playability notes
- Single-player-vs-AI: Natural; player attempts to minimize completion time against AI benchmark agents.
- Group games (n>4): Easily scales as parallel independent simulations.
- Physical-skill games: Pendulum mechanics and fine motor squat damping are modeled directly with physical differential equations.
- What is lost: The humorous social spectacle of awkward squatting postures and crowd cheering.
## Implementation hints
Low complexity. A simple Euler integrator for a 2D damped pendulum combined with an aperture proximity check suffices. First milestone: Implement the 2D pendulum physics tick loop and verify that zero hip acceleration causes the nail to damp to rest directly below the hip.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Nail Dropping (Netherlands). (n.d.). Games of Countries. https://gamesofcountries.com/games/nl-netherlands/spijkerpoepen
@misc{gamesofcountries-nl-netherlands-spijkerpoepen,
title = {Nail Dropping (Netherlands)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/nl-netherlands/spijkerpoepen}
}