Formal Specification
The Shoemaker — Formal Specification
Estonia · chase-tag · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: discretizedGap-fills: 8
# Kingsepp (The Shoemaker) — AI-optimized specification
## General idea
A dynamic spatial territory-swapping and deception game played across discrete home bases. A homeless seeker (the shoemaker) queries base occupants; players either misdirect the seeker to covertly swap bases behind their back or trigger a universal scramble where every occupant must abandon their base simultaneously, leaving the slowest agent without a home.
## Formal model
- **Abstraction taken:** The open yard with drawn circles is modeled as a 2D topological graph with discrete base nodes and connecting transit pathways. Sprinting and physical obstruction are modeled as simultaneous movement ticks with velocity parameters.
- **Player/agent count:** 1 Shoemaker agent () and Base Occupant agents (). Total agents ; total bases .
- **Turn model:** Hybrid: Turn-based conversational query phase followed by real-time tick-based simultaneous sprint scramble.
## Formal rules
R1. Setup:
- base nodes are distributed across the field at mutual distance .
- Each Occupant starts inside a unique base .
- The Shoemaker starts at center coordinates with status `HOMELESS`.
R2. Query Phase:
- approaches an occupant at base and submits `query_shoemaker(P_k)`.
- must immediately submit one of two responses:
1. `RESPOND_ABSENT(direction)` ("Ei ole kodus"): designates a directional vector .
2. `RESPOND_HOME()` ("On kodus!"): triggers an immediate universal scramble.
R3. Resolution of `RESPOND_ABSENT`:
- is forced to move along for ticks [gap-fill: parameterized as ticks].
- During , any pair of occupants may submit `swap_bases(B_i, B_j)` and sprint between bases.
- has a detection radius ; if a swap occurs within vision, can break walking lock and attempt to reach an empty base.
R4. Resolution of `RESPOND_HOME` (Universal Scramble):
- All occupants are immediately evicted from their current bases ().
- Rule of mandatory migration: An agent cannot re-occupy their immediately vacated base [gap-fill: cannot choose during a scramble unless no other base is reachable].
- All agents ( and all occupants) sprint simultaneously toward any vacant base at speed .
R5. Base Claiming Resolution:
- When an agent reaches a vacant base , they execute `claim_base(B_m)`.
- If two agents reach on the same tick, priority is resolved by distance traveled or lowest agent ID [gap-fill: tie resolved by lower ID].
- A claimed base is locked for the remainder of the scramble.
R6. Round End and Role Transition:
- The scramble phase ends when all bases are claimed ( agents safe).
- Exactly 1 agent remains stranded without a base; this agent becomes the Shoemaker for the subsequent round.
- [gap-fill: A session completes after rounds, scoring agents by fewest rounds spent as the Shoemaker].
## Edge cases
- Tie at the end condition: If two agents claim the final available base on the exact same tick, priority is broken by agent index per R5 [gap-fill: deterministic base conflict tiebreaker].
- A player with no legal move: Not applicable; agents always have valid target bases or movement coordinates.
- Repetition / cycles: Bounded by the finite round limit [gap-fill: round cap bounding].
- Simultaneous claims on the same resource or position: Handled via distance-to-base and agent ID priority in R5.
- Player elimination mid-round; turn order repair: If an agent disconnects, one base is removed from the environment, maintaining the strict invariant of [gap-fill: dynamic base removal].
- Resource exhaustion: Not applicable; bases are non-depleting spatial positions.
- Termination guarantee: Each scramble strictly terminates in at most ticks since agents compete for static targets; total game terminates at [gap-fill: termination guarantee via bounded scramble ticks and round cap].
## State representation
- Persistent state:
- `bases`: Array of coordinate positions and occupancy status (`VACANT` or Occupant ID).
- `shoemaker_id`: Agent ID currently in the Shoemaker role.
- `rounds_as_shoemaker`: Map of Agent ID Integer count.
- `current_round`: Integer .
- Per-tick ephemeral state:
- `agent_positions`: Map of Agent ID .
- `movement_locks`: Active walk/distraction timer on Shoemaker.
- `scramble_active`: Boolean flag indicating active universal sprint.
- Observable information: Positions of all bases and agents are public; occupant swap intentions are private until movement begins.
## Action space
- `query_shoemaker(target_id)`: (Shoemaker) Initiate dialogue with base occupant.
- `respond(type, direction)`: (Occupant) Return `RESPOND_ABSENT` or `RESPOND_HOME`.
- `initiate_swap(partner_id)`: (Occupant) Send swap proposal to peer.
- `sprint_to(target_base)`: (All agents) Move toward target base at maximum speed .
- `claim_base(base_id)`: (All agents) Lock occupancy of current base.
## Playability notes
- Single-player-vs-AI: Highly engaging. Single human occupant coordinating AI peer swaps and reading AI shoemaker positioning, or human shoemaker exploiting visual angles to steal bases.
- Group games (n>4): Reduces to 1 Shoemaker vs 2 Occupants (2 bases). A 1v1 reduction (1 base, 2 players) degenerates into a trivial two-player footrace; minimum viable player count is 3.
- Physical-skill games: Physical reaction speed and sprinting are modeled via velocity vectors and graph shortest paths.
- What is lost in the adaptation: Eye-contact micro-signaling between peers across the yard and the sudden physical collision chaos of a group scramble.
## Implementation hints
Model bases as nodes on a regular polygon (e.g. pentagon/hexagon) around a central origin. First milestone: Implement the universal scramble (R4-R6) with greedy pathfinding before implementing the distraction and bilateral swap logic (R3).
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
The Shoemaker (Estonia). (n.d.). Games of Countries. https://gamesofcountries.com/games/ee-estonia/kingsepp
@misc{gamesofcountries-ee-estonia-kingsepp,
title = {The Shoemaker (Estonia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ee-estonia/kingsepp}
}