Skip to main content
Formal Specification

Taiwanese Marbles (Pinball & Ground Marbles) — Formal Specification

Taiwan · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Da Danzhu — AI-optimized specification ## General idea A traditional children's marble dexterity and territory game played with glass marbles (*tān-chu*). In the formal *Five-Hole Course* and *Circle Ring* disciplines, players flick a striker marble using thumb-knuckle propulsion to navigate a sequential course of ground depressions or strike opponent marbles out of target rings, gaining bonus turns and achieving "Tiger" status to eliminate rivals. ## Formal model - **Abstraction taken:** Physical thumb flick force, ground friction, and 2D elastic sphere collisions are abstracted into a vector shot action (v0,θ) with Gaussian trajectory dispersion and point-to-point collision physics. - **Player/agent count:** 2 to 6 players (standard 2 to 4). - **Turn model:** Sequential round-robin with turn-continuation rewards upon successful hole entry or target marble strikes. ## Formal rules R1. **Playing Area & Setup:** - **Five-Hole Mode:** A linear track of length L=5.0 m containing 5 sequential circular holes H1,H2,H3,H4,H5 (radius rh=4 cm) spaced at 1.0 m intervals. - Each player controls 1 striker marble Mi (radius rm=0.8 cm) starting from the baseline Y=0. R2. **Course Progression (Five-Hole Sequence):** - To complete the course, a player's marble must enter the holes in exact sequence: Path=[H1→H2→H3→H4→H5→H4→H3→H2→H1] - Current stage of player i is tracked by `hole_progress` ∈[0..9]. R3. **Shooting Action:** - The active player chooses aim angle θ∈[−π,π] and impulse magnitude I∈[0.1,5.0] N⋅s. - [gap-fill] **Dispersed Impact Vector:** Actual shot trajectory undergoes small Gaussian noise Δθ∼𝒩(0,σθ2) and ΔI∼𝒩(0,σI2) inversely proportional to player skill. R4. **Hole Entry Mechanics:** - A marble entering within the radius rh of its current target hole at low velocity (v<vcapture) comes to rest at the hole center and advances `hole_progress` by +1. - Sinking the correct sequential hole immediately awards +1 bonus shot. R5. **Achieving "Tiger" Status (*Ló-hó͘*):** - Upon completing the entire 9-step progression back to H1, the player's marble attains the `Tiger` state. - A `Tiger` marble gains the ability to permanently eliminate any non-Tiger or rival Tiger marble by shooting and striking it directly. R6. **Collision & Elimination:** - If player A (as a `Tiger`) shoots and collides with opponent marble B: - Opponent B is eliminated from the game. - Player A collects B's marble stake and is awarded +1 bonus shot. - If a non-Tiger collides with another marble, normal 2D elastic collision occurs without elimination. R7. [gap-fill] **Win Condition:** The game ends when only one player (or team) remains uneliminated, or when a player captures all opponent stakes. R8. [gap-fill] **Turn Limit & Deadlock Resolution:** If 100 rounds elapse without a completed hole progress or elimination, victory is awarded to the player with the highest `hole_progress`, breaking ties by Euclidean proximity to the next target hole. ## Edge cases - **Tie at the end condition:** Broken by sequential hole checkpoint progress, then by distance to the active target hole. - **A player with no legal move:** All active players on their turn have the unconstrained shooting action `shoot_marble(angle, impulse)`. - **Repetition / cycles:** Wandering without hitting holes is capped by the 100-round deadlock rule (R8). - **Simultaneous claims on the same resource or position:** Two marbles resting in the same hole are displaced by minimal legal contact offset (2rm) along the collision normal. - **Player elimination mid-round:** Eliminated players immediately forfeit their turn slot; turn order continues sequentially among surviving players. - **Resource exhaustion:** Strikers remain on board until eliminated; holes are static features that cannot be depleted. - **Termination guarantee:** Guaranteed by monotonic hole progression toward Tiger status, irreversible player eliminations, and the R8 turn limit. ## State representation - **Persistent state:** - `players`: list of `{id, is_active, hole_progress, is_tiger, marbles_won}`. - `marble_positions`: array of 2D coordinates (xi,yi) for all active marbles. - `active_player_index`: integer in [0..N−1]. - `stagnant_turns_count`: integer. - **Per-turn state:** - `bonus_shots_remaining`: integer ≥0. - `shot_aim_vector`: (θ,I). - **Observable information:** Fully observable 2D board plane with exact piece coordinates. ## Action space - `shoot_marble(aim_angle, impulse)`: - *Preconditions:* Active player's turn, `is_active == True`, I∈[0.1,5.0]. ## Playability notes - **Single-player-vs-AI:** Highly engine-ready; AI calculates geometric trajectory vectors to hole centers or opponent targets using physics simulations and heuristic value functions. - **Group games (n>4):** Supports 2 to 6 players naturally in free-for-all or 2-team tag setups. - **Physical-skill games:** Physical finger flicking is abstracted into numerical angle/impulse selection combined with skill-conditioned Gaussian error. - **What is lost in the adaptation:** Tactile finger-friction against soil, micro-texture irregularities of dirt ruts, and visual swirl aesthetics of handmade glass cat's-eyes. ## Implementation hints - Simple 2D physics model: linear deceleration a=−μg and 2-body elastic circle collisions. - Low state footprint; ideal for fast MCTS or positional minimax evaluations. - Suggested first milestone: Implement the 5-hole course progression with boundary clipping and bonus turn chaining.

Download as JSON

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

Download JSON
Cite this page

Taiwanese Marbles (Pinball & Ground Marbles) (Taiwan). (n.d.). Games of Countries. https://gamesofcountries.com/games/tw-taiwan/da-danzhu

@misc{gamesofcountries-tw-taiwan-da-danzhu,
  title = {Taiwanese Marbles (Pinball & Ground Marbles) (Taiwan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/tw-taiwan/da-danzhu}
}