# RandomSceneSpawner

A RagePluginHook plugin for GTA V that spawns customizable scenes with peds, vehicles, and emergency services via an in-game menu.

## Features

- Build a spawn list of up to 10 peds and vehicles
- Customize each ped with an action, weapon, faction, and model
- 25+ ped actions: flee, fight, patrol, surrender, follow, aim, shoot, wander, use phone, seek cover, and more
- Assign factions (Friendly/Enemy) so same-faction peds don't fight each other
- Choose specific ped and vehicle models or randomize
- Toggle emergency services on scene: firetruck, ambulance, police unit, security guard
- Officer vehicles and ped models are jurisdiction-aware (Metro, County, Highway)
- Vehicle in Transit mode: spawn vehicles driving past in various styles (Normal, Reckless, Impaired, Accident, Pursuit, Meetup)
- Random Fill button to quickly populate a random roster
- Ambient scene spawner: auto-generates scenes every 15 minutes nearby
- Ambient vehicle spawner: adds traffic diversity every minute
- Armed peds may turn hostile when you aim at them
- Entity blip toggle to track all spawned entities on the map, or toggle off for higher difficulty or if you don't like location spoilers
- Set GPS waypoint to scene location, or spawn scenes exactly at your waypoint when one is active on the map
- Clean shutdown: entities fade out naturally when plugin unloads

## Requirements

- Grand Theft Auto V
- RagePluginHook (RPH)
- RAGENativeUI

## Installation

1. Copy `RandomSceneSpawner.dll` and `RandomSceneSpawner.ini` into your GTA V `plugins` folder (e.g. `Grand Theft Auto V\plugins\`).
2. Ensure `RAGENativeUI.dll` is in your GTA V root folder.
3. Launch GTA V through RagePluginHook.

## Configuration

Edit `RandomSceneSpawner.ini` in your `plugins` folder:

[Keybindings]
ToggleMenuKey=NumPad0
ToggleMenuModifierKey=None
ToggleBlipsKey=NumPad2
ToggleMenuButton=DPadLeft
ToggleMenuModifier=LeftShoulder
ToggleBlipsButton=None
ToggleBlipsModifier=None

[AmbientScenes]
Enabled=True
ShowBlips=False

[AmbientVehicles]
Enabled=True

[OfficerOnScene]
Metro=POLICE,POLICE2,POLICE3
County=SHERIFF,SHERIFF2,POLICET
Highway=POLICEB,PRANGER,CRUSADER

Customize the officer vehicle model pools per jurisdiction with comma-separated GTA V spawn names.

## Usage

- **NumPad 0** — Open/close the scene spawner menu
- **NumPad 2** — Toggle entity blips on the map
- **Controller: Hold A+B for 1 second** — Open/close the menu

Use the menu to add peds and vehicles to your spawn list, set actions and weapons, toggle emergency services, then press SPAWN SCENE to place everything at the waypoint or a random nearby location. Spawning again while a scene is active will despawn the current scene and create a new one. Delete & Reset releases all entities naturally without despawning them — they stay in the world and fade out on their own.

## Recommended Companion Mod

**LiveScanner** — pairs nicely with RandomSceneSpawner by adding a live police scanner radio that plays real-time dispatch audio. Check it out on the same mod page.

## Author

Gamecock Tomahawk
