Yamayereza

**Yamayereza** is an immersive adventure quest game where players navigate through mystical landscapes, collect ancient relics, avoid dangerous monsters, and survive environmental hazards. The game features multiple difficulty levels, dynamic gameplay phases, and a rich scoring system.

### Key Features

- **Multi-Phase Gameplay**: Three distinct phases (Exploration, Monster Patrol, Hazard Activation)
- **Relic Collection System**: Collect different types of relics (Common, Rare, Epic, Legendary)
- **Dynamic Monster AI**: Monsters patrol and hunt the player
- **Environmental Hazards**: Various hazard types that activate over time
- **Power-Up System**: Strategic power-ups to aid survival
- **Combo System**: Chain relic collections for score multipliers
- **Leaderboard**: Track high scores and achievements
- **Tutorial System**: Learn the game mechanics
- **Settings**: Customizable audio, haptic feedback, and game preferences

## Architecture

### Core Components

- **GameModels.swift**: Comprehensive data models for game entities
- **GameViewController.swift**: Main game logic and UI management
- **HomeViewController.swift**: Main menu and navigation
- **SoundManager.swift**: Audio and haptic feedback management
- **Extensions.swift**: UI styling and animation extensions
- **GradientView.swift**: Custom animated gradient backgrounds

### Game Entities

#### Relics
- **Common** (Blue): 10 points base value
- **Rare** (Green): 25 points base value
- **Epic** (Purple): 50 points base value
- **Legendary** (Orange): 100 points base value

#### Monsters
- Patrol in defined radius around spawn point
- Variable aggression and speed levels
- Dynamic movement patterns

#### Hazards
- **Block**: Red barriers that block movement
- **Slow**: Yellow zones that reduce movement speed
- **Damage**: Orange zones that cause damage

#### Power-Ups
- **Monster Distract**: Move monsters away from player (3 uses, 15s cooldown)
- **Hazard Reset**: Deactivate all hazards (2 uses, 20s cooldown)
- **Quest Amp**: Double relic values (2 uses, 18s cooldown)

## Gameplay Mechanics

### Scoring System
- **Base Score**: Relic value × combo multiplier
- **Time Bonus**: 10 points per second remaining
- **Phase Bonus**: 100 points (Monster Patrol), 200 points (Hazard Activation)
- **Combo Multiplier**: 2x at 5+ consecutive collections

### Game Phases
1. **Exploration Phase**: Safe relic collection
2. **Monster Patrol Phase**: Monsters become active and hunt player
3. **Hazard Activation Phase**: Environmental hazards activate

### Win/Lose Conditions
- **Win**: Collect all relics before taking 6 hits
- **Lose**: Take 6 hits from monsters or hazards