AWS DJ System

A venue music controller with DJ booths, distance-based listening and saved playlists.

Installation

Requirements

oxmysql
QBCore, Qbox or ESX for framework-backed access checks
A supported target when Config.Interaction is target; drawtext and 3dtext modes are also included

Startup order

This example selects one framework and target. Use the resources matching your configuration and start dependencies first.

ensure oxmysql
ensure qb-core
ensure aws-dj

Setup steps

schema.sql creates aws_dj_playlists. The server also includes CREATE TABLE IF NOT EXISTS; use one initialization path and do not drop existing playlists.
Edit Config.DJBooths with your venue positions and configured listening areas.
Select an interaction mode and start its target/text resource first when required.

Gameplay and usage

Interact with a booth, play a supported media URL and adjust its volume.
Save a playlist, reconnect and verify it returns for the same player identifier.

Configuration

config.lua: Config.DJBooths sets booth positions and jobs.
Config.Interaction and Config.TargetSystem select the interaction provider.
Config.UseJobRestriction enables per-booth job restrictions.
Config.VolumeDrop, OutsideVolumeMult, OutsideExtraDrop and VolumeUpdateRate tune listening behavior.
Config.UI, Config.Soundboard, Config.MaxPlaylistSize and Config.MaxPlaylists configure controls and saved content.

Exports and integrations

No public callable export is declared with exports() in these source files. Use the documented commands or configuration; internal network events are not a trusted integration API.

Troubleshooting

If interaction is missing, verify booth coordinates and the selected target/text integration.
If no audio plays, test another supported URL and check browser/NUI playback restrictions and player volume.
Include the package version, framework and exact server/F8 error when requesting support. Remove private tokens and player data.

Package reference

Manifest	Version
`fxmanifest.lua`	2.0.0

Database files

aws-dj/schema.sql

Configuration reference

aws-dj/config.lua: DJBooths, Interaction, TargetSystem, DrawTextSystem, InteractKey, InteractKeyLabel, UseJobRestriction, VolumeDrop, OutsideVolumeMult, OutsideExtraDrop, VolumeUpdateRate, UI, MaxPlaylistSize, MaxPlaylists, Soundboard

Frequently asked questions

Does this need Keymaster or an escrow key?

The Lua sources in this delivery package were readable in the static audit. No /assetpacks requirement is added by this package. Required framework, inventory and map resources still need to be installed separately.

Can I change the folder or database table names?

Keep the supplied folder names. Historical event, SQL and KVP identifiers are retained to protect existing integrations and saved data. Renaming a table or event requires a separate migration.

Why is an interface or item missing?

Check the startup order, selected framework/target adapter, inventory item definitions and the server/F8 console. The package does not install an entire framework or inventory for you.

Has this been tested on my server?

ZIP integrity, source readability, script syntax and manifest references were checked locally. Multiplayer gameplay, your framework version and integrations require a FiveM server acceptance test before a public release.