Description
1. Description
Realistic Vehicle Radio brings immersive audio mechanics to GTA V by dynamically adjusting vehicle radio volume and availability based on the vehicle’s physical state and environment. The mod automatically mutes the radio when driving through custom recorded tunnels, underpasses, or canyons, as well as when deeply submerged underwater. It also intelligently switches the radio to a “loud” (exterior) mode when the convertible roof is down, windows are shattered, or doors are open or broken. You can fully customize these behaviors, exclude specific vehicle classes or models, and even record your own custom tunnel paths using the built-in automatic and manual tunnel recorder with a real-time debug visualizer. Thanks to a custom spatial-hashing grid, tunnel detection is highly optimized and has virtually zero impact on FPS, even with hundreds of recorded tunnels. All settings and tunnel data are stored in JSON format, and the script includes an automatic update checker. The script supports both the Legacy and Enhanced editions of GTA V.
Hotkeys (Configurable):
Open Menu Key:
Function: Opens the main LemonUI menu for the script, allowing access to settings, tunnel management, and keybindings.
Default Key: F3
Toggle Debug Visualizer Key:
Function: Toggles the on-screen debug drawing to visualize tunnel boundaries, recording previews, and vehicle projections.
Default Key: F6
Toggle Tunnel Recorder Key:
Function: Starts or stops the automatic tunnel recording process while inside a vehicle.
Default Key: F7
Useful Notes:
For the best performance, it is recommended to set “Vehicles Search Distance” to 50.0m and “Max Process Vehicles” to 30 in the Main Settings menu.
When recording tunnels, a “Min Distance” of 2.0m to 3.0m is recommended to keep file sizes small and performance high. Use 1.0m only for very complex or short tunnels.
Manual recording and automatic recording are mutually exclusive. You must disable one before using the other to prevent data corruption.
The script only processes vehicles that have their engine running.
Important:
Tunnel detection uses a spatial-hashing grid. If you add, delete, or modify tunnels, or change the detection tolerances in the menu, the index will automatically rebuild.
When recording make sure to disable all vehicles and peds using trainers like Menyoo, as they can interfere with the recording. As a result, the recorded data will be inaccurate/corrupted. See this guide to learn more about recording.
Don’t hesitate to suggest features, improvements, bugs, or anything else about this script mod. I’ll be more than happy to read your suggestions.
2. Features
Dynamic radio muting inside custom recorded tunnels.
Radio muting when vehicles are deeply submerged in water (configurable depth threshold).
Loud radio mode for open roofs, broken windows, and open/broken doors.
Random chance for loud radio in fully closed vehicles.
Comprehensive vehicle class and model exclusions.
Built-in automatic and manual tunnel recorder.
Real-time debug visualizer for tunnel boundaries and recording previews.
Spatial-hashing grid architecture for zero-FPS-impact tunnel detection.
LemonUI configuration menu with keybinding support.
JSON-based storage for settings and tunnel coordinates.
Async based I/O operations.
Predefined tunnels included for immediate use.
The script works on all vehicles not just player vehicle.
Works out of the box, no need to configure anything. The current settings are optimized for performance.
Compatible with both the Legacy and Enhanced editions of GTA V.
Open source under the GNU GPLv2 license.
3. Requirements
Grand Theft Auto V Legacy or Grand Theft Auto V Enhanced
Script Hook V
For GTA V Legacy:
Script Hook V .NET (nightly)
OR Script Hook V .NET Enhanced
For GTA V Enhanced:
Script Hook V .NET Enhanced
.NET Framework 4.8
4. Installation
Ensure that the required versions of Script Hook V, Script Hook V .NET, and .NET Framework 4.8 are properly installed.
Run Install Helper.bat and follow the instructions to determine which folder matches your setup.
Extract all files from the folder suggested by Install Helper.bat into your “scripts” folder (create it if missing using the exact same name) in your GTA V directory.
If updating or downgrading, then ONLY replace “RealisticVehicleRadio.dll” file.
Launch the game and press F3 to open the configuration menu.
Press F7 while in a vehicle to start recording your first tunnel!
5. Known Bugs & Mod Conflicts
Enabling the Debug Visualizer with a massive amount of tunnels and a very high “Max Draw Distance” may cause minor FPS drops due to native line drawing limits. Lower the Max Draw Distance in the Debug Settings menu if this occurs.
No other mod conflicts are currently known. If you find one, please report it!
6. FAQs
Q: I found a bug(s) and/or mod conflict(s). How can I report it?
A: Contact me directly through the mod’s page (officially on the GTA5Mods website) and include your GTA V version (Legacy or Enhanced) and the contents of “Realistic Vehicle Radio Log.txt”; if the file is empty or doesn’t exist, include the contents of “scripthookvdotnet.log”. If possible, also include the steps to reproduce the issue. While optional, this helps me troubleshoot the problem much faster and identify exactly where the issue occurs.
Q: Does This Mod Affect Performance (FPS)?
A: No. The script uses a custom spatial-hashing grid for tunnel detection and throttles heavy logic checks. Even with hundreds of tunnels recorded across the map, the script only calculates the ones immediately around you, resulting in virtually zero FPS impact.
Q: How do I record a new tunnel?
A: Get in a vehicle and press the Recorder Toggle Key (Default: F7) to start automatic recording. Drive through the tunnel, then press F7 again to stop and save. You can also use the “Manual Recording” menu to add points one by one for precise adjustments.
Q: Can I add map blips to my recorded tunnels?
A: This script handles the audio and detection logic. To add custom map blips to your tunnels, I highly recommend using my other open-source mod, Advanced Custom Blips.
Q: How to disable a key (e.g., menu key, debug key, recorder key)?
A: You can disable keys in two ways:
In-game menu: Open the menu using F3, go to the respective settings menu, and find the key you wish to disable. Scroll through the list until it shows “None”, then select and press Save Changes.
Via JSON file: Open “Realistic Vehicle Radio Settings.json” then find the key you want to disable and replace its value with “None”.
For more information vist this site.
7. Changelog
v1.2.2 – Slight Cleanup Optimization & Menu Bug Fix
Improved: Cleanup logic now reuses an existing collection instead of allocating a new collection on every logic tick, reducing unnecessary garbage collection overhead.
Fixed: Vehicle radio state could remain disabled after a vehicle entered a tunnel, had its engine turned off, and then left the tunnel without restarting the engine. The radio state is now correctly restored when the engine is off.
Fixed: Vehicle exclusion menu, the pending vehicle list remains correctly initialized on startup and continues to be updated by the Add/Remove buttons.
v1.2.1 – Logic Bug Fixes in Loudness & Weather
Fixed: Loudness re-evaluation now triggers correctly in both directions (e.g., breaking an intact window or opening a closed door will now instantly make the radio loud, instead of requiring the player to exit and re-enter the vehicle).
Fixed: Window detection now checks all vehicle glass (including the windshield and rear glass) using SHVDN’s AllWindowsIntact property, fixing a bug where shooting out the front/rear glass didn’t trigger the loud radio mode.
Fixed: Thunderstorm interference now correctly detects the weather during active transitions by using SHVDN’s native World.Weather property, fixing a blindspot when the game was actively transitioning into a storm.
v1.2.0 – Quality of Life & Performance Fixes
Added: Automatic GitHub-based update checker to notify you when a new version is available.
Improved: “Reset to Defaults” and “Save Changes” buttons now behave correctly — resetting only stages the changes in the menu, and you must press Save to actually apply them to the game and JSON file.
Improved: Cleanup logic on script abort now properly resets the radio states of all vehicles that were processed by the script, rather than just the ones currently cached in the dictionary.
Fixed: Cached vehicle states not refreshing correctly when a loudness feature (roof, windows, doors) is toggled on or off via the configuration menu.
Fixed: Redundant native calls being sent to the game engine for every newly spawned/processed vehicle, further improving performance.
Fixed: Menu items (like checkboxes) sometimes showing a mismatched status compared to the actual runtime state when reopening the menu.
Fixed: Manual recording preview debug lines remaining visible on screen even when the main Debug Mode was turned off.
v1.0.0 – Initial Release
Added: Dynamic radio muting inside custom recorded tunnels.
Added: Radio muting when vehicles are deeply submerged in water.
Added: Loud radio mode for open roofs, broken windows, and open/broken doors.
Added: Random chance for loud radio in fully closed vehicles.
Added: Comprehensive vehicle class and model exclusions.
Added: Built-in automatic and manual tunnel recorder.
Added: Real-time debug visualizer for tunnel boundaries and recording previews.
Added: Spatial-hashing grid architecture for zero-FPS-impact tunnel detection.
Added: LemonUI configuration menu with keybinding support.
Added: JSON-based storage for settings and tunnel coordinates.
Added: Async based I/O operations.
Added: Predefined tunnels.
Added: Support for both versions of GTA V (Legacy and Enhanced).
8. Credits
Ali Osama — Script mod author and developer
Rockstar Games — Grand Theft Auto V
Alexander Blade — Script Hook V
Crosire — Script Hook V .NET
kagikn — Script Hook V .NET Nightly
Chiheb Bacha — Script Hook V .NET Enhanced
Justalemon — LemonUI
James Newton-King — Newtonsoft JSON
Aromatic-Plastic1799 — Huge thanks for tunnels locations
SuperNull — Much appreciated for railway map
👍 Someone liked this mod 4 hours ago!
💡 Others also downloaded: Driver Theft Auto SF (Drvta SF), Sodiumengine SP [Legacy & Enhanced], Shottas Recoil.
Share Your Gameplay!
Submit a screenshot of this mod!
Submit a YouTube video.

