Docs /Ultra HUD/Exports & Events
v1.0.0

Exports & Events — foltone_ultra_hud

Client Exports

Notify

Send a simple notification (no image).

exports.foltone_ultra_hud:Notify(message, type, duration)
ParameterTypeRequiredDescription
messagestringyesNotification text
typestringno"success", "error", "warning", "info" (default: neutral)
durationnumbernoDuration in ms (default: 5000)

Example:

exports.foltone_ultra_hud:Notify("You received $500", "success")
exports.foltone_ultra_hud:Notify("Access denied", "error", 3000)

AdvancedNotify

Send a notification with an image (GTA-style).

exports.foltone_ultra_hud:AdvancedNotify(image, title, message, subtitle, duration)
ParameterTypeRequiredDescription
imagestringyesImage URL or path
titlestringyesBold title text
messagestringyesMessage body
subtitlestringnoSmaller subtitle below the title
durationnumbernoDuration in ms (default: 5000)

Example:

exports.foltone_ultra_hud:AdvancedNotify(
    "https://i.imgur.com/example.png",
    "LESTER CREST",
    "I have a job for you. Come see me.",
    "New mission",
    7000
)

ShowHud / HideHud

Show or hide the entire HUD.

exports.foltone_ultra_hud:ShowHud()
exports.foltone_ultra_hud:HideHud()

Example:

-- Hide HUD during a cutscene
exports.foltone_ultra_hud:HideHud()
Wait(5000)
exports.foltone_ultra_hud:ShowHud()

Client Events

foltone_ultra_hud:notify

Simple notification via event (usable from client or triggered from server).

-- Client-side
TriggerEvent("foltone_ultra_hud:notify", message, type, duration)

-- Server-side (to a specific player)
TriggerClientEvent("foltone_ultra_hud:notify", source, message, type, duration)

-- Server-side (to all players)
TriggerClientEvent("foltone_ultra_hud:notify", -1, message, type, duration)

foltone_ultra_hud:advancedNotify

Advanced notification via event.

-- Client-side
TriggerEvent("foltone_ultra_hud:advancedNotify", image, title, message, subtitle, duration)

-- Server-side
TriggerClientEvent("foltone_ultra_hud:advancedNotify", source, image, title, message, subtitle, duration)

foltone_ultra_hud:enableHud / foltone_ultra_hud:disableHud

Show or hide the HUD via events (useful for server-side control).

-- Server-side: hide HUD for a player
TriggerClientEvent("foltone_ultra_hud:disableHud", source)

-- Server-side: show HUD for a player
TriggerClientEvent("foltone_ultra_hud:enableHud", source)

Notification Types

TypeColorIconUse case
(none)WhiteNoneGeneral messages
"success"GreenCheckmarkConfirmations, completed actions
"error"RedCrossErrors, denied actions
"warning"YellowTriangleWarnings, important notices
"info"BlueInfo circleInformational messages

Test Command

Use /testnotif to test notifications in-game:

/testnotif all       -- Send all notification types
/testnotif simple    -- Neutral notification
/testnotif success   -- Success notification
/testnotif error     -- Error notification
/testnotif warning   -- Warning notification
/testnotif info      -- Info notification
/testnotif advanced  -- Advanced notification with image