# ClearVehicles

A RagePluginHook plugin for GTA V that clears ambient vehicles in your area with a single keypress.

## Features

- Press Numpad- to clear non-essential vehicles within a 200-unit radius
- Safely preserves important vehicles:
  - Your current vehicle
  - Persistent and mission vehicles
  - Emergency vehicles
  - Vehicles with map blips (LSPDFR units, callouts, etc.)
  - Parked vehicles (no driver, engine off)
  - Vehicles carrying persistent or mission peds

## Requirements

- Grand Theft Auto V
- RagePluginHook (RPH)

## Installation

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

## Configuration

Edit `ClearVehicles.ini` in your `plugins` folder to change the hotkey:

```ini
[Settings]
ClearVehiclesKey=Subtract
ClearVehiclesModifier=None
```

Use any .NET `Keys` enum name for the key (e.g. `Subtract`, `F9`, `Delete`, `End`). Set the modifier to `None` for no modifier, or `LControlKey`, `LShiftKey`, `LMenu` (Left Alt), etc.

## Usage

Press the configured hotkey (default **Numpad-**) to clear ambient vehicles around you. A notification will show how many vehicles were removed.

## Author

Gamecock Tomahawk
