How dzuy/picklerpg works
Pickle RPG is a strategy-focused pickleball game with procedural 3D presentation, a shared rally/match model, player and court customization, and substantial multiplayer, analytics, and premium-access code. The principal play loop is to enter through the game UI, choose a shot at a decision point, advance the rally, and view the resulting play. The README describes some capabilities as future or deliberately limited; the tree and sampled server code also contain multiplayer implementation. Links between unsampled client modules are omitted where their callers are not evidenced.
Main entry points: service.ts Match service · rally-engine.ts Rally lifecycle · main.ts Game UI · match.ts Match state
Components 21
Gameplay
- Game UI
src/main.ts - Match state
src/match.ts - 3D scene
src/scene.ts
Rally engine
- Rally lifecycle
src/engine/rally-engine.ts - Shot intent
src/engine/shot-intent.ts - Game model
src/engine/model.ts - Scoring rules
src/engine/scoring.ts - Match checkpoints
src/engine/checkpoint.ts
Players and courts
- Player design
src/player-design.ts - Court locations
src/locations.ts - Content packs
src/pack-catalog.ts
Multiplayer
- Remote match UI
src/multiplayer/remote-main.ts - Multiplayer API
src/multiplayer/api.ts - API routes
server/multiplayer/routes.ts - Match service
server/multiplayer/service.ts - Match repository
server/multiplayer/repository.ts
Platform services
- Analytics
src/analytics/index.ts - Browser storage
src/browser-storage.ts - Premium access
server/multiplayer/premium.ts
Other components
- Player
- Supabase
Connections 10
- Player → Game UI: uses
- Game UI → Match state: plays through
- Rally lifecycle → Shot intent: parses
src/engine/rally-engine.ts - Rally lifecycle → Game model: uses contracts
src/engine/rally-engine.ts - Match service → Match state: creates and resolves
server/multiplayer/service.ts - Match service → Match checkpoints: validates checkpoint
server/multiplayer/service.ts - API routes → Match service: dispatches
server/multiplayer/routes.ts - Match repository → Supabase: calls RPCs
server/multiplayer/repository.ts - Analytics → Browser storage: uses
src/analytics/index.ts - Premium access → Content packs: checks packs
server/multiplayer/premium.ts