Formal Specification
The Whip / The Gift (Egyptian Drop-Handkerchief Chase) — Formal Specification
Egypt · singing-circle · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: discretizedGap-fills: 2
# El-Korbaaj / El-Hadiya — AI-optimized specification
## General idea
A stealth-dropping and circular pursuit game played on a discrete circular graph. A Runner agent traverses the ring to deposit a token behind a seated agent. The target agent attempts tactile detection to trigger a chase before the Runner completes the lap to claim the seat or administer a penalty tap.
## Formal model
- **Abstraction taken:** Seated circle is modeled as a discrete directed ring graph with vertices indexed . Traversal along the ring occurs at discrete velocity (nodes per tick).
- **Player/agent count:** 1 Runner vs. Seated agents (standard 2-agent formalization: 1 Runner vs 1 Target agent + automated decoys).
- **Turn model:** Synchronous discrete ticks (100ms per tick).
## Formal rules
R1. Ring Graph: nodes arranged in a circle. Seated agents occupy nodes . Token status is initially `HELD_BY_RUNNER`.
R2. Runner Movement: Runner starts at node 0 and moves clockwise at 1 node per tick.
R3. Drop Action: At any node , Runner may execute `DROP_TOKEN()`. Token is placed at node , `status = ON_GROUND`.
R4. Detection Dynamics (per tick after drop):
- Seated agent at node executes a blind tactile check each tick.
- Detection probability per tick: .
- If detected: Seated agent becomes `CHASER`, grabs token, and pursues Runner clockwise.
R5. Chase Resolution:
- Runner seeks to complete the lap and reach node (`VACANT_SEAT`).
- Chaser seeks to catch Runner (occupy same node) before Runner reaches node .
- If Runner reaches node safely: Runner becomes Seated; Chaser becomes the new Runner (+5 points to Runner).
- If Chaser tags Runner before node : Runner remains Runner for next round (+10 points to Chaser).
- Oblivious Case: If Runner completes the full loop back to node before detection occurs, Runner executes `TAP_SLEEPER()`: seated agent is penalized (-10 points) and becomes new Runner.
R6. [gap-fill] Turn Limit: Maximum 50 ticks per dropping round.
R7. [gap-fill] Match Termination: Game consists of 8 dropping rounds. Agent with highest score wins.
## Edge cases
- Tie at the end condition: If top scores are tied at round 8, an additional sudden-death sprint round is conducted.
- A player with no legal move: Directional movement around ring is always legal.
- Repetition / cycles: Bounded by the 50-tick hard limit per round (R6).
- Simultaneous claims on the same resource or position: Handled cleanly by node collision checks in R5.
- Player elimination mid-round; turn order repair: Role swaps occur cleanly at round boundaries without player elimination.
- Resource exhaustion (pieces, tokens, space, time): Exactly 1 token in play; 8 rounds fixed.
- Termination guarantee: Guaranteed by the finite 50-tick limit per round and 8-round match duration.
## State representation
- Persistent state:
- `agent_scores`: map of `agent_id` to integer.
- `runner_id`: agent identifier.
- `round_number`: integer in `1..8`.
- Per-round state:
- `runner_node`: integer in `0..N-1`.
- `token_node`: integer or None.
- `token_status`: `HELD | ON_GROUND | GRABBED`.
- `chaser_node`: integer or None.
- `target_detected`: boolean.
- `tick_counter`: integer in `0..50`.
- Observable information: Runner position is public; exact moment of token drop is hidden from seated agents until detected.
## Action space
- Runner: `move()`, `drop_token()`, `tap_sleeper()`.
- Seated Agent: `feel_behind()`, `grab_and_chase()`.
## Playability notes
- Single-player-vs-AI: Natural; human player acts as Runner planning drop stealth, or as Seated player testing peripheral reaction against AI.
- Group games (n>4): Standard configuration operates with seated players.
- Physical-skill games: Tactile touch and backward spatial sensation are formalized as stochastic detection hazard rates.
- What is lost in adaptation: The live vocal singing in the circle and physical tap on the shoulder.
## Implementation hints
Discrete circular array index arithmetic. Modular arithmetic `(pos + 1) % N` handles ring traversal. First milestone: implement token drop, detection hazard check, and pursuit loop logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
The Whip / The Gift (Egyptian Drop-Handkerchief Chase) (Egypt). (n.d.). Games of Countries. https://gamesofcountries.com/games/eg-egypt/el-korbaaj
@misc{gamesofcountries-eg-egypt-el-korbaaj,
title = {The Whip / The Gift (Egyptian Drop-Handkerchief Chase) (Egypt)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/eg-egypt/el-korbaaj}
}