Music & Equalizer

All music-related options in shared/config.lua.

Distance & Volume

lua

Config.Distance = 30.0      -- meters — how far other players can hear
Config.MaxVolume = 100      -- 1-100 server-wide cap

• Distance controls 3D positional audio falloff. Volume scales linearly with distance: full at 0 m, silent at Distance m
• MaxVolume caps the actual output even at slider 100%. Use this to enforce a server-wide volume policy

Default Playlist (Server-Wide)

Songs added here appear under the Home tab for every player:

lua

Config.MainMusics = {
    {url = "MEDIA_LINK_HERE", title = "Artist - Song"},
    {url = "MEDIA_LINK_HERE", title = "Another Song"},
}

Each entry needs url (media link) and title (display name).

• Players cannot remove these from their library
• Players can add them to personal playlists
• Useful for radio stations, server theme songs, RP-event playlists

Empty array ({}) means no default songs.

Equalizer Presets

lua

Config.EQPresets = {
    flat       = { label = "Flat",       subBass = 0,  bass = 0,  mid = 0,  treble = 0,  brilliance = 0 },
    bass_boost = { label = "Bass Boost", subBass = 6,  bass = 4,  mid = 0,  treble = -1, brilliance = 0 },
    rock       = { label = "Rock",       subBass = 4,  bass = 3,  mid = -1, treble = 3,  brilliance = 4 },
    pop        = { label = "Pop",        subBass = -1, bass = 2,  mid = 4,  treble = 3,  brilliance = 0 },
    vocal      = { label = "Vocal",      subBass = -3, bass = -1, mid = 5,  treble = 3,  brilliance = 1 },
    classical  = { label = "Classical",  subBass = 0,  bass = 0,  mid = -2, treble = 3,  brilliance = 5 },
}

EQ Bands

Band	Center frequency	Description
subBass	60 Hz	Sub-bass — the rumble; affects bass-heavy music
bass	250 Hz	Bass — body of the kick drum & bass guitar
mid	1 kHz	Midrange — vocals, snare, guitars
treble	4 kHz	Treble — cymbals, sibilance, presence
brilliance	12 kHz	Brilliance — air, sparkle

Each band accepts gain in dB, range −12 to +12. Higher = louder.

Preset Structure

Field	Type	Description
label	string	Display name shown in the UI
subBass	number	Sub-bass gain in dB (−12 to +12)
bass	number	Bass gain in dB
mid	number	Mid gain in dB
treble	number	Treble gain in dB
brilliance	number	Brilliance gain in dB

Adding a Custom Preset

lua

Config.EQPresets.electronic = {
    label = "Electronic",
    subBass = 8,
    bass = 5,
    mid = -2,
    treble = 5,
    brilliance = 7,
}

The key (electronic) is the internal name. The label is what users see.

Removing a Preset

Just delete the entry. The UI updates automatically.

Resetting to Flat

Players can always pick the flat preset (all 0s) to disable EQ effects.

Tip

Don't go above +9 dB for any band — clipping artifacts become noticeable. The Bass Boost preset's +6 sub-bass / +4 bass is a balanced "noticeable but not muddy" recipe.

Module Toggle

Option	Default	Description
Config.Modules.MusicPlayer	true	Show the music player module