===========================
Zombie Enhanced Edition
===========================

Mod Version: 1.3 Stable  
Developer: Divan Ezadin  
Release Date: May 31, 2025  
Platform: GTA 5 Enhanced Edition (PC)

Description:
------------
Zombie Enhanced Edition transforms Los Santos into a brutal, post-apocalyptic nightmare. Version 1.3 introduces stamina mechanics, a realistic vehicle fuel system, new spawn styles, animation-based looting, and expanded ammo drops—pushing immersion and survival depth further than ever.

Key Features:
-------------
- **Smarter Zombie AI**: Sprinting, evasive movement, and group behavior logic enhance challenge and realism.
- **Enhanced Sight & Hearing**: Toggle 50m zombie visual detection and 150m gunshot reaction. Suppressors truly matter.
- **Dynamic Fog System**: Toggle thick atmospheric fog for horror ambiance (menu: Foggy Weather).
- **Survival Mechanics**: 
  - **Hunger/Thirst System**: Gradual drain over time. Visible HUD bars. Health suffers when depleted.
  - **Stamina System (NEW)**: Sprinting drains stamina. Auto-recovers. Toggleable.
- **Loot System**: Press **E** near corpses (within 1.5m) to loot randomized food, drink, medical supplies, and (now) **ammo**.
- **Inventory System**: Press **I** to manage usable items in three tabs:
  - Food & Drink: Replenishes hunger/thirst  
  - Medical: Heals HP  
  - Ammo: New in 1.3 — adds rounds to your compatible weapons  
  Use items with **Numpad 5**, navigate with **Numpad 8/2**, switch tabs with **Numpad 4/6**.
- **Built-in Menu (F7)**: Toggle apocalypse mechanics:
  - Apocalypse Mode  
  - No Peds  
  - No Vehicles  
  - Some Vehicles Left  
  - Runners *(still in development)*  
  - Blackout  
  - Enhanced Sight  
  - Hearing (Gunshot Reaction)  
  - Hunger  
  - Thirst  
  - Smarter Zombies  
  - Foggy Weather  
  - **Walking Dead Spawn Style (NEW)**  
  - **Animation Loot Style** *(still in development)*  
  - **Car Fuel System (NEW)**  
  - **Stamina System (NEW)**

- **Realistic Fuel System** (NEW): Cars now consume fuel. When fuel depletes, cars stall.
- **Walking Dead Spawn Style** (NEW): Zombies now prioritize roads and intersections—TV-show-style atmosphere.
- **Animation Loot Style** *(still in development)*: Looting, eating, and drinking play immersive animations.
- **Custom Visuals**: Blackouts, fog, no ambient sounds (optional), high-blood textures.
- **Quick Activation**: Press **Z** at any time to toggle the zombie apocalypse.

Installation:
-------------
1. Install ScriptHookV and ASI Loader:  
   - ScriptHookV: http://www.dev-c.com/gtav/scripthookv/  
2. Copy `ZombieEnhancedEdition.asi` to your GTA V Enhanced Edition root directory.  
3. A `.ini` config will auto-generate on first run.  
4. Launch GTA V Enhanced Edition and enjoy.

Usage:
------
- **Z**: Toggle outbreak mode
- **F7**: Open mod menu  
  - Numpad 8/2: Move up/down  
  - Numpad 5: Select toggle  
  - Numpad 0: Close menu  
- **I**: Open inventory  
  - Numpad 4/6: Switch section  
  - Numpad 8/2: Navigate items  
  - Numpad 5: Use item  
  - Numpad 0: Close inventory  
- **E**: Loot nearby corpses (within 1.5m)

Requirements:
-------------
- GTA 5 Enhanced Edition (v1.0.812.8 or newer)  
- ScriptHookV  
- ASI Loader

Known Issues:
-------------
- Menu or inventory can briefly flicker HUD bars  
- Some zombies may stutter in tight spaces  
- Ultra-wide setups may overlap UI

Credits:
--------
- Developed by: Divan Ezadin  
- Alhamdulillah to Allah for the strength and inspiration.  
- Gratitude to the GTA V modding community.

Social Media & Usage:
---------------------
You’re free to record or stream this mod on any platform. Please give credit and link to the original source.

Support:
--------
- Donations appreciated: https://www.paypal.me/Dieheb
- Donations appreciated: https://ko-fi.com/divanezadin

License:
--------
Free for personal use only. No re-uploads, edits, or commercial use without permission.

Changelog:
----------
### Version 1.3 Stable
- Added **Stamina System**: drain/recharge logic with menu toggle  
- Added **Car Fuel System**: cars stall when empty; toggleable  
- Added **Ammo Looting**: zombies can now drop random ammo  
- New **Walking Dead Style Spawn System**: prefer roads/intersections  
- **Animation Loot Style** *(still in development)*  
- Expanded inventory with **Ammo** tab  
- Improved HUD logic and more stable key binding system  

### Version 1.2 Stable
- Foggy weather toggle (atmospheric immersion)  
- Smarter zombies overhaul: sprinting, climbing, pathfinding  
- Full loot + inventory system with healing, eating, and drinking logic  
- Improved visual HUD and stat bars  
- Configurable keybindings via `.ini` file  

### Version 1.1 Stable
- Enhanced sight and hearing options  
- Hunger/Thirst system with penalties  
- Looting system and inventory (basic)  
- Smarter zombies and improved AI  
- Menu options for all toggles  

### Version 1.0 Stable  
- Basic zombie spawner and attack logic  
- Apocalypse toggles and visual effects  
- Core AI (running, detection, blackout, no peds/vehicles)  

### Version 0.1 BETA  
- Initial test build: basic zombies, spawner, toggle key only  

Stay alive. Stay human. Survive the outbreak.
