Formal Specification
Taiwanese Iron Spike Ground Driving (Nail Stabbing Game) — Formal Specification
Taiwan · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Ting-ko-ki — AI-optimized specification
## General idea
A traditional children's target throwing and knockdown elimination game played with large iron nails or metal spikes (*Tìng-ko͘-ki* / *Pu̍t-teng-á*). Players hurl sharpened spikes downward into a soft dirt arena, attempting to achieve a firmly planted upright stick while targeting and striking opponent standing spikes to tilt, split, or knock them flat to capture them as trophies.
## Formal model
- **Abstraction taken:** Soil geotechnical moisture resistance, 3D metal spike penetration depth, and plastic impact dynamics are modeled as a 2D landing plane where each spike has an embedded location , penetration depth , and standing tilt angle . Throws specify target coordinates and downward impact force, resolving via Gaussian dispersion and rigid-body impact collision equations.
- **Player/agent count:** 2 to 6 players (default 2 or 4).
- **Turn model:** Sequential round-robin throwing turns with bonus throw rewards on successful knockdowns.
## Formal rules
R1. **Arena & Materials:**
- Circular arena of radius on damp earth.
- Each player controls 1 primary spike of length and mass .
- Spike state: `{status: [In-Hand, Standing, Knocked-Down, Captured], x, y, depth, tilt_angle}`.
R2. **Throwing Action:**
- The active player selects aim coordinates and throw force .
- [gap-fill] **Penetration & Landing Resolver:**
- Impact coordinate , where .
- Penetration depth .
- Resulting standing angle ().
- **Stick Condition:** If and , the spike is legally `Standing`.
- **Dead Nail (*Sí-teng*):** If or , the spike fails to stand and transitions to `Knocked-Down`.
R3. **Attack & Strike Mechanics:**
- If player throws aiming at player 's standing spike :
- Distance between impact point and : .
- Direct collision occurs if .
- Collision transfers horizontal kinetic impulse:
- If drops below or is dislodged from the soil, is `Knocked-Down` and captured by Player .
R4. **Bonus Throw & Turn Rotation:**
- Successfully knocking down an opponent spike awards bonus throw.
- A miss or dead nail immediately passes the turn clockwise.
R5. [gap-fill] **Elimination & Win Condition:**
- A player whose standing spike is captured or knocked down without remaining reserve spikes is eliminated.
- The last player possessing an active `Standing` spike wins the match.
R6. [gap-fill] **Stalemate Turn Limit:** If 20 consecutive throws occur without any spike knockdown or state change, victory is awarded to the player whose spike has the deepest ground penetration .
## Edge cases
- **Tie at the end condition:** Broken by ground penetration depth , followed by upright tilt angle (closest to ).
- **A player with no legal move:** Any player with a spike in hand has the legal throw action; eliminated players are skipped.
- **Repetition / cycles:** Inconclusive throwing is bounded by the 20-throw deadlock rule (R6).
- **Simultaneous claims on the same resource or position:** Throw landing on the exact coordinate of an opponent spike triggers immediate collision resolution.
- **Player elimination mid-round:** Eliminated players forfeit their turn slot; active turn rotates among surviving players.
- **Resource exhaustion:** Spikes are conserved; captured spikes transfer to the victor's tally.
- **Termination guarantee:** Guaranteed by finite nail inventory, irreversible knockdowns, and the 20-throw stalemate cap.
## State representation
- **Persistent state:**
- `players`: list of `{id, is_active, spikes_held, spikes_captured, dexterity}`.
- `spikes_on_field`: array of `{spike_id, owner_id, x, y, depth, tilt_angle, status}`.
- `active_player_idx`: integer.
- `stagnant_throws_counter`: integer in .
- **Per-throw ephemeral state:**
- `throw_vector`: `(aim_x, aim_y, force)`.
- **Observable information:** Fully observable 2D field layout, spike positions, tilt angles, and penetration depths.
## Action space
- `throw_spike(aim_x, aim_y, force)`:
- *Parameters:* .
## Playability notes
- **Single-player-vs-AI:** Highly playable; an AI agent optimizes target selection (choosing between safe open ground planting vs. high-risk direct strikes against shallow opponent spikes).
- **Group games (n>4):** Supports 2 to 6 players natively in circular field elimination.
- **Physical-skill games:** Downward wrist snap and soil penetration are formalized into force-depth equations and skill-based dispersion.
- **What is lost in the adaptation:** Tactile earth moisture on fingertips, metallic clang of striking iron nails, and muddy playground rivalries.
## Implementation hints
- Represent spikes as 2D discs with depth/tilt scalar properties.
- Collision detection is a simple 2D circle overlap test with threshold impulse logic.
- Suggested first milestone: Implement 2-player spike duel with plant/dead-nail evaluation and strike knockdown physics.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Taiwanese Iron Spike Ground Driving (Nail Stabbing Game) (Taiwan). (n.d.). Games of Countries. https://gamesofcountries.com/games/tw-taiwan/ting-ko-ki
@misc{gamesofcountries-tw-taiwan-ting-ko-ki,
title = {Taiwanese Iron Spike Ground Driving (Nail Stabbing Game) (Taiwan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/tw-taiwan/ting-ko-ki}
}