Merge pull request #2 from ednark/feature/vampire-survivor-movement

Feature/vampire survivor movement

Author: ednark

vampire-survivor/README.md

@@ -1,31 +1,56 @@
-# Vampire Survivor Style Game - Movement Demo
+# Vampire Survivor Style Game
 
-A web-based vampire survivor style game with thumb-based joystick movement mechanics.
+A web-based vampire survivor style game with thumb-based joystick movement mechanics, enemy AI, and auto-attacking weapons.
 
 ## Features
 
 ### ✅ Implemented
 - **Patterned Background**: Grid pattern with dots at intersections that scrolls as the player moves
 - **Player Character**: Red square with white border and shadow effect
 - **Virtual Joystick**: Touch-friendly joystick control in the bottom-left corner
-- **Movement Mechanics**: 
+- **Movement Mechanics**:
   - Smooth 360-degree movement
   - Keyboard support (WASD or Arrow keys)
   - Touch/mouse joystick support
   - Camera follows player
   - Normalized diagonal movement
+- **Enemy System**:
+  - Green enemy squares that spawn around the player
+  - AI that moves enemies towards the player
+  - Enemies are slightly slower than the player (150 vs 200 speed)
+  - Enemies have 3 health points
+  - Collision detection - enemies die when reaching the player
+  - Automatic spawning every 2 seconds
+  - Maximum of 50 enemies on screen
+  - Spawn distance of 400 pixels from player
+- **Weapon System**:
+  - Blue star weapon pickup spawns near player
+  - Collectible by walking over it
+  - Once collected, auto-fires small yellow star projectiles
+  - Fires every 0.5 seconds at the nearest enemy
+  - Projectiles deal 1 damage per hit
+  - Smart targeting system finds closest enemy
+  - Projectiles despawn after traveling 800 pixels
 - **Game Loop**: Proper delta-time based game loop for consistent movement
-- **Info Display**: Real-time position and velocity display
+- **Info Display**: Real-time position, velocity, enemy count, kill counter, and weapon status
 
 ## How to Play
 
-### Desktop
+### Controls
+**Desktop:**
 - Use **WASD** or **Arrow Keys** to move
 - Or click and drag the joystick in the bottom-left corner
 
-### Mobile/Touch Devices
+**Mobile/Touch Devices:**
 - Touch and drag the joystick in the bottom-left corner to move
 
+### Gameplay
+1. Move around to avoid the green enemies
+2. Collect the blue star weapon pickup
+3. Once collected, your character will automatically fire yellow star projectiles at the nearest enemy
+4. Survive as long as possible and rack up kills!
+5. Enemies have 3 health, so it takes 3 hits to kill them
+
 ## Running the Game
 
 Simply open [`index.html`](index.html:1) in a web browser. No build process or dependencies required!
@@ -51,36 +76,68 @@ You can also view this game via GitHub Pages or any static hosting service.
 - **Canvas-based rendering**: Uses HTML5 Canvas API for 2D graphics
 - **Delta-time game loop**: Ensures consistent movement across different frame rates
 - **Responsive design**: Adapts to any screen size
+- **Object-oriented enemies**: Enemy class with update and draw methods
 
 ### Controls Implementation
 - **Keyboard**: Event listeners for keydown/keyup
 - **Joystick**: Touch and mouse event handlers with visual feedback
 - **Input normalization**: Diagonal movement is normalized to prevent faster diagonal speed
 
+### Enemy AI
+- **Pathfinding**: Simple direct movement towards player position
+- **Speed balancing**: Enemies move at 75% of player speed (150 vs 200)
+- **Health system**: Enemies have 3 health points
+- **Collision detection**: Circle-based collision using center points
+- **Spawning**: Random angle around player at fixed distance
+- **Lifecycle**: Enemies removed on collision with player or when health reaches 0
+
+### Weapon System
+- **Pickup spawning**: Blue star spawns 200 pixels from player
+- **Collection**: Walk over the blue star to collect it
+- **Auto-targeting**: Automatically finds and targets nearest enemy
+- **Fire rate**: Shoots every 0.5 seconds
+- **Projectile speed**: 300 pixels per second
+- **Damage**: 1 damage per hit (3 hits to kill an enemy)
+- **Visual feedback**: Rotating star animations for both pickup and projectiles
+- **Smart cleanup**: Projectiles removed after hitting enemy or traveling too far
+
 ### Performance
 - Efficient rendering with requestAnimationFrame
 - Pattern background uses modulo math for infinite scrolling
 - Camera system keeps player centered on screen
+- Array cleanup for destroyed enemies
 
 ## Future Enhancements
 
 Potential additions for a full vampire survivor game:
-- Enemy spawning and AI
-- Weapon systems (auto-attacking)
-- Experience and leveling
-- Power-up selection
-- Health system
-- Wave-based progression
+- ✅ ~~Enemy spawning and AI~~ (Implemented!)
+- ✅ ~~Weapon systems (auto-attacking projectiles)~~ (Implemented!)
+- Multiple weapon types (area damage, piercing, etc.)
+- Weapon upgrades and evolution
+- Experience and leveling system
+- Power-up selection on level up
+- Player health system and damage from enemies
+- Wave-based progression with increasing difficulty
+- Different enemy types with varied behaviors
 - Sound effects and music
-- Particle effects
+- Particle effects for hits/deaths
 - Multiple character types
+- Boss enemies
+- Persistent upgrades
+- Score multipliers and combos
 
 ## Code Structure
 
-- **Game State**: Central game object managing player, camera, and input
-- **Rendering**: Separate functions for background and player rendering
+- **Game State**: Central game object managing player, enemies, weapons, projectiles, camera, and input
+- **WeaponPickup Class**: Blue star collectible with rotation animation
+- **Projectile Class**: Auto-targeting yellow star projectiles with collision detection
+- **Enemy Class**: Object-oriented enemy with health, AI, collision, and rendering
+- **Rendering**: Separate functions for background, pickups, enemies, projectiles, and player
 - **Input Handling**: Unified input system supporting both keyboard and joystick
 - **Update Loop**: Physics and game logic updates based on delta time
+- **Spawning System**: Timer-based enemy and weapon pickup spawning
+- **Targeting System**: Finds nearest enemy for auto-aim functionality
+- **Damage System**: Health-based enemy damage with kill tracking
 
 ## Browser Compatibility