connect cfx.re/join/oqjrvj
Join our Discord
📻 iKCScripts Boombox - Music System
Bring the music anywhere in your city.
iKCScripts Boombox is a premium placeable music system for FiveM with synchronized positional audio, persistent physical boomboxes, playlists, queue management, playback history, sharing, Trusted Friends and secure owner permissions.
Place it at a house party, club, meet, beach, event, hangout or anywhere else your citizens want music.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ KEY FEATURES
📻 PLACEABLE BOOMBOX
Use the inventory item and position a physical boombox exactly where you want it.
Placement includes a polished preview system with positioning, rotation, confirmation and cancellation.
Canceling placement keeps the item in your inventory.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔊 POSITIONAL AUDIO
Music plays directly from the physical boombox using synchronized positional audio.
Audio naturally fades as citizens move farther away from the boombox, creating a much more immersive in-city experience.
Citizens entering the area after playback has started are synchronized with the active music session.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎵 SUPPORTED MUSIC
Play supported:
• Compatible direct audio URLs
Paste a URL and choose:
▶ Play Now
📋 Add to Queue
🎶 Add to Playlist
Spotify webpage URLs are intentionally rejected because they are not direct playable audio streams.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 ADVANCED QUEUE
Build and manage music without interrupting the current track.
• Add tracks
• Remove tracks
• Reorder tracks
• Play individual queued tracks
• Clear the queue
• Previous / Next
• Shuffle
• Loop
Queue actions are synchronized and validated by the server.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎶 PERSONAL PLAYLISTS
Each citizen has their own persistent playlist library.
• Create playlists
• Rename playlists
• Delete playlists
• Add songs from the current track
• Add songs from Queue
• Add songs from History
• Add pasted URLs
• Reorder tracks
• Remove tracks
• Play individual tracks
• Queue individual tracks
• Play All
• Queue All
Supports up to:
• 20 playlists per citizen
• 100 tracks per playlist
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤝 PLAYLIST SHARING
Citizens can share playlists with someone nearby.
The receiving citizen can:
✅ Accept
❌ Decline
Accepted playlists become an independent copy inside the recipient's personal library.
Editing or deleting the original playlist does not affect the shared copy.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👥 TRUSTED FRIENDS
Owners can give selected friends persistent permission to control their boomboxes.
Trusted Friends can control music while nearby even when:
Others Around = OFF
Trusted Friends can control:
• Playback
• Queue
• Seek
• Volume
• Loop
• Shuffle
Trusted Friends CANNOT:
• Pick up the owner's boombox
• Take ownership
• Manage the owner's Trusted Friends
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🌎 OTHERS AROUND
Every boombox includes an owner-controlled Others Around setting.
OFF:
Nearby citizens can view playback information but cannot control protected music actions.
ON:
Nearby citizens can control music while within the configured control distance.
The owner always retains full control.
Permission priority:
OWNER
↓
TRUSTED FRIEND
↓
OTHERS AROUND
↓
VIEW ONLY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔒 OWNER PROTECTION
Only the owner can pick up their physical boombox.
Others Around and Trusted Friend permissions never transfer ownership.
When successfully picked up:
• Music stops
• The physical prop is removed
• Persistent placement is removed
• The boombox inventory item is returned to the owner
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💾 PERSISTENT BOOMBOXES
Placed boomboxes persist through resource and server restarts.
Persistent systems include:
• Physical boombox placement
• History
• Playlists
• Trusted Friends
• Personal settings
Active music intentionally does not automatically resume after a complete server restart.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎛️ FULL MUSIC CONTROLS
Includes:
▶ Play
⏸ Pause
⏹ Stop
⏮ Previous
⏭ Next
⏩ Seek
🔁 Loop
🔀 Shuffle
🔊 Volume
🔇 Mute
Default keyboard volume controls:
PAGE UP — Volume Up
PAGE DOWN — Volume Down
Volume keys only control the exact boombox explicitly selected by the citizen.
No nearest-boombox switching.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ FLEXIBLE SERVER INTEGRATION
CORE REQUIREMENTS:
• ox_lib
• xSound
• OneSync
INVENTORY SUPPORT:
• QBox / ox_inventory
• ox_inventory
• QBCore / qb-inventory
• ESX Legacy default inventory
INTERACTION SUPPORT:
• ox_lib TextUI
• ox_target
• qb-target
Inventory and interaction selections are independent.
You can use ox_inventory with qb-target, QBCore with ox_lib TextUI, or another supported combination.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 INTERACTION OPTIONS
ox_lib TextUI requires no separate target resource.
OWNER:
[E] Open Boombox • [G] Pick Up
OTHER CITIZENS:
[E] Open Boombox
Optional exact-entity targeting is also available through ox_target and qb-target.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔐 SERVER-SIDE VALIDATION
Important actions are validated server-side, including:
• Ownership
• Control permissions
• Distance
• Entity selection
• Queue actions
• Playlist actions
• Playlist sharing
• Trusted Friends
• Inventory transactions
• Placement
• Pickup
Each placed boombox is handled independently.
The resource never silently switches control to another nearby boombox.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🖥️ POLISHED NUI
The Boombox includes a purpose-built music interface featuring:
• Circular Now Playing display
• URL playback
• Queue
• Playlists
• History
• Settings
• Trusted Friends
• Others Around
• Volume controls
• Track progress
• Toast notifications
• Keyboard-friendly URL entry
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡️ OFFICIAL FIVEM ASSET ESCROW
Delivered using the official Cfx.re FiveM Asset Escrow system.
Server owners retain access to the configuration required to set up the resource while protected Lua logic is distributed through Asset Escrow.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📚 DOCUMENTATION
Complete documentation:
https://ikcscripts.gitbook.io/docs/boombox
Includes:
• Requirements
• Installation
• Configuration
• Placement & Pickup
• Opening & Controls
• Others Around
• Positional Audio
• Queue
• Playlists
• History
• Trusted Friends
• Supported URLs
• Troubleshooting
• Asset Escrow
• Support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 SUPPORT
Discord:
Support covers installation guidance and reproducible issues with the original unmodified resource.
Custom modifications, custom integrations, third-party dependency support and custom feature development are outside standard support.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📜 LICENSE
One purchase grants use on one FiveM server project, including a development/test server belonging to that same project.
Redistribution, resale, sharing, sublicensing, public uploading or claiming the resource as your own is prohibited.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📻 iKCScripts Boombox
PLACE IT.
PLAY IT.
SHARE THE VIBES.
Version 1.5.1