PedPurge 3.0

(2 reviews)

PedPurge

PedPurge is a Grand Theft Auto V mod that transforms Los Santos into a full-scale purge event. Designed for Script Hook V .NET, it creates an unpredictable, high-intensity environment where NPCs turn hostile toward both the player and each other — with improved spawning logic, performance optimizations, and customizable chaos levels.

Features

Hostile NPCs Everywhere: AI-controlled peds actively attack the player and each other, creating large-scale street battles.
Smart Spawning System: NPCs are spawned dynamically outside the player’s camera view (no pop-ins) with distance and street snapping for realism. They can spawn in any direction, including behind the player.
Configurable Weapons: Each NPC is given a single weapon from a realistic pool with customizable ammo limits.
Chaotic Traffic (Optional): Civilian drivers may abandon vehicles or drive recklessly. Controlled via the .ini file.
Customizable Atmosphere: Default purge settings use nighttime with smog, but weather and time are fully configurable.
Purge Audio Cue (Optional): Plays a configurable audio track when the purge begins.
Optimized Performance: Batching, nearby-only processing, and distance-based despawns reduce lag compared to older versions.
Interactive Menu (LemonUI):
- Start Purge: Activates hostile AI and chaos systems.
- Stop Purge: Restores normal behavior and halts audio.

Installation

Install Script Hook V .NET.
Install LemonUI for menu support.
Place PedPurge.dll into your GTAV scripts folder.
Inside scripts, create PedPurge/audio.
(Optional) Place your purge audio file (ThePurge.wav) into GTAV/scripts/PedPurge/audio.

Usage

Press F10 (default) to open the PedPurge menu.
- Start Purge: Begins the event.
- Stop Purge: Ends the event.
Edit the .ini file to adjust behavior, weather, traffic chaos, NPC counts, weapons, and other options.

Configuration Options (`PedPurge.ini`)

MenuKey: Change menu activation key.
EnableAudio: Toggle purge audio.
PurgeWeather: Set purge weather (e.g., Smog, Clear, Overcast).
PurgeHour: Time of purge start (24-hour format).
MinPurgeWeaponAmmo / MaxPurgeWeaponAmmo: NPC weapon ammo range.
EnableChaoticTraffic: Toggle chaotic driver behavior.
DisableEmergencyServices: Block emergency response spawns.
AllowNPCsToLeaveVehicles: Allow AI to exit vehicles.
ModPedThreshold: Max NPCs active at once.
ModPedSpawnCount: NPCs spawned per batch.
SpawnIntervalSeconds: Delay between spawn waves.
PedModels: List of ped models to use.

Known Limitations

NPC AI behavior is subject to GTA V’s AI decision-making and may occasionally ignore their firearm in favor of melee.
NPCs in remote areas may not behave aggressively due to base game spawn density rules.

Requirements

Grand Theft Auto V
Script Hook V .NET
LemonUI

Edited March 23Mar 23 by SantosMods.dev
New Image, 3.0 Desc Fix

What's New in Version 3.0

Released August 15, 2025Aug 15

Changelog – Version 3.0

Improved spawn system to prevent NPCs from appearing within the player’s camera view, ensuring more immersive encounters.
Optimized performance by reducing unnecessary processing, adding distance-based despawns, and batching updates for smoother gameplay.
Refined chaotic traffic and NPC combat behavior for more natural and varied interactions during the purge event.

Short Description

PedPurge is a GTA V mod that unleashes a chaotic, purge-like event, where NPCs turn hostile, wreaking havoc across SA!

AI disclosure

The author has disclosed that AI tools were used in creating the following aspects of this file:

Description
Mod and Mod Content (Moderate)

AI assisted in obfuscation and script creation.

NUV3X, itsjzee85, JM Modifications and 4 others
6
1

Download this file

File Information

Views 23,440
Downloads 1,926
Submitted November 9, 20241 yr
Published August 15, 2025Aug 15
Updated August 15, 2025Aug 15
File Size 56.9 MB
Compatibility All Versions
Special Features Aggressive NPC behavior, chaotic traffic with reckless driving and vehicle abandonment, dark purge-like atmosphere with smoggy weather, immersive audio on purge start, interactive F10 menu for starting and stopping the purge
Requires Script Hook V (Alexander Blade)
Minimum LSPDFR Version N/A
Script/Plugin Type Standalone plugin
Maximum LSPDFR Version
Hide AV false +ive [Staff] No

Inside the File

Loading, please wait...

Followers

Previous File Lidar Gun

Next File Prowler Radar

User Feedback

19 Comments 2 Reviews

DarKKlusteR

Members

November 9, 20241 yr

