Configuration
Every option in Universal UI's shared/config.lua.
Every setting below lives in shared/config.lua, which stays readable in the escrowed release. Restart universal_ui after changing it. These are the defaults shipped with version 1.1.0.
Config.Theme
Theme defaults: mirrors the CSS token table 1:1 (web/src/styles/tokens.css). Every key here is applied to the NUI at startup and can be patched at runtime via exports.universal_ui:setTheme() or the live theme editor.
Config.Theme = {
accent = '#d9a441',
accentGlow = 'rgba(217, 164, 65, 0.4)',
glassPanel = 'rgba(10, 10, 12, 0.72)',
glassCard = 'rgba(255, 255, 255, 0.035)',
glassOverlay = 'rgba(7, 7, 9, 0.84)',
glassBorder = 'rgba(255, 255, 255, 0.12)',
glassHighlight = 'rgba(255, 252, 240, 0.2)',
-- Semantic colors (hex only - alpha families derive automatically)
success = '#4cd964',
danger = '#ff453a',
warning = '#ff9f0a',
info = '#5ac8fa',
-- Base text color (hex only - muted/faint derive automatically)
textColor = '#ffffff',
fontUi = "'Lexend', sans-serif",
radiusScale = 1.0, -- 0 = sharp, 1 = default, >1 = softer
blurOverlay = 20, -- px; small floating elements only
-- Performance mode: freezes the animated orbit borders and disables
-- backdrop blur. For weak clients / large servers chasing frames.
performanceMode = false,
-- UI 3D mode: notifications, text UI, and the task guide render as
-- perspective-tilted holographic planes that sway with the camera
-- (ZSX-style "3D" HUD - pure CSS, no DUI cost).
ui3d = true,
-- Center layout: cluster those 3D surfaces around the CHARACTER
-- (mid-screen columns) instead of the screen edges.
ui3dCenter = true,
-- Placement of the text UI default stack and the task guide. 'default'
-- keeps the stock anchors; the theme editor's "Drag to place" mode saves
-- 'x,y' viewport percentages here (e.g. '85,50').
textuiPosition = 'default',
guidePosition = 'default',
}Config.Notify
Config.Notify = {
defaultDuration = 3000,
position = 'top-right',
}Config.Progress
Config.Progress = {
-- Control pressed to cancel a cancellable progress action.
-- 73 = INPUT_VEH_DUCK (keyboard X). https://docs.fivem.net/docs/game-references/controls/
cancelControl = 73,
}Config.Locale
Every player-facing string the NUI renders. Translate freely - keys are stable. Sent to the NUI on startup; scripts can override at runtime with exports.universal_ui:setLocale({ confirm = '...' }).
Config.Locale = {
confirm = 'Confirm',
cancel = 'Cancel',
input = 'Input',
alert = 'Alert',
interact = 'Interact',
more = 'More',
select = 'select',
close = 'close',
back = 'back',
to = 'to',
fillRequired = 'Fill the required fields',
guide = 'Guide',
holdOn = 'Hold on',
mash = 'Mash',
memorize = 'Memorize',
repeatIt = 'Repeat the sequence',
typeIt = 'Type the word',
}