CodeCraze Zombie Apocalypse

Welcome to the official documentation for **CodeCraze Zombie Apocalypse**. This resource transforms your FiveM server into a post-apocalyptic survival experience with advanced AI, immersive atmosphere

🧟 CodeCraze Zombie Apocalypse - Documentation

Welcome to the official documentation for CodeCraze Zombie Apocalypse. This resource transforms your FiveM server into a post-apocalyptic survival experience with advanced AI, immersive atmosphere, and high-performance systems.

---

🛠️ Table of Contents

1. Installation

2. Configuration

   • General Settings

   • Zombie AI & Behavior

   • Looting System

   • Mutant Nests

   • Atmosphere & Sound

   • Vehicle Mechanics

3. Framework Integration

4. Exports & Developer Info

5. Support

---

🚀 Installation

1. Download & Extract: Place the CodeCraze_Zombie_Apocalypse folder into your resources directory.

2. Server Configuration: Add the following to your server.cfg:

   ensure CodeCraze_Zombie_Apocalypse

3. Database (Optional): If you use a custom looting system that requires SQL, import the files from the sql/ directory. (Note: standard ESX/QBCore logic handles this via inventory).

4. Restart: Restart your server and you're ready to survive!

---

⚙️ Configuration

The script is highly customizable through the config/ directory. Each file manages a specific aspect of the apocalypse.

General Settings (config/general.lua)

• Config.Framework: Set to "esx", "qb", or "standalone".

• Config.Debug: Enable developer logs and blips for testing.

Zombie AI & Behavior (config/zombie.lua)

This is the heart of the conversion logic.

• Config.ZombieDetectionRange: Distance at which NPCs turn into zombies.

• Config.ZombieRunChance: Percentage chance (0-100) that a zombie will run instead of walk.

• Config.ZombieRunSpeed: Movement speed multiplier for running zombies.

• Config.SoundAttraction: Enable zombies being attracted to gunshots.

• Config.GunshotAttractionRange: How far zombies can "hear" shots.

Looting System (config/looting.lua)

Configure what players find when they scavenge fallen zombies.

• Config.LootEnabled: Toggle scavenging on/off.

• Config.LootItemList: Define items, their labels, and spawn probabilities.

• Config.LootAnimation: Choose the animation used during looting.

Mutant Nests (config/nests.lua)

Define "High-Risk" zones where special mutants spawn.

• Config.NestLocations: Add coordinates for hospitals, sewers, or military bases.

• Config.MutantHealth: Mutants can have significantly more HP than standard zombies.

• Config.NestEffects: Add fire or particle effects to mutants in these zones.

Atmosphere & Sound (config/atmosphere.lua & config/sounds.lua)

• Config.MuteCitySounds: Disables sirens, ambient traffic noise, and NPC chatter.

• Config.WeatherOverride: Force specific weather (e.g., FOGGY or OVERCAST).

• Config.TimeOverride: Lock the time of day for a persistent "nightmare" feel.

• Config.3DAudio: Manage distances and volume for the NUI-based groans and screams.

Vehicle Mechanics (config/vehicle.lua)

Zombies are a threat even if you're inside a car.

• Config.VehicleAttackRange: Distance at which zombies start swarming cars.

• Config.WindowSmashChance: Probability of a zombie breaking a window.

• Config.PlayerDragOut: Toggle whether zombies can pull players from seats.

---

🧩 Framework Integration

CodeCraze Zombie Apocalypse automatically detects your framework if configured correctly in config/general.lua.

• ESX: Uses ESX.ShowNotification and xPlayer.addInventoryItem for loot.

• QBCore: Uses QBCore.Functions.Notify and Player.Functions.AddItem.

• Standalone: Uses native notifications and does not attempt inventory modification (custom events can be added).

---

👨‍💻 Exports & Developer Info

You can interact with the zombie system using these client-side exports:

Check if a ped is a zombie

local isZombie = exports['CodeCraze_Zombie_Apocalypse']:IsZombie(pedId)

Get current active zombie count

local count = exports['CodeCraze_Zombie_Apocalypse']:GetZombieCount()

---

🆘 Support

If you encounter any issues or need custom modifications, feel free to reach out:

• Discord: Join our Community

• Tebex: Official Store

• Email: [e-mail]

---

Created with ❤️ by CodeCraze Development