YouTube search
Players search music from the NUI, play tracks, control volume, pause, resume, and stop their station.
Playable preview
Try the real Tunes interface.
Search, save tracks, adjust volume, and move through the player just like the in-game NUI. The preview uses safe sample data, so it works directly in the browser.
NUI
Lua 5.4
YouTube API
oxmysql optional
Automatic vehicle radio Tunes detects when a player is using a valid vehicle source and connects the station to the car.
Boombox mode Place portable music in the world.
Distance audio Nearby players hear natural falloff.
What it does
Music that behaves like part of the world.
Tunes is built for roleplay servers that want automatic vehicle radio, portable boombox sessions, and distance-based audio without tying the script to one framework.
Automatic car connection
When a player moves into a supported vehicle state, Tunes can connect playback to the car radio source. When they leave, move away, or lose the valid source, the connection is cleaned up automatically.
Boombox playback
Players can place a boombox in the world, play music from it, and pick it back up. Nearby players hear it with range-based volume.
Distance falloff
Audio follows max distance and full-volume distance settings so music fades naturally around the vehicle or boombox source.
Player playlists
The UI includes library views, playlist creation, saved songs, thumbnails, and fast playback actions.
Permission-ready
Run it open to everyone, lock it behind database permissions, or use Discord roles depending on how your server sells or grants access.
Simple install path.
Drop the resource into your server, set the YouTube Data API v3 key in config.lua, and start it with ensure tunes. The app name, command names, default volume, distance settings, vehicle rules, and boombox model are configurable.
Flexible permissions.
Run it open to everyone, lock it behind a SQL permission table, or use Discord role checks. It supports ESX, QB, QBX, and standalone identifiers, with admin grant commands and optional perm ID bridge support.
Vehicle logic
Automatic connection and disconnection.
Tunes is designed to feel like part of the vehicle instead of a separate menu players have to manage every time they move around.
Connects when the source is valid
The script can detect the player's active playback context and attach the station to the correct source, such as a vehicle radio session. This means the music follows the car instead of feeling like a private player-only sound.
Disconnects cleanly
When the player leaves the vehicle, moves out of range, switches source, or the station should no longer be active, Tunes closes that connection and keeps the audio state tidy for everyone nearby.
Configurable server rules
You can choose whether vehicle use is required, whether the player must be the driver, and how far the music should travel with Config.RequireVehicle, Config.RequireDriver, and the distance settings.
Perm ID support
Wire it into your permission ID script.
Tunes includes a bridge file for custom ID systems, and our UKCN perm ID script is already wired in out of the box.
UKCN perm ID is ready
Set Config.PermId.mode = 'UKCN_permid' and Tunes can resolve your permanent IDs directly through the included UKCN perm ID integration. Staff can grant access using a player's perm ID instead of needing them online by server ID.
The UKCN perm ID script is built to work across the major FiveM frameworks, including ESX, QB, QBX, and standalone-style identifier setups.
Custom bridge for your own ID system
If your server uses a different perm ID resource, set Config.PermId.mode = 'custom' and edit server/permissions_bridge.lua. The bridge resolves the staff input into the identifier Tunes should save.
The resolver returns the player's identifier, framework name, and an optional label. Tunes then stores that in the permissions table so the access check works the same way as a normal database grant.
Example flow
givetunes 1024
Staff enter a perm ID, Tunes resolves it through UKCN perm ID or your custom bridge, then saves the matching ESX/QB/QBX/standalone identifier for future access.
Autocar connect and disconnect
Boomboxplace and pick up mode
Perm IDUKCN support included
Updatesmore features coming soon
Store and support
Ready for Tebex, with more updates planned.
Tunes will continue to be updated in the near future with improvements, fixes, and new quality-of-life features. Use the Tebex placeholder for your live package link, and send customers to Discord for support and announcements.