Lt Notify
Recurso: lt-notify. Gratis. Protegido con Asset Escrow; config.lua, locales/ y client/compat.lua quedan abiertos.
Changelog: novedades de cada versión →
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
- Descarga el script desde Keymaster → Granted Assets con la cuenta de Cfx.re que lo consiguió.
- Copia la carpeta
lt-notifyenresources/. - 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')
| Campo | Para qué |
|---|---|
type | Tipo de notificación (ver abajo) |
title | Título opcional |
message / description | Texto |
duration | Duración en ms |
icon | Icono de web/js/icons.js |
color | Color en hexadecimal |
sound | Clave de Config.Sounds, o false para ninguno |
id | No 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, eventoqs: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 enweb/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ón | Para qué |
|---|---|
Config.Positions | Posiciones predefinidas en % de la pantalla. Ajusta los números sin crear una nueva |
Config.DefaultPosition | Posición por defecto del servidor (bottom-center) |
Config.DefaultDuration | Duración por defecto (5000 ms) |
Config.MaxVisible | Máximo a la vez (5); el resto espera en cola, con los anuncios primero |
Config.GroupDuplicates | Agrupa avisos repetidos en una sola tarjeta con ×2, ×3… |
Config.MaxTitleLength / Config.MaxMessageLength | Longitud máxima del título (60) y del texto (300) |
Config.Types | Color, icono, sonido y duración de cada tipo. Puedes añadir los tuyos |
Config.TypeAliases | Nombres alternativos que usan otros scripts |
Config.DefaultVolume | Volumen 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.