# VehicleDespawner

A RagePluginHook plugin for GTA V that lets you despawn AI traffic vehicles that are disrupting a scene. The 3-second delay lets you look away before the vehicle disappears, preserving immersion.

## Features

- Aim (unarmed, no weapon equipped) + press B to mark a vehicle for despawn
- Vehicle and its occupants are deleted after a 3-second delay
- Custom crosshair reticle: red when targeting a vehicle, orange while despawn is pending, white with no target
- Model name label appears when targeting a vehicle
- Skips emergency vehicles (class 18) and the player's last vehicle
- 200m maximum range

## Configuration

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

[Keys]
DespawnKey=X

[Buttons]
DespawnButton=B

## Requirements

- Grand Theft Auto V
- RagePluginHook (RPH)

## Installation

1. Copy `VehicleDespawner.dll` and `VehicleDespawner.ini` into your GTA V `plugins` folder (e.g. `Grand Theft Auto V\plugins\`).
2. Launch GTA V through RagePluginHook.

## Usage

1. On foot, unequip your weapon (fists only).
2. Hold **LT** (controller) or **right-click** (mouse) to aim.
3. Point at a civilian vehicle and press **X** (keyboard) or **B** (controller) to mark it for despawn.
4. After 3 seconds, the vehicle and any occupants are removed.

## Author

Gamecock Tomahawk
