Pelota
Docs
Pelota is a 3D tennis simulation built with Godot, focused on realistic ball physics, tactical AI, and clear gameplay systems. This documentation explains the high-level concepts and the math behind the game.

News
- — Hello
Features
Physics-Based Ball Model
Gravity, Magnus effect, drag, and bounce damping are simulated step-by-step for both runtime gameplay and trajectory prediction.
Real Tennis Match Flow
Points, games, sets, serves, faults, and rally states follow a clear state machine that mirrors real tennis structure.
3D Coordinate-Centered Design
All systems use explicit X/Y/Z court coordinates, from player movement and targeting to AI decision metrics and shot execution.
Adaptive AI Strategy
AI builds contextual shot decisions from ball trajectory, stamina, risk, and intent profiles such as neutral, attack, and defend.
Mathematical Documentation
LaTeX formulas explain velocity integration, drag, spin forces, and bounce decomposition in implementation-level detail.
Godot 4 Architecture
Scene-driven systems connect Ball, Player, Controller, and MatchManager components with reusable data contexts and signals.