# Legends of Coyote Gulch

A 2D action-adventure platformer game built with Phaser.js, featuring multiple dungeon levels and unique character abilities.

## Game Overview

"Legends of Coyote Gulch" is an exciting adventure game where players explore three distinct dungeon environments:
- **Coyote Gulch**: The starting area with basic terrain
- **NN Dungeon**: A challenging underground level
- **Pro Edge**: The final boss arena with complex mechanics

Players control a hero character who must navigate through these dungeons, defeat enemies, collect items, and progress toward the ultimate goal.

## Features

### Character System
- Hero character with movement controls (WASD or arrow keys)
- Health management system with hearts
- Inventory system for collecting items
- Score tracking and progression

### Enemy Types
#### 99Boy (NN Dungeon Enemies)
- Patrols horizontally within set boundaries  
- Follows player when in range
- Fires garbage projectiles at the player
- Takes damage from player attacks

#### ProEdge (Pro Edge Boss)
- Complex multi-phase combat system
- Patrols and follows the player with advanced movement patterns
- Casts various spells including:
  - Fireballs that can be reflected back to enemies  
  - Lightning floor effects that damage players
  - Sword slashes and scythe attacks
  - Star projectiles for ranged combat

### Game Mechanics
- Tile-based level design using Tiled Map Editor files (.tmx)
- Physics-based movement with arcade gravity settings (0,0)
- Health system with maximum hearts tracking
- Score progression through defeating enemies and completing areas
- Inventory management system for collecting items

### Dependencies

- **Phaser 3**: HTML5 game framework (v3.90.0 via CDN)
- **Tiled Map Editor**: Level design files (.tmx format)

## Controls

### Movement
- **WASD** or **Arrow Keys**: Move character left/right/up/down
- **Spacebar**: Jump (if implemented in current build)

### Combat  
- Mouse click: Attack/Use abilities
- Mouse movement: Aim projectiles 

## Level Design Files

The game uses Tiled Map Editor files for level design:
- `raw/gulch.tmx` - Coyote Gulch starting area
- `raw/NNDungeon.tmx` - NN Dungeon underground level  
- `raw/proedge.tmx` - Pro Edge boss arena

## Development Notes

### Global State Management
The game uses a centralized global state system (`GlobalState`) to manage:
- Player health (hearts)
- Score tracking
- Inventory items
- Starting positions for each dungeon area

### Character Behaviors
Both enemy types implement patrol and follow behaviors with configurable boundaries. The 99Boy focuses on ranged combat while ProEdge has a more complex spellcasting system.

### Scene Management  
The game supports multiple scenes:
1. **MenuScene**: Main menu interface
2. **Gulch**: Coyote Gulch level 
3. **NNDungeon**: NN Dungeon level
4. **ProEdge**: Boss arena

## Future Development Goals

- Implement full player character abilities and animations
- Add more enemy types with unique behaviors  
- Expand inventory system with item effects
- Create additional dungeon levels
- Implement sound effects and music (currently uses placeholder "99Dungeon Lyrics.txt")