Configuration

All settings live in config.lua at the root of the resource. The file ships unescrowed, along with the framework bridge, the vehicle door code and the language files.

Changes apply on the next full server restart. Restarting only lation_interact clears everything other scripts registered with it, and most scripts register only when they start.

Update checkCopy Anchor Link

Reveal distancesCopy Anchor Link

Config.Stages = {
    grain = 8.0,
    name = 4.5,
    reach = 2.4,
    exitMargin = 0.4
}

A registration can set its own stages. Sphere and box zones work out their stages from their size unless they set them, and the ox_target and qb-target bridges work theirs out from each option's distance.

How lists openCopy Anchor Link

'smart' counts the options the player can actually see, so a list checked down to one row opens on its own. A waiting list also opens on a left click while the interact key is held. A registration can override this with expand.

In 'manual' mode, and for lists in 'smart' mode, a list folds back after the player picks an option (0.85 s after the option answers, 1.5 s after a refusal), unless that option sets keepOpen.

What shows before focusCopy Anchor Link

Config.Reveal = {
    point = 'ambient',
    bridged = 'focus'
}

Vehicles, peds and objects always reveal on focus, whatever this is set to. A point or zone can override this with reveal.

KeysCopy Anchor Link

On a controller, confirm also answers to control 38 (INPUT_PICKUP). Rows are highlighted only with the mouse, and keys of their own are read from the keyboard, so a controller runs only the first row of a list, and only when that row has no key of its own.

While the interact key is held, attack, aim and melee are off, so clicks go to the card instead of the weapon.

Key namesCopy Anchor Link

Config.ConfirmKey and an option's key take these names. They are not case sensitive.

FocusCopy Anchor Link

Passive modeCopy Anchor Link

Passive interactions are hidden until the player holds the interact key, like a classic target. Hidden ones have no point of light, no name and no input. When the key is released, a passive list closes right away.

Config.Passive = false
Config.PassiveResources = {}

A single registration can set passive = true or passive = false, which wins over both options. The built-in vehicle doors have their own setting, under vehicles.

If passive mode is on but both Config.InteractKey and Config.InteractControl are false, the console warns that passive interactions can never be revealed.

LookCopy Anchor Link

Config.AccentIcons = false
Config.Hint = true
Config.Grain = {
    size = 0.02,
    alpha = 180,
    breathe = true
}

The hint's text comes from ui.hint in the language files and names Alt whatever the interact key is. If you move Config.InteractKey off Left Alt, change the text there too.

Up to 20 points of light are drawn at once; past that, the nearest win.

ThemeCopy Anchor Link

There is nothing to set. While lation_ui runs, the cards take its theme: colors, opacity, corners, border width, shadow, font, UI scale and reduced motion, and the point of light takes the accent. A server theme saved with /uitheme reaches them right away; a player's personal theme, the next time that player joins. Without lation ui, the default look applies. See theming.

VehiclesCopy Anchor Link

Config.IncludeOwnVehicle = false
Config.VehicleDoors = true
Config.InVehicle = {
    entities = false,
    points = true
}

A registration can set inVehicle = true or false to override Config.InVehicle. An option bridged from ox_target or qb-target that sets allowInVehicle = true keeps its interaction live from a seat.

The door toggles sit on the door handle, or in the middle of the hood or trunk lid. They don't show while the player is seated, while the vehicle is locked, or for a door the model lacks or that is damaged. A toggle on a vehicle another player's game controls is passed to that player through the server. setr ox_target:defaults 0 in server.cfg also turns them off.

SuppressionCopy Anchor Link

When any of these states is true, the whole layer goes quiet: no points of light, no focus, no input.

Config.Suppress = {
    dead = true,
    cuffed = true,
    pauseMenu = true,
    nuiFocus = true,
    progress = true
}

Dead and cuffed detection lives in bridge/client.lua, in IsPlayerDead and IsPlayerCuffed, so you can adapt it to your scripts. A cuff script can also hide the layer itself with the suppress export. See hiding the layer.

LanguageCopy Anchor Link

lation interact reads its language from the lation:locale convar and falls back to English when there is no file for it. Set it in server.cfg with setr, since the text is shown on the client:

setr lation:locale "de"

Included languages: cs, da, de, en, es, fr, it, nl, no, pl, pt, sv and zh. The files in locales/ hold the hint line, the key binding's name in FiveM settings and the vehicle door labels; every other label on a card is the registering script's own text. To add a language, copy locales/en.json to a new file named after its code and translate it. Keep every key: a key missing from the file shows as its name, such as ui.hint.

Open filesCopy Anchor Link

These files ship unescrowed so you can adapt them to your server: