Formal Specification
Button Football (Gombfoci / Szektorlabda) — Formal Specification
Hungary · dexterity-small · Confidence: low
← Back to game pageImplementation 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 JSONCite 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}
}