Skip to main content
Formal Specification

Elderberry Water Spritzer / River Squirt Gun — Formal Specification

North Macedonia · water · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: discretizedGap-fills: 5
# Прсканка — AI-optimized specification ## General idea A real-time or tick-based 2D water-skirmish game played on a grid with a central water source. Agents maneuver, manage discrete water reservoir charges, and fire pressurized directional water jets at opponents while utilizing reloading safe zones to replenish ammo. ## Formal model - **Abstraction taken:** The continuous hydrodynamic water squirt is discretized into a directional line segment of range R=6 cells on a 20×20 grid. Water capacity is an integer volume V∈[0,3] shots. Water refills occur only when occupying designated water source cells. - **Player/agent count:** N agents (N∈[2,10]). - **Turn model:** Tick-based simultaneous movement, reloading, and firing. ## Formal rules R1. **Grid Setup:** Arena size 20×20. Water Source Zone W={(x,y)|x∈[9,11],y∈[9,11]}. R2. **Agent State:** Each agent i maintains: - Position (xi,yi)∈[0,19]2. - Water volume Vi∈[0,3] (initially 3). - `Immune` ∈{False,True}. - `HitsSuffered` ∈ℕ (initially 0). - `Active` ∈{False,True} (initially `True`). R3. **Action Space per Tick:** - `move(dx, dy)`: Δx,Δy∈{−1,0,1}, ‖Δ‖≤1. - `reload()`: Valid only if (xi,yi)∈W; sets Vi←3. - `fire_jet(direction)`: Direction ∈{N,NE,E,SE,S,SW,W,NW}; requires Vi≥1. R4. **Water Truce Immunity:** If (xi,yi)∈W, agent i has Immune=True. Immune agents cannot be hit by incoming water jets, but cannot execute `fire_jet`. R5. **Firing Resolution:** - Firing consumes Vi←Vi−1. - The water jet traces a ray of length up to 6 cells in the chosen direction. - The first non-immune agent j along the ray is struck: - Hit success probability: Phit=0.85−0.08⋅d(i,j). - If hit: j suffers HitsSufferedj←HitsSufferedj+1, and thrower i scores +1 point. - In elimination mode: if HitsSufferedj≥3, agent j is eliminated (Activej←False). R6. [gap-fill] Reload Duration:** Executing `reload()` requires remaining stationary in zone W for 1 full tick. R7. [gap-fill] Match Termination:** In point-scoring mode, the game ends after Tmax=100 ticks; the agent with the most hits scored wins. In elimination mode, the last active agent wins. R8. [gap-fill] Friendly Fire:** In team mode, water jets do not register hits against teammates. ## Edge cases - Tie at the end condition: In point mode, if tied at tick 100, the agent with fewer hits suffered wins [gap-fill]. - A player with no legal move: `move` and `wait` are always legal. - Repetition / cycles: Bounded by the 100-tick match duration. - Simultaneous claims on the same resource or position: Water zone cells W allow multiple occupants. If two agents fire at each other simultaneously on the same tick, both shots resolve independently before state update. - Player elimination mid-round; turn order repair: Eliminated agents are removed from the active set; remaining agents continue without disruption. - Resource exhaustion: Water is infinite at the central fountain cells W; barrel capacity is replenished by reloading. - Termination guarantee: [gap-fill] Hard 100-tick match cap guarantees termination. ## State representation - **Persistent state:** Number of agents N, match mode (points vs elimination), score array {Si}i=1N, tick counter t∈[1,100]. - **Per-tick ephemeral state:** Agent coordinates, water volumes {Vi}, immunity flags, projectile rays. - **Observable information:** Fully observable; all agent positions, water counts, and scores are public. ## Action space - `move(dx, dy)`: Δx,Δy∈{−1,0,1}. - `reload()`: Precondition: inside water zone W. - `fire_jet(dir)`: Direction enum. Precondition: Vi≥1 and not immune. ## Playability notes - Single-player-vs-AI: Highly engaging top-down arcade/tactical combat game with resource management. - Group games (n>4): Natively accommodates 2 to 10 players in team or free-for-all modes. - Physical-skill games: Rapid wooden piston thrusting and water trajectory aim are abstracted into ray casting and distance probabilities. - What is lost in the adaptation: The refreshing spray of cold river water on a hot summer afternoon and the satisfying mechanical squeak of greased wooden plungers. ## Implementation hints Medium complexity. Requires 2D ray-casting, zone-trigger state updates, and discrete ammo management. First milestone: implement R1–R5 for 2 agents in a simple grid loop with moving and firing.

Download as JSON

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

Download JSON
Cite this page

Elderberry Water Spritzer / River Squirt Gun (North Macedonia). (n.d.). Games of Countries. https://gamesofcountries.com/games/mk-north-macedonia/prskanka

@misc{gamesofcountries-mk-north-macedonia-prskanka,
  title = {Elderberry Water Spritzer / River Squirt Gun (North Macedonia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/mk-north-macedonia/prskanka}
}