Skip to main content
Formal Specification

Button Football (Gombfoci / Szektorlabda) — Formal Specification

Hungary · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Gombfoci — AI-optimized specification ## General idea A tabletop turn-based tactical dexterity simulation of association football where two agents command 11 disc-shaped pieces on a bounded 2D pitch. Agents apply directional velocity impulses to pieces to pass a micro-ball, establish geometric proximity dominance (the Sector mechanic), and execute aimed shots on goal against a responsive goalkeeper piece. ## Formal model - **Abstraction taken:** The continuous physics table (1.2m × 0.8m) is modeled as a 2D continuous coordinate plane with elastic boundary collisions and rigid disc dynamics. An agent's flick is modeled as an impulse vector `(magnitude, angle)` applied to a chosen button. - **Player/agent count:** 2 agents (Home `H`, Away `A`). Each agent controls 10 outfield buttons and 1 goalkeeper. - **Turn model:** Alternating turn model with multi-touch possession chains governed by the Sector condition. ## Formal rules R1. State Setup: Pitch dimensions `[-60..60] × [-40..40]`. Home Goal at `x = -60`, Away Goal at `x = +60`. Ball at `(0,0)`. Outfielders initialized in standard 4-3-3 or 4-4-2 formations. R2. Turn Structure: Active agent chooses button `i` and executes `flick(button_id, angle, force)`. R3. Physics & Collision Resolution: - Button `i` acquires initial velocity `V_0` and decelerates via friction coefficient `mu`. - Collisions between buttons, the ball, and boundary walls resolve via 2D rigid-body elastic impact formulas. R4. Possession / Sector Check: - After all bodies come to rest (`velocity < epsilon`): - Calculate distance from ball to nearest Home button `d_H` and nearest Away button `d_A`. - If active agent contacted ball AND `d_active < d_opponent` AND `d_active <= Sector_Radius` (10 cm), active agent retains possession (can execute another flick, up to max 12 consecutive touches). - Otherwise, turn passes to the defending agent. R5. Goal Attempt Declaration: - If active agent has valid Sector and ball is inside opponent half, agent may declare `call_shot(shooter_button_id)`. - Defending agent is granted an immediate response action: `reposition_goalkeeper(y_target)` along their goal line. - Active agent then executes the shooting flick. R6. Goal Condition: If ball center crosses `|x| > 60` between goalposts (`|y| <= 6`), 1 goal is scored; ball resets to `(0,0)` for kickoff. R7. Fouls: If a flicked button impacts an opponent button BEFORE making contact with the ball, a direct free flick is awarded to the opponent from the point of infraction. R8. [gap-fill] Time / Turn Limit: Match consists of exactly 60 turns per player (equivalent to 2 × 15-minute halves) or first to 3 goals. Highest score at match completion wins. ## Edge cases - Tie at the end condition: If match turns expire tied, resolve via a 5-round penalty shootout (isolated 1v1 striker vs. goalkeeper flicks from penalty spot). - A player with no legal move: Not applicable — an agent always has 11 selectable buttons on the board. - Repetition / cycles: Bounded by finite turn limit per half (R8). - Simultaneous claims on the same resource or position: Overlapping pieces are disallowed by physics collider resolution (pieces push apart elastically). - Player elimination mid-round: No player elimination; pieces remain on the pitch throughout the entire match. - Resource exhaustion (pieces, tokens, space, time): Single ball; boundary walls prevent pieces from exiting the playable field. - Termination guarantee: Enforced by the strictly decreasing turn counter (R8). ## State representation - Persistent state: `score_H`, `score_A`, `half (1 or 2)`, `turns_remaining`, `active_agent_id`, `possession_touch_count`. - Per-player state: 10 button coordinate pairs `(x, y)` + 1 goalkeeper coordinate `(x_g, y_g)`. - Per-turn ephemeral state: `ball_pos (x, y)`, `ball_vel (vx, vy)`, `is_shot_declared (bool)`. - Observable information: Full observability — complete state and coordinates known to both agents. ## Action space - `flick_button(button_id, angle_rad, impulse_force)`: Primary offensive/defensive play action. - `declare_shot(button_id)`: Initiates shooting sequence. - `set_goalkeeper_pos(y_coord)`: Defensive repositioning action before an opponent shot. ## Playability notes - Single-player-vs-AI: Ideal — easily integrated with 2D physics engines (e.g. Box2D, pymunk) with Minimax or Reinforcement Learning agents. - Group games (n>4): Not applicable (inherently 1v1 squad match). - Physical-skill games: Impulse vector accuracy can be configured as continuous agent output or perturbed by a Gaussian hand-tremor noise model. - What is lost: The physical tactile feedback of pressing against polished plastic button rims with custom acrylic striker wedges. ## Implementation hints Engine-ready for immediate 2D physics simulation. Use a standard physics engine step loop with high sub-stepping to prevent tunneling of the small ball. First milestone: implement a 2D tabletop arena with boundary bounce and button-ball collisions, then layer the Sector-possession logic and turn alternation.

Download as JSON

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

Download JSON
Cite this page

Button Football (Gombfoci / Szektorlabda) (Hungary). (n.d.). Games of Countries. https://gamesofcountries.com/games/hu-hungary/gombfoci

@misc{gamesofcountries-hu-hungary-gombfoci,
  title = {Button Football (Gombfoci / Szektorlabda) (Hungary)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/hu-hungary/gombfoci}
}