# Bullet Time Mod for GTA V (SHVDN)

Adds a **Bullet Time / slow-motion effect** in GTA V with custom sounds and configurable keys.

## Features

* Press a configurable key to toggle Bullet Time.
* Time slows down smoothly when activated.
* Plays `bullet_time_start.mp3` when activated.
* Loops `bullet_time_mid.mp3` while Bullet Time is active.
* Plays `bullet_time_end.mp3` when deactivated.
* Fully configurable key and slow-motion factor via INI.

---

## Requirements

* **GTA V (PC)**
* **ScriptHookVDotNet** (SHVDN) v3.7 or higher
* **NAudio** (included in mod or add via NuGet if compiling yourself)
* **USE SHVDNE By Chiheb-Bacha INSTEAD OF SHVDN IF YOU HAVE GTA V ENHANCED INSTEAD OF LEGACY LEGACY USERS USE SHVDN                  
    ONLY 
* **MP3 audio files** in `scripts/SoundFX/` folder:
    
  * `bullet_time_start.mp3`
  * `bullet_time_mid.mp3`
  * `bullet_time_end.mp3`

---

## Installation

1. Make sure **ScriptHookVDotNet** is installed in your GTA V directory.
2. Copy `BulletTimeMod.dll` into the `scripts` folder.
3. Create a folder `scripts/SoundFX/` and add your MP3 files:

   * `bullet_time_start.mp3`
   * `bullet_time_mid.mp3`
   * `bullet_time_end.mp3`
4. Place the INI file in `scripts/BulletTime.ini`:

5. Launch GTA V. Press your configured key to activate/deactivate Bullet Time.

---

## Notes

* Only **one Bullet Time key** is supported at a time (configurable in INI).
* Slow factor is clamped between `0.01` (super slow) and `1` (normal speed).
* Make sure your MP3 files exist in the `scripts/SoundFX/` folder or the mod will fail silently.
* If the start sound plays instantly as the mid loop, it’s because threads start immediately. The mod now waits for start audio to finish before looping mid audio.

