Configuration

Phonograph, Album and Card Table

Settings of the Phonograph (music), Album and Card Table apps, and the server keys of the Phonograph.

Every app here has Enabled = true in its file; false switches it off.

#Phonograph: apps/music/config.lua

A player places a phonograph from the pocketbook_phonograph item and plays records on it; players nearby hear it.

#Placing and hearing

Setting Default What it does
Item 'pocketbook_phonograph' The item that places a phonograph
Model 'p_phonograph01x' Phonograph model
MaxPerCharacter 2 Phonographs one character can have
PlaceDistance 6.0 How far from the player it may be placed
ControlDistance 5.0 How close the owner must be to control it
MinSpacing 2.0 Smallest distance between two phonographs
HearingDistance 25.0 Players within this distance hear it
StreamDistance 60.0 Phonographs within this distance are listed to a player
MaxAudible 3 Phonographs one player hears at once
DefaultVolume .45 Volume of a new phonograph
Interior { Mode = 'muffle', Volume = .45 } A wall between listener and phonograph (one inside a building, the other not, or two buildings): 'muffle' dull and quieter, 'mute' silent, 'off' no change
Setting Default What it does
MaxQueue 50 Records in a phonograph's queue
MaxPlaylists, MaxTracks 20, 100 Playlists per character; tracks in favourites and per import
SearchCooldown 3000 ms between two searches
LinkCooldown 3000 ms between two links played by one player
VolumeSaveDelay 2000 ms the volume slider must rest before the new level is saved and logged. Listeners hear it at once while the slider moves
AllowedHosts {} Hosts allowed for direct audio links. Empty: any HTTPS host. Example: { 'cdn.myserver.com', 'files.catbox.moe' }
YouTube true YouTube links, also from m.youtube.com and music.youtube.com. A playlist link opens the list import when YouTubeApiKey is set
YouTubeSearch Direct = true, endpoint and client values, Language = 'tr', Country = 'TR', Timeout = 8000 Search by name. With YouTubeApiKey in config_server.lua the official API is used; without one the server asks YouTube's own search page. Direct = false turns the keyless search off. The endpoint values are here so they can be patched if YouTube changes something
Spotify { Enabled = false, Market = 'TR', Limit = 10 } Search by Spotify metadata and official Spotify links. Not game audio. Needs the keys in config_server.lua
Spotify.Match { Enabled = true, MaxTracks = 25, Wait = 500, Cooldown = 30000, MaxJobs = 2 } A pasted Spotify track, album or playlist is matched to YouTube records ("artist - title", a hit within 10% of the length is preferred). MaxTracks records per link (also capped by MaxQueue), Wait ms between two searches, Cooldown ms between two links of one player, MaxJobs links matched at once on the server. Enabled = false keeps the catalogue page but refuses links. Needs YouTube = true and the record search
Catalog {} Records and radio streams offered by the server: { title = 'Record name', artist = 'Artist', url = 'https://.../record.ogg', duration = 180 }. Only licensed playable links

#Interaction with a placed phonograph

Setting Default What it does
Target.Enabled true Interaction when looking at your own phonograph: change the record, pause and play, next, volume, pick up
Target.System nil nil: Config.TargetSystem from config_shops.lua. Or 'auto', 'ox_target', 'murphy_interact', 'pc_interaction', 'rsg-target'. With no target script started, hold prompts are shown
Target.Distance 2.0 Interaction distance
Target.Prompt, Target.HoldTime true, 600 Hold prompts and their hold time
Target.Keys { Change = 0xCEFD9220, Toggle = 0xE30CD707, Next = 0x760A9C6F } E, R, G. false hides that prompt

#Features

Setting Default What it does
AutoAdvance true Moves to the next record on the server clock when the length is known
History { Enabled = true, Limit = 100, RetentionDays = 30 } Played records list. Approved starts, not verified listening time
Listening { Enabled = true, RetentionDays = 90 } Listening progress reported by the client, bounded by server time and range
Statistics { Enabled = true } Lasting play counts
Crossfade { Enabled = true, MaxSeconds = 8 } Crossfade between records. Direct audio only. Each phonograph starts at 0 (off)
Sharing { Enabled = true, Range = 5.0, ExpireHours = 48, MaxIncoming = 20, MaxOutgoing = 10, CooldownSeconds = 15 } Giving a playlist to a player nearby
Tone { Enabled = true } Bass, mid and treble per phonograph, -6 to 6 dB. Direct audio only
Imports { Enabled = true, YouTube = true, MaxTracks = 100, MaxScan = 300, CooldownSeconds = 5, ExpireMinutes = 30 } Importing playlists. YouTube imports need YouTubeApiKey
Recommendations { Enabled = true, Personalize = true, Limit = 12, Autoplay = true } Suggestions. Autoplay is available, but each phonograph starts with it off until its owner turns it on

#apps/music/config_server.lua

Setting Default What it does
Spotify.ClientId, Spotify.ClientSecret '' Spotify app credentials (developer.spotify.com): the catalogue page and pasted Spotify links
YouTubeApiKey '' Official YouTube search, imports and YouTube playlist links. Direct links need no key
Logs See config_server.lua

#Album: apps/album/config.lua

Photos are kept as links to images.

Setting Default What it does
MaxPhotos 200 Photos per character
MaxCollections 20 Collections per character
PageSize 12 Photos per page
ImageHosts {} Hosts allowed for photo links. Empty: any
MaxUrl 1000 Link length
MaxTitle, MaxCaption 80, 500 Title and caption length
UploadGuide true A guide in the app: take a screenshot, upload it to upload.fixitfy.com.tr and paste the direct HTTPS image link

#Card Table: apps/kartmasasi/config.lua

Poker dice, faro, blackjack and dominoes against the house, wherever the player stands. Every hand is dealt on the server; the stake is taken when a hand starts and the winnings are paid when it ends.

Setting Default What it does
Currency 'money' 'money': stakes in whole dollars from Config.MoneyAccount. 'chips': stakes in the chip item
ChipItem 'poker_chip' The chip item when Currency = 'chips'. Add it to your inventory
MinBet, MaxBet 1, 100 Smallest and largest stake
HouseCut 5 Percent of every win the house keeps. 0: none
Games { pokerzari = true, faro = true, blackjack = true, domino = true } false hides a game