Everything is in config.lua, with a comment on each setting. Put your own changes in a new config.site.lua next to it. It loads after config.lua, so updates never overwrite your settings:
Config.StaffAces = { 'audioprops.staff' }
Config.Remote.items = { 'audio_tablet', 'phone', 'tablet' }
Config.Vehicle.requireSlot = nil
Which links play#
| Link | Without conversion | With conversion |
|---|---|---|
Direct audio file (.mp3, .ogg, .m4a, ...) |
Plays, with every effect when the host allows it (CORS) | Copied to your bucket, every effect |
| YouTube | Plays in YouTube's player: volume and crossfade only | Audio file, every effect |
SoundCloud, Spotify, Deezer, Apple Music, sites in Config.Convert.webSites |
Refused, they need conversion to play | Audio file, every effect |
Direct audio and video links (files, .m3u8 streams) are opened by each player's game browser, so the site behind the link sees those players' IP addresses. Switch on mirroring if every song should come from your own bucket.
Radio channel#
Config.TV.radio = { resource = 'my-radio', number = 100, name = 'City FM' } adds a radio station as a TV channel and as a tile on every stereo. The radio resource has to publish what is on air in GlobalState.glitchRadio: { kind = 'song' | 'news' | 'link' | 'off', url, id, title, artist, dur, start }, where start is the server's GetGameTimer() when it began. Leave it at false without one.
Hooks for other resources#
| Setting | What it reads |
|---|---|
Config.Vehicle.requireSlot |
Only cars with this part in the vehicle state bag glitchBuild.parts get a stereo. nil = every car. |
Config.Vehicle.buildResource |
A resource with a GetBuild(plate) export, read when the state bag is missing. |
Config.MedicalResource |
A resource with IsDead() and IsLaststand() client exports, checked besides the Qbox metadata. |
Configuration reference#
These settings come from the inspected package. Tables contain nested fields; edit them using the examples in the supplied file. Keep secrets in server-only configuration.
config.lua defaults#
| Setting | Default / editing guidance |
|---|---|
Config.Debug |
false |
Config.AdminAce |
'command.audioadmin' |
Config.AdminCommand |
'audioadmin' |
Config.MedicalResource |
nil |
Config.StaffAces |
Table; fields and examples are in the supplied configuration file. |
Config.StreamIn |
160.0 |
Config.StreamOut |
200.0 |
Config.ControlDistance |
4.0 |
Config.Inner |
0.25 |
Config.Occlusion |
0.35 |
Config.MuffleHz |
900 |
Config.ZoneFade |
6.0 |
Config.Defaults |
Table; fields and examples are in the supplied configuration file. |
Config.StartVolume |
0.5 |
Config.DefaultAccess |
Table; fields and examples are in the supplied configuration file. |
Config.Models |
Table; fields and examples are in the supplied configuration file. |
Config.PropImage |
'https://cdn.gtahash.com/objects/thumbs/%s.webp' |
Config.Ghosts |
Table; fields and examples are in the supplied configuration file. |
Config.Items |
Table; fields and examples are in the supplied configuration file. |
Config.ItemPlaceDistance |
6.0 |
Config.MaxItemsPerPlayer |
4 |
Config.LinkDistance |
40.0 |
Config.PickupAccess |
'owner' |
Config.ReturnOnRestart |
Table; fields and examples are in the supplied configuration file. |
Config.NoSteal |
Table; fields and examples are in the supplied configuration file. |
Config.MaxItemUsers |
20 |
Config.Vehicle |
Table; fields and examples are in the supplied configuration file. |
Config.Remote |
Table; fields and examples are in the supplied configuration file. |
Config.Phone |
Table; fields and examples are in the supplied configuration file. |
Config.LibraryAdd |
'anyone' |
Config.LibraryMax |
2000 |
Config.LibraryAddPerHour |
30 |
Config.Convert |
Table; fields and examples are in the supplied configuration file. |
Config.ThemeItems |
Table; fields and examples are in the supplied configuration file. |
Config.ThemeResetItem |
'car_stereo' |
Config.ThemeTime |
6000 |
Config.StreamerCommand |
'streamermode' |
Config.Mic |
Table; fields and examples are in the supplied configuration file. |
Config.AutoDJ |
Table; fields and examples are in the supplied configuration file. |
Config.Playlists |
Table; fields and examples are in the supplied configuration file. |
Config.Effects |
Table; fields and examples are in the supplied configuration file. |
Config.Smoke |
Table; fields and examples are in the supplied configuration file. |
Config.Colours |
Table; fields and examples are in the supplied configuration file. |
Config.Accent |
'#a855f7' |
Config.Quality |
Table; fields and examples are in the supplied configuration file. |
Config.TV |
Table; fields and examples are in the supplied configuration file. |