67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Development Commands
|
|
|
|
This is a client-side JavaScript application that runs directly in the browser:
|
|
|
|
- **Run the application**: Open `index.html` in a web browser
|
|
- **No build process**: The application uses vanilla JavaScript with no build tools
|
|
- **No package manager**: No npm/yarn dependencies, all code is self-contained
|
|
|
|
## Project Architecture
|
|
|
|
### Core Architecture Pattern
|
|
The project uses an **Entity-Component-System (ECS)** pattern with event-driven communication:
|
|
|
|
- **Entities**: `Player` and `Puck` classes represent game objects
|
|
- **Systems**: Modular systems handle specific concerns (rendering, physics, AI, rules)
|
|
- **Game Engine**: Central orchestrator that manages all systems and entities
|
|
- **Game State**: Centralized state management for scores, time, penalties, etc.
|
|
|
|
### System Dependencies
|
|
The application loads scripts in a specific order due to class dependencies:
|
|
|
|
1. **Utilities**: `vector.js`, `physics.js` (foundational math/physics)
|
|
2. **Entities**: `player.js`, `puck.js` (game objects)
|
|
3. **Systems**: `renderer.js`, `physics-system.js`, `ai-system.js`, `rules-system.js`
|
|
4. **Engine**: `game-state.js`, `game-engine.js`, `main.js` (orchestration)
|
|
|
|
### Key Classes and Responsibilities
|
|
|
|
- **HockeyManager** (`main.js`): Application lifecycle, canvas setup, global events
|
|
- **GameEngine** (`game-engine.js`): 60 FPS game loop, system coordination, player/puck management
|
|
- **GameState** (`game-state.js`): Score tracking, time management, penalty system
|
|
- **Player** (`player.js`): Hockey player with AI, physics, and role-based behavior
|
|
- **Puck** (`puck.js`): Physics-based puck with collision detection
|
|
- **Renderer** (`renderer.js`): 2D canvas rendering with camera system
|
|
- **AISystem** (`ai-system.js`): Team formations and strategic AI behaviors
|
|
- **RulesSystem** (`rules-system.js`): Hockey rule enforcement (offside, icing, penalties)
|
|
|
|
### Game Loop Architecture
|
|
The engine runs at 60 FPS using `requestAnimationFrame` with these phases:
|
|
1. Input processing
|
|
2. Physics simulation
|
|
3. AI decision making
|
|
4. Rules enforcement
|
|
5. Rendering
|
|
|
|
### Hockey-Specific Features
|
|
- **12 players** (6 per team) with distinct roles: Center (C), Left/Right Wing (LW/RW), Left/Right Defense (LD/RD), Goalie (G)
|
|
- **Formation system** with offensive/defensive positioning
|
|
- **Rule enforcement**: Offside detection, icing calls, penalty system
|
|
- **Realistic physics**: Collision detection, momentum conservation, board bouncing
|
|
|
|
## Controls Reference
|
|
- `SPACE` - Pause/Resume game
|
|
- `D` - Toggle debug information
|
|
- `R` - Reset game
|
|
- `F11` - Toggle fullscreen
|
|
- `Mouse Wheel` - Camera zoom
|
|
|
|
## File Structure Notes
|
|
- All code is vanilla JavaScript (ES6 classes)
|
|
- No modules or imports - everything is global
|
|
- Canvas-based 2D rendering
|
|
- Self-contained with no external dependencies |