iNotificaçãoV3

📦 Instalação de notificações

1. Arraste o iNotificationV3 pasta em seus recursos.
2. Adicione a linha ensure iNotificationV3 para o seu server.cfg.

📝 Opções de texto

1. Se você incluir ~h~ No texto, isso tornará o texto audacioso (exemplo: ~h~Trying bold text~h~).
2. Se você incluir ~i~ No texto, isso tornará o texto itálico (exemplo: ~i~Trying italic text~i~).
3. Se você incluir <br/> Em texto, isso criará um quebra de linha (exemplo: line 1<br/>line 2).

🔔 Exemplos de notificações (Cliente/Servidor)

Lado do cliente

-- showNotification
TriggerEvent("iNotificationV3:showNotification", "This is a message", 5, "left");

-- showAdvancedNotification
TriggerEvent("iNotificationV3:showAdvancedNotification", "Title", "Subtitle", "this is a message", "CHAR_MP_BIKER_BOSS", 7, "left");

-- showHelpNotification
TriggerEvent("iNotificationV3:showHelpNotification", "Press ~INPUT_PICKUP~ to ...", 10, "right");

-- showAdvancedHelpNotification
TriggerEvent("iNotificationV3:showAdvancedHelpNotification", "Interactions", "Press ~INPUT_PICKUP~ to trigger ...", "CHAR_MP_BRUCIE", 8, "left");

Lado do servidor

-- showNotification
TriggerClientEvent("iNotificationV3:showNotification", source, "This is a message", 5, "left");

-- showAdvancedNotification
TriggerClientEvent("iNotificationV3:showAdvancedNotification", source, "Title", "Subtitle", "this is a message", "CHAR_MP_BIKER_BOSS", 7, "left");

-- showHelpNotification
TriggerClientEvent("iNotificationV3:showHelpNotification", source, "Press ~INPUT_PICKUP~ to ...", 10, "right");

-- showAdvancedHelpNotification
TriggerClientEvent("iNotificationV3:showAdvancedHelpNotification", source, "Interactions", "Press ~INPUT_PICKUP~ to trigger ...", "CHAR_MP_BRUCIE", 8, "left");

⚠️ Dica: Recomendamos não modificar todas as suas notificações através do ESX.
Em vez disso, modifique-os individualmente em cada script onde aparecem para um melhor controle (posição, duração, etc.).

🧩 Modifique facilmente todas as notificações em seu framework ESX

1. Acesse a pasta ex_extended/client.
2. Abra o arquivo functions.lua.
3. Siga os passos de modificação abaixo.

🔧 Modificação

Substitua este código:

ESX.ShowNotification = function(msg)
    SetNotificationTextEntry('STRING');
    AddTextComponentString(msg);
    DrawNotification(0, 1);
end

ESX.ShowAdvancedNotification = function(sender, subject, msg, textureDict, iconType, flash, saveToBrief, hudColorIndex)
    if saveToBrief == nil then saveToBrief = true end
    AddTextEntry('esxAdvancedNotification', msg)
    BeginTextCommandThefeedPost('esxAdvancedNotification')
    if hudColorIndex then ThefeedNextPostBackgroundColor(hudColorIndex) end
    EndTextCommandThefeedPostMessagetext(textureDict, textureDict, false, iconType, sender, subject)
    EndTextCommandThefeedPostTicker(flash or false, saveToBrief)
end

ESX.ShowHelpNotification = function(msg, thisFrame, beep, duration)
    AddTextEntry('esxHelpNotification', msg)

    if thisFrame then
        DisplayHelpTextThisFrame('esxHelpNotification', false)
    else
        if beep == nil then beep = true end
        BeginTextCommandDisplayHelp('esxHelpNotification')
        EndTextCommandDisplayHelp(0, false, beep, duration or -1)
    end
end

Com este código:

ESX.ShowNotification = function(msg, time, position)
    TriggerEvent("iNotificationV3:showNotification", msg, time or 12, position or "left");
end

ESX.ShowAdvancedNotification = function(sender, subject, msg, textureDict, iconType, flash, saveToBrief, hudColorIndex)
    TriggerEvent("iNotificationV3:showAdvancedNotification", sender, subject, msg, textureDict, 12, "left")
end

ESX.ShowHelpNotification = function(msg, thisFrame, beep, duration)
    TriggerEvent("iNotificationV3:showHelpNotification", msg, 12, "left");
end

➕ Adicione notificações facilmente

showNotification

Cliente

-- message: string (message content) (⚠️ Required)
-- duration: number (seconds the notification stays visible) (❌ Optional)
-- location: string["left", "middle", "right"] (screen position) (❌ Optional)
exports["iNotificationV3"]:showNotification(message, duration, location);
-- or:
TriggerEvent("iNotificationV3:showNotification", message, duration, location);

Servidor

TriggerClientEvent("iNotificationV3:showNotification", playerId or source, message, duration, location)

showAdvancedNotification

Cliente

-- title: string (title of notification) (❌ Optional)
-- subtitle: string (subtitle) (❌ Optional)
-- message: string (message content) (⚠️ Required)
-- duration: number (display duration) (❌ Optional)
-- location: string["left", "middle", "right"] (screen position) (❌ Optional)
-- icon: string (GTA 5 notification image or custom image name from "assets/images/") (❌ Optional)

exports["iNotificationV3"]:showAdvancedNotification(title, subtitle, message, icon, duration, location);
-- or:
TriggerEvent("iNotificationV3:showAdvancedNotification", title, subtitle, message, icon, duration, location);

Servidor

local inotif = "iNotificationV3:showAdvancedNotification";
TriggerClientEvent(inotif, playerId or source, title, subtitle, message, icon, duration, location)

showHelpNotification

Cliente

exports["iNotificationV3"]:showHelpNotification(message, duration, location);
-- or:
TriggerEvent("iNotificationV3:showHelpNotification", message, duration, location);

Servidor

local inotif = "iNotificationV3:showHelpNotification";
TriggerClientEvent(inotif, playerId or source, message, duration, location)

showAdvancedHelpNotification (Pré-visualização)

Cliente

exports["iNotificationV3"]:showAdvancedHelpNotification(title, message, icon, duration, location);
-- or:
TriggerEvent("iNotificationV3:showAdvancedHelpNotification", title, message, icon, duration, location);

Servidor

local inotif = "iNotificationV3:showAdvancedHelpNotification";
TriggerClientEvent(inotif, playerId or source, title, message, icon, duration, location)

✅ Feito!
Seu arquivo foi totalmente traduzido para o inglês, preservando os blocos de código e a formatação.

Você gostaria que eu gerasse um Versão em inglês-markdown deste arquivo (readme_en.md) que você pode baixar?