Welp glory to our new founding fathers and let the purge begin at the siren!

SantosMods.dev

Members Author

November 9, 20241 yr

1 minute ago, DarKKlusteR said:

Welp glory to our new founding fathers and let the purge begin at the siren!

You were the inspiration 🤣

SleepyKevin

Members

November 9, 20241 yr

this is really cool looking going to try it out later this week

BlueLine Vibes

Members

November 10, 20241 yr

Interesting script - no way to change the keybind as it conflicts with other keys?

Commissioner Canon

Members

November 10, 20241 yr

Certainly a great idea, and all the features are brilliant, but it does give a massive frame drop upon activating it, which is somewhat to be expected, but I got a frame drop from 40-50fps to about 5. If the script can be optimised a bit better, it'd be a perfect purge/riot mod!

SantosMods.dev

Members Author

November 11, 20241 yr

On 11/9/2024 at 9:55 PM, BlueLine Vibes said:

Interesting script - no way to change the keybind as it conflicts with other keys?

I am working on a INI.

10 hours ago, Commissioner Canon said:

Certainly a great idea, and all the features are brilliant, but it does give a massive frame drop upon activating it, which is somewhat to be expected, but I got a frame drop from 40-50fps to about 5. If the script can be optimised a bit better, it'd be a perfect purge/riot mod!

I never had FPS issues during testing. Neither did my testers 🤔, I will look into it!

Commissioner Canon and BlueLine Vibes
2

HKGaming

Members

November 11, 20241 yr

Can this be triggered randomly and automatically? Can we program it to trigger at a specific time of day? Or do we have to always trigger it manually?

SantosMods.dev

Members Author

November 11, 20241 yr

5 hours ago, HKGaming said:

Can this be triggered randomly and automatically? Can we program it to trigger at a specific time of day? Or do we have to always trigger it manually?

Its all manual.

HKGaming

Members

November 15, 20241 yr

On 11/11/2024 at 6:07 PM, DeputyRyan32 said:

Its all manual.

Oh ok! This would be cool though, hopefully in another update?!

SantosMods.dev

Members Author

November 16, 20241 yr

1 hour ago, HKGaming said:

Oh ok! This would be cool though, hopefully in another update?!

I am looking into it!

HKGaming
1

HKGaming

Members

November 18, 20241 yr

On 11/11/2024 at 5:00 AM, DeputyRyan32 said:

I am working on a INI.

I never had FPS issues during testing. Neither did my testers 🤔, I will look into it!

Just to weigh in for the FPS drop, I also have this issue once it's activated, but I also have a lot of mods in my game so this might be a reason ?!

SantosMods.dev

Members Author

December 1, 20241 yr

On 11/9/2024 at 6:33 PM, SleepyKevin said:

this is really cool looking going to try it out later this week

Sorry about the late response but thanks!

HKGaming

Members

December 3, 20241 yr

still got some heavy fps drop once activated + I tried to set the time and changed the weather in the ini file, but nothing happens...

terrifier

Members

January 7, 20251 yr

Hello DeputyRyan, please fix your spawning system- its highly broken. The peds kill each other way too quickly at the start of the purge which leaves the map nearly empty for combat. Way too boring to be on foot, and am forced to get into vehicles to drive distances just to find one single survived ped to kill. Your re-spawn system needs to be overhauled, I can walk around for 3-5 minutes at a time in some instances before engaging with one single ped combatant. This is the annual Purge man, not a sole serial killer hunting at night while folks sleep. I don't think I've even ran into two peds shooting eachother once in the game. And I've tried it over and over again. Its always one on one against me, rinse repeat. Get in car, drive, get shot at, u-turn the vehicle, get out, kill ped, collect his weapon, get back into car - rinse repeat. Also your animation of peds getting into and out of cars down the roads at a distance needs to be fixed. Rarely are the peds not despawned (completely disappear from screen) by the time I approach those vehicles to engage them. I can take aim, drive towards these peds clearly getting into cars, watching them the whole time and then the peds disappear leaving the vehicles they just got into completely empty. I haaaaaaaaaaaaaaaaaaaaate that. This effect of peds getting into and out of cars down the roads is coooooooool, and immersive, but should not just be for ambient screen effect, but for real combat. We are hunting them!!! Also the spawn system is very bad with screen retainment, meaning, I can look down the road at a vehicle with a ped near it, then look 180 degrees the other way - then look back at where the car and ped were, and its disappeared. Something you are doing in the coding is not retaining spawned targets (there is no persistent target mapping). Your maps ped population are SO empty that hunting is the core component of your mod. I can't hunt if everything disappears upon arrival. Also, your script and whatever it entails is HIGHLY unoptimized for good system stability. I have a maxed out I9/4090 with waaaaaay too much ram and can run clean Simple Zombies and PedRiots at the exact same time with hundreds of AI/NPC's on screen attacking, explosions, pure total chaos, vehicles in motion, characters combating, gunfire, zero fps loss all with roaming herds of zombies simultaneously in view with not one single crash or freeze. Your Mod, freezes at some time almost every session with maybe 1 combatant on the screen at most, and ABSOLUTELY NOTHING else going on. That says a lot. I do hope you actually continue to finalize a usable version for public use as this one is NOT it. I think you have a different flavor in the gameplay (HUNTING vs Chaos) and should continue to work on this, but fix the giant glaring issues. I will be on standby. For now 2 star for effort, as I can't recommend this in its current state.

SantosMods.dev

Members Author

February 28, 20251 yr

On 1/6/2025 at 7:53 PM, terrifier said:

Hello DeputyRyan, please fix your spawning system- its highly broken. The peds kill each other way too quickly at the start of the purge which leaves the map nearly empty for combat. Way too boring to be on foot, and am forced to get into vehicles to drive distances just to find one single survived ped to kill. Your re-spawn system needs to be overhauled, I can walk around for 3-5 minutes at a time in some instances before engaging with one single ped combatant. This is the annual Purge man, not a sole serial killer hunting at night while folks sleep. I don't think I've even ran into two peds shooting eachother once in the game. And I've tried it over and over again. Its always one on one against me, rinse repeat. Get in car, drive, get shot at, u-turn the vehicle, get out, kill ped, collect his weapon, get back into car - rinse repeat. Also your animation of peds getting into and out of cars down the roads at a distance needs to be fixed. Rarely are the peds not despawned (completely disappear from screen) by the time I approach those vehicles to engage them. I can take aim, drive towards these peds clearly getting into cars, watching them the whole time and then the peds disappear leaving the vehicles they just got into completely empty. I haaaaaaaaaaaaaaaaaaaaate that. This effect of peds getting into and out of cars down the roads is coooooooool, and immersive, but should not just be for ambient screen effect, but for real combat. We are hunting them!!! Also the spawn system is very bad with screen retainment, meaning, I can look down the road at a vehicle with a ped near it, then look 180 degrees the other way - then look back at where the car and ped were, and its disappeared. Something you are doing in the coding is not retaining spawned targets (there is no persistent target mapping). Your maps ped population are SO empty that hunting is the core component of your mod. I can't hunt if everything disappears upon arrival. Also, your script and whatever it entails is HIGHLY unoptimized for good system stability. I have a maxed out I9/4090 with waaaaaay too much ram and can run clean Simple Zombies and PedRiots at the exact same time with hundreds of AI/NPC's on screen attacking, explosions, pure total chaos, vehicles in motion, characters combating, gunfire, zero fps loss all with roaming herds of zombies simultaneously in view with not one single crash or freeze. Your Mod, freezes at some time almost every session with maybe 1 combatant on the screen at most, and ABSOLUTELY NOTHING else going on. That says a lot. I do hope you actually continue to finalize a usable version for public use as this one is NOT it. I think you have a different flavor in the gameplay (HUNTING vs Chaos) and should continue to work on this, but fix the giant glaring issues. I will be on standby. For now 2 star for effort, as I can't recommend this in its current state.

Please join our Discord for assistance https://discord.gg/prjqRvq9

On 12/2/2024 at 7:08 PM, HKGaming said:

still got some heavy fps drop once activated + I tried to set the time and changed the weather in the ini file, but nothing happens...

Please join our Discord for assistance https://discord.gg/prjqRvq9

itsjzee85

Members

April 20, 2025Apr 20

Can't seem to get this one working. I've made sure it's installed correctly and nothing. Love the fire and explosion effects plugins!

SantosMods.dev

Members Author

April 20, 2025Apr 20

4 hours ago, itsjzee85 said:

Can't seem to get this one working. I've made sure it's installed correctly and nothing. Love the fire and explosion effects plugins!

Make sure you have GTAV Legacy and SHVDN Nightly.

Thanks!

itsjzee85

Members

April 21, 2025Apr 21

11 hours ago, DeputyMods said:

Make sure you have GTAV Legacy and SHVDN Nightly.

Thanks!

You called it. I had it but it was was outdated. Works awesome! Tring not to get shot is so hard! Nice side game to play.

SantosMods.dev

Members Author

April 21, 2025Apr 21

1 hour ago, itsjzee85 said:

You called it. I had it but it was was outdated. Works awesome! Tring not to get shot is so hard! Nice side game to play.

Thanks!
Should join our WIP Discord. Check DMs.