Configuration

Everything you can change is in config.lua.

General

OptionDefaultWhat it does
Config.DebugfalseConsole messages while setting up.
Config.TargetResource'auto''auto' uses fusing-target or qb-target, or name a target resource, or false for none.
Config.RemoteDistance12.0How far from a TV it can still be controlled.
Config.LockToUsertrueWhile someone is playing something on a shared TV, only they, the owner or admins can change it.
Config.MasterVolume0.5Scales every TV for everyone (0.0 to 1.0). The game's own volume sliders do not affect TVs.
Config.MaxScreens4How many TVs can play at once for each player (the nearest ones). Higher costs FPS.
Config.IdleText''Text under the logo on the standby and home screen. '' shows the logo only.

Using a TV

Config.Interact: walk up to a TV and press the key.

OptionDefaultWhat it does
EnabledtrueTurns the key prompt on or off.
Control51The key. 51 is E on keyboard, D-pad right on controller.
Distance2.5How close to a TV, or below a wall screen, you need to be.

What can be played

OptionDefaultWhat it does
Config.Sources.youtubetrueyoutube.com and youtu.be links.
Config.Sources.gtatrueGTA's own TV channels (on TVs, not wall screens).
Config.Moderation.BlockedWords{}Links containing any of these words are refused, e.g. { 'nsfw' }.
Config.Moderation.Webhook''Discord webhook that logs who played what. '' is off.

TV models

Config.Models lists the TV props that can be used. It comes with every GTA flat-screen TV prop that has its own screen (21 flat-screen models). The picture plays on the TV's real screen in full HD.

FieldWhat it does
labelName of the TV.
targetThe prop's screen name in the game files.
rangeHow far the TV can be heard and seen.
volumeStarting volume.
frameOptional. For TVs whose stand or bezel makes the mouse miss: how much of the model is not screen.
Config.Models = {
    ['prop_tv_flat_01'] = {
        label  = 'Flat TV',
        target = 'tvscreen',
        range  = 20.0,
        volume = 60,
    },
}

A screen is shared by every copy of a model, so only the nearest one of each model plays at a time. Placed Flat TVs are the exception: each one gets its own screen, so up to 4 near each other can play different things.

Watch history

OptionDefaultWhat it does
Config.History.EnabledtrueKeeps a watch history per character.
Config.History.Max12How many are kept per kind.

Player-placed TVs

OptionDefaultWhat it does
Config.Place.EnabledtrueLets players place TVs from an item.
Config.Place.Items17 TVs, e.g. fusing_tv places prop_tv_flat_01Item name and the model it places.
Config.Place.MaxPerPlayer2How many TVs each player can place.
Config.Place.MaxDistance5.0How far from the player a TV can be placed.
Config.Place.SpawnDistance60.0Placed TVs appear within this distance.

Map TVs

OptionDefaultWhat it does
Config.World.AnyoneCanUsetrueAnyone can use TVs that are part of the map.

Wall screens

OptionDefaultWhat it does
Config.Screens.DefaultRange35.0Range for screens that do not set their own.
Config.Screens.DefaultVolume70Volume for screens that do not set their own.
Config.Screens.PublicByDefaultfalseWhen true, screens without a job can be used by anyone. Admins always can.
Config.Screens.Static{}The list of screens.

Each screen takes label, coords, heading, pitch, width, height and an optional job, range and volume.

Static = {
    { label = 'Vanilla Unicorn', coords = vector3(112.0, -1290.0, 29.8), heading = 120.0, pitch = 0.0, width = 3.2, height = 1.8, job = 'vanilla' },
},

Admin

OptionDefaultWhat it does
Config.Admin.Ace'fusingtv.admin'The ace admins need.