PedPurge
PedPurge is a Grand Theft Auto V mod that turns Los Santos into a full-scale purge scenario. Built for Script Hook V .NET, it creates a dynamic, hostile environment where NPCs attack the player and each other, supported by optimized spawning, configurable chaos, and an integrated menu system.
Features
-
Hostile NPCs Everywhere
NPCs aggressively target both the player and other peds, creating large-scale street conflicts. -
Smart Spawning System
Spawns occur outside the player’s camera view, with distance checks and street snapping. NPCs may appear in any direction — including behind you. -
Configurable Weapons
Each NPC receives one weapon from a customizable, realistic weapon pool. -
Chaotic Traffic (Optional)
Civilian drivers may flee vehicles or drive recklessly. This behavior is configurable via the.inifile. -
Customizable Atmosphere
Default purge settings use nighttime + smog, but all weather/time variables are adjustable. -
Purge Audio Cue (Optional)
Plays a user-defined audio track when the purge begins. -
Performance Optimizations
Batch processing, local-only AI updates, and distance-based despawns reduce lag compared to older versions. -
Interactive Menu (LemonUI)
- Start Purge
- Stop Purge
Installation
- Install Script Hook V .NET.
- Install LemonUI.
- Place
PedPurge.dllin yourGTAV/scriptsfolder. - Create the folder:
GTAV/scripts/PedPurge/audio. - (Optional) Place your purge audio file (e.g.
ThePurge.wav) into that folder.
Usage
Press F10 (default) to open the PedPurge menu.
- Start Purge — begins the chaos (hostile AI, traffic behavior, etc.).
- Stop Purge — restores normal world behavior.
Adjust settings by editing PedPurge.ini.
Configuration Options (PedPurge.ini)
| Option | Description |
|---|---|
| MenuKey | Change menu activation key |
| EnableAudio | Enable/disable purge audio |
| PurgeWeather | Set purge weather (e.g. Smog, Clear, Overcast) |
| PurgeHour | Time when purge starts (24-hour format) |
| MinPurgeWeaponAmmo / MaxPurgeWeaponAmmo | NPC weapon ammo range |
| EnableChaoticTraffic | Toggle chaotic driver behavior |
| DisableEmergencyServices | Prevent emergency services from spawning |
| AllowNPCsToLeaveVehicles | Allow AI to exit vehicles |
| ModPedThreshold | Maximum number of active purge NPCs |
| ModPedSpawnCount | Number of NPCs spawned per batch |
| SpawnIntervalSeconds | Delay between spawn waves |
| PedModels | List of ped models used by the mod |
Known Limitations
- NPC AI is subject to GTA V’s native behavior and may sometimes choose melee over firearms.
- NPCs in low-density areas may stay passive due to base-game spawn density rules.
Requirements
- Grand Theft Auto V
- Script Hook V .NET
- LemonUI
Grand Theft Auto V
Script Hook V .NET
LemonUI
"What an experience so much fun and chaos all in one, love it!"
