Skip to main content
Formal Specification

Picigin (Split Shallow-Water Palm Ball) — Formal Specification

Croatia · water · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: discretizedGap-fills: 2
# Picigin — AI-optimized specification ## General idea A synchronous 5-agent fully cooperative aerial volley simulation in a 2D/3D shallow-water basin. Agents positioned in a pentagonal formation pass a low-inertia stripped rubber ball using open-palm impulse strikes, aiming to maximize continuous airborne volley length while executing high-risk diving saves (*panade*). ## Formal model - **Abstraction taken:** 3D ballistic trajectory of the ball (x,y,z,vx,vy,vz) is integrated in real-time ticks (Δt=0.1 s). Water surface is z=0. 5 agents occupy vertices V0…V4 on a radius R=7.5 m circle with water drag slowing terrestrial sprint velocities. An agent executes open-palm strike impulses upon entering reach radius. - **Player/agent count:** 5 cooperative agents (A0,A1,…,A4: A0,A1 anchors; A2,A3,A4 runners). - **Turn model:** Synchronous real-time continuous physics ticks. ## Formal rules R1. Setup: - 5 agents initialized at pentagonal positions 𝐩k=(Rcos⁡(2πk5),Rsin⁡(2πk5),0). - Initial state: `rally_count = 0`, `total_score = 0.0`. - Ball launched from agent A0 with velocity (vx,vy,vz) toward A1. R2. Ball Physics (per tick Δt): - Position update: 𝐫(t+Δt)=𝐫(t)+𝐯(t)Δt. - Velocity update: 𝐯(t+Δt)=𝐯(t)+(𝐠−γ𝐯(t))Δt. R3. Agent Interception and Palm Strike: - When ball enters an agent's reachable sphere ‖𝐫ball−𝐩i‖≤Rreach (where Rreach=1.8 m during a dive): - Agent executes action `palm_strike(target_agent_id, strike_vector)`. - Contact check: Pcontact=f(speed,angle)≈0.92. - Upon contact: `rally_count += 1`. - Difficulty bonus awarded: Δscore=1.0+dive_distance(Ai)⋅2.0. R4. Water Contact and Turn Termination: - If zball≤0 before an agent makes contact: - `WATER DROP (PAD U MORE)`. - Sequence terminates; final sequence score logged. R5. Match Scoring and Termination: - [gap-fill] A match consists of M=5 full rally sequences. Total score is the cumulative sum of points across all 5 sequences. - [gap-fill] Maximum ticks per sequence Tseq=500 ticks (50 seconds). ## Edge cases - Tie at the end condition: Not applicable (fully cooperative score maximization). - A player with no legal move: Agents continuously adjust position and execute strike when in range. - Repetition / cycles: Bounded by air resistance, trajectory decay, and Tseq=500 tick timeout. - Simultaneous claims on the same resource or position: Proximity priority resolves contact to the single closest agent. - Player elimination mid-round; turn order repair: Not applicable; all 5 agents cooperate across the entire routine. - Resource exhaustion: Ball resets to starting agent at the beginning of each sequence. - Termination guarantee: Finite gravity and air drag ensure z≤0 in finite time unless continuous strikes succeed; hard cap Tseq guarantees finite runs. ## State representation - Persistent state: `match_total_score: float`, `sequence_index: int`, `max_rally_length: int`. - Ephemeral tick state: `ball_pos: tuple[float, float, float]`, `ball_vel: tuple[float, float, float]`, `agent_positions: list[tuple[float, float, float]]`, `current_rally: int`. - Observable information: Fully observable (all positions, velocities, and trajectory vectors are public). ## Action space - `move_agent(dx: float, dy: float)`: Water movement vector. - `dive_save(angle: float, extension: float)`: Acrobatic leaping dive. - `palm_strike(target_id: int, launch_velocity: tuple[float, float, float])`: Palm redirection strike. ## Playability notes - Single-player-vs-AI: Natural; human controls 1 runner agent executing diving saves while 4 AI agents maintain formation passing. - Group games (n>4): Natively designed for 5 cooperative agents. - Physical-skill games: Shallow water hydrodynamics and acrobatic timing modeled via parabolic ball integration and dive reach envelopes. - What is lost: Warm Adriatic sea spray, sandy friction beneath bare feet, joyful cheering on Bačvice beach. ## Implementation hints Standard 3D ballistic projectile integrator with 5 spatial agent controllers. First milestone: implement 2D circular passing loop with deterministic returns before adding 3D diving physics and water contact checks.

Download as JSON

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

Download JSON
Cite this page

Picigin (Split Shallow-Water Palm Ball) (Croatia). (n.d.). Games of Countries. https://gamesofcountries.com/games/hr-croatia/picigin

@misc{gamesofcountries-hr-croatia-picigin,
  title = {Picigin (Split Shallow-Water Palm Ball) (Croatia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/hr-croatia/picigin}
}