Skip to main content
Formal Specification

Nail Beam / Hammerschlagen — Formal Specification

Germany · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Nagelbalken — AI-optimized specification ## General idea A turn-based precision striking game where N agents rotate turns around a shared wooden log, each attempting to drive their own 100 mm construction nail flush into the timber using single strikes of the hammer's narrow cross-peen (*Finne*). Each strike involves a trade-off between kinetic impact force and lateral aim precision; off-center strikes risk bending the nail shank, reducing penetration efficiency on subsequent turns. ## Formal model - **Abstraction taken:** The 3D hammer swing and anisotropic wood grain resistance are abstracted into a 2D impact plane. Each nail i is defined by remaining exposed height hi∈[0.0,100.0] mm and bend angle ϕi∈[−90∘,+90∘]. An agent submits swing force F and aim coordinate Δxaim, generating penetration depth Δh and angle update Δϕ via stochastic contact dynamics. - **Player/agent count:** 2 to N agents. - **Turn model:** Sequential round-robin rotation; each active agent takes exactly 1 strike per turn. ## Formal rules R1. **Setup:** Each registered agent i∈{1…N} starts with a nail standing at initial height hi(0)=90.0 mm (10 mm pre-set), bend angle ϕi(0)=0.0∘, strike counter Si=0, and status `Active`. Turn order is initialized as 1,2,…,N. R2. **Turn Structure:** On an agent's turn, if status is `Active`, the agent submits action `strike_nail(swing_force, aim_correction)`: - `swing_force` F∈[0.0,1.0]. - `aim_correction` δx∈[−5.0,5.0] mm. - Strike counter increments: Si←Si+1. R3. **Impact Kinematics:** - Impact offset from nail head center: ϵx∼𝒩(δx,σ2(F,Skilli)). - Finne blade contact width is Wblade=4.0 mm; nail head radius is Rhead=4.0 mm. - If |ϵx|>Rhead+Wblade/2, the strike is a complete miss (Δh=0). R4. **Penetration & Bending Resolution:** - If contact occurs on straight nail (ϕi≈0): - Penetration: Δh=max⁡(0,F⋅κwood⋅cos⁡(ϕi)⋅(1.0−|ϵx|/6.0)). - Bending induced: Δϕ=sign(ϵx)⋅(|ϵx|/4.0)⋅F⋅30.0∘. - If nail is bent (|ϕi|>15.0∘): - If agent aims counter to bend (sign(δx)=−sign(ϕi)), strike acts to straighten: |ϕi|←max⁡(0,|ϕi|−25.0∘⋅F). - Otherwise, direct downward penetration is penalized by efficiency factor cos2⁡(ϕi). R5. **State Update & Flush Check:** - New exposed height: hi←max⁡(0.0,hi−Δh). - Bend angle: ϕi←clamp(ϕi+Δϕ,−90∘,+90∘). - If hi=0.0 mm (flush with surface), agent transitions to status `Finished` and is removed from subsequent turn rotations. R6. [gap-fill] Max Strikes Stalemate Cap:** If any nail remains un-driven after Smax=30 strikes, the nail is considered stuck; the agent's status is forced to `Finished` with maximum penalty. R7. **Ranking & Loss Condition:** - Agents are ranked by the order they achieve `Finished` status (fewest total strikes Si). - The last remaining agent with an un-sunk nail loses the round. ## Edge cases - Tie at the end condition: If multiple agents finish on the same round with equal strikes, ties are broken by total strikes Si; if identical, joint ranking is awarded. - A player with no legal move: Not applicable; `strike_nail(F, \delta x)` is always available while status is `Active`. - Repetition / cycles: Bounded strictly by positive penetration Δh≥0 and the hard ceiling Smax=30 in R6. - Simultaneous claims on the same resource or position: Turns are strictly sequential; each agent interacts only with their designated nail. - Player elimination mid-round; turn order repair: When an agent finishes, the cyclic turn pointer skips their index, advancing directly to the next active agent. - Resource exhaustion (pieces, tokens, space, time): Nails are consumed (driven flush); each player has exactly 1 nail per round. - Termination guarantee: why the game provably ends: Guaranteed because each strike with non-zero force has positive expected depth decrement E[Δh]>0, backed by the hard cap Smax. ## State representation - **Persistent state:** Roster of agents, turn order list, active player count, finish order list. - **Per-player state:** Exposed height hi, bend angle ϕi, strike counter Si, status (`Active`, `Finished`). - **Per-turn ephemeral state:** Active agent index i, chosen force/aim parameters, sampled offset ϵx, penetration Δh. - **Observable information:** Perfect information; heights, bend angles, strike counts, and rankings of all nails on the block are globally visible. ## Action space - `strike_nail(swing_force, aim_correction)`: - `swing_force` F∈[0.0,1.0]: kinetic impulse of hammer swing. - `aim_correction` δx∈[−5.0,5.0] mm: intentional lateral targeting adjustment (used to center strike or straighten bent shank). Precondition: agent is active and holds current turn priority. ## Playability notes - Single-player-vs-AI: Engine-ready; 1 human user timing swing power and aim crosshairs against AI tavern patrons. - Group games (n>4): Round-robin rotation naturally generalizes to any N players without rule changes. - Physical-skill games: Muscular control with the hammer's narrow Finne edge is modeled via the bivariate variance function σ2(F,Skill). - What is lost in the adaptation: The ringing metallic ping of the hammer, flying steel sparks, and physical grip vibration. ## Implementation hints Discrete turn-based simulation with trivial computational requirements. Milestone 1: implement R3–R5 penetration and bending update equations, verify that full-power misses bend nails and realistic games resolve in 4 to 12 strikes per player.

Download as JSON

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

Download JSON
Cite this page

Nail Beam / Hammerschlagen (Germany). (n.d.). Games of Countries. https://gamesofcountries.com/games/de-germany/nagelbalken

@misc{gamesofcountries-de-germany-nagelbalken,
  title = {Nail Beam / Hammerschlagen (Germany)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/de-germany/nagelbalken}
}