Saltar al contenido

Lt Notify

Ver Lt Notify en la tienda →

Recurso: lt-notify. Gratis. Protegido con Asset Escrow; config.lua, locales/ y client/compat.lua quedan abiertos.

Idiomas: inglés (predeterminado), español, alemán y francés. Se elige en Config.Locale; con 'auto' sigue el idioma de tu base.

Requisitos

Ninguno. Funciona standalone y con qs-core, QBCore, Qbox, ESX y ox_lib.

Instalación

  1. Descarga el script desde Keymaster → Granted Assets con la cuenta de Cfx.re que lo consiguió.
  2. Copia la carpeta lt-notify en resources/.
  3. Añádelo al server.cfg:
ensure lt-notify

Para que el resto de tus scripts usen Lt Notify, mira Sustituir las notificaciones de tu framework.

Menú del jugador

Con /notify, cada jugador elige una posición predefinida o arrastra las notificaciones a cualquier punto de la pantalla, y escoge el sonido de cada tipo entre los que ofrece el servidor, con su volumen o silenciado. Se guarda en su propio juego.

El comando se cambia o se desactiva en Config.Command (false lo quita). Para que no puedan mover las notificaciones: Config.AllowPlayerMove = false.

Cómo enviar notificaciones

Desde el cliente

exports['lt-notify']:Notify({ type = 'success', title = 'Bank', message = 'You received **$500**' })
exports['lt-notify']:Notify('Simple message', 'error', 5000) -- short form

Desde el servidor

exports['lt-notify']:Notify(source, { type = 'info', message = 'Hello' })
exports['lt-notify']:Notify(-1, { type = 'announce', title = 'Server', message = 'Restart in 10 min' })
exports['lt-notify']:NotifyMany({ 1, 2, 3 }, 'Notice for several players', 'warning')
CampoPara qué
typeTipo de notificación (ver abajo)
titleTítulo opcional
message / descriptionTexto
durationDuración en ms
iconIcono de web/js/icons.js
colorColor en hexadecimal
soundClave de Config.Sounds, o false para ninguno
idNo repite la notificación mientras siga visible (como en ox_lib)

Tipos: success, error, info, warning, police, ems y announce. También acepta los nombres de otros scripts: inform, primary, danger, warn, ambulance…

Formato permitido: colores ~r~ ~g~ ~b~ ~y~ ~p~ ~o~ ~c~ ~w~, ~s~ (quitar color), ~n~ (salto de línea) y **negrita**. El texto nunca se interpreta como HTML, así que nadie puede inyectar código.

Sustituir las notificaciones de tu framework

Haz que tu framework llame a Lt Notify y no actives Config.Compat, o cada notificación saldrá dos veces.

  • qs-core (client/main.lua, evento qs:client:notify), primera línea del handler. Los puentes de QBCore y ESX de qs-core también pasan por aquí:
if GetResourceState('lt-notify') == 'started' then
    return exports['lt-notify']:Notify({ message = message, type = nType, duration = duration, title = title })
end
  • QBCore / Qbox: dentro de QBCore.Functions.Notify → exports['lt-notify']:Notify(text, texttype, length)
  • ESX: dentro de ESX.ShowNotification → exports['lt-notify']:Notify(message, notifyType, length)
  • ox_lib: dentro de lib.notify → exports['lt-notify']:Notify(data)

Si prefieres no tocar el framework, Config.Compat escucha sus eventos de red (qs, qbcore, esx, oxlib), pero la notificación original seguirá saliendo también.

Sonidos

Solo el servidor añade sonidos; los jugadores eligen entre ellos en /notify. En Config.Sounds cada sonido puede ser:

  • synth: tono incluido, sin archivo (chime, pop, soft, buzz, alert, bell).
  • game: sonido de GTA, { name, set }.
  • file: tu propio archivo en web/sounds/ (ogg, mp3 o wav).

Para añadir uno propio: copia el archivo a web/sounds/, añádelo a Config.Sounds (my_sound = { label = 'My sound', file = 'my_sound.ogg' }) y asígnalo a un tipo en Config.Types, o deja que los jugadores lo elijan.

Configuración

OpciónPara qué
Config.PositionsPosiciones predefinidas en % de la pantalla. Ajusta los números sin crear una nueva
Config.DefaultPositionPosición por defecto del servidor (bottom-center)
Config.DefaultDurationDuración por defecto (5000 ms)
Config.MaxVisibleMáximo a la vez (5); el resto espera en cola, con los anuncios primero
Config.GroupDuplicatesAgrupa avisos repetidos en una sola tarjeta con ×2, ×3…
Config.MaxTitleLength / Config.MaxMessageLengthLongitud máxima del título (60) y del texto (300)
Config.TypesColor, icono, sonido y duración de cada tipo. Puedes añadir los tuyos
Config.TypeAliasesNombres alternativos que usan otros scripts
Config.DefaultVolumeVolumen inicial (0.0 – 1.0)

Problemas comunes

Cada notificación sale dos veces

Tienes activado Config.Compat para un framework que ya llama a Lt Notify, o al revés: la notificación original sigue activa. Usa solo una de las dos vías de Sustituir las notificaciones.

Mis scripts siguen usando las notificaciones antiguas

Lt Notify no las sustituye solo: redirige el notify de tu framework como se explica en esta sección.

No suena un sonido propio

Comprueba que el archivo está en web/sounds/, que el nombre coincide con Config.Sounds y que el jugador no lo tiene silenciado en /notify.

Errores de Escrow (entitlement, verify, parsing)

Mira la FAQ general.

Soporte

¿No lo resuelves? Abre un ticket en nuestro Discord con la versión del script, tu framework y el error completo de la consola.