El gueto de las notificaciones
Las notificaciones en la mayoría de servidores FiveM todavía se ven como el ESX por defecto de 2019. Una barra de color en la parte superior, quizás un icono, una línea de texto. Los jugadores se han entrenado a ignorarlas. Es un enorme canal desperdiciado para comunicar información importante.
Cómo son las notificaciones modernas
Agency-Notify trae notificaciones tipo toast que se apilan de forma limpia, soportan contenido enriquecido (iconos, imágenes, texto multilínea, botones de acción) y tienen niveles de severidad claros con tratamientos visuales distintos. Success, warning, error, info — cada uno tiene su propia animación, color y peso tipográfico.
Agrupación que evita el spam
Si tres notificaciones similares fueran a dispararse en rápida sucesión, Agency-Notify las colapsa en una sola notificación agrupada. Se acabaron los tres toasts idénticos de "Has ganado 500 $" bloqueando la pantalla. Es un comportamiento que los jugadores esperan de cualquier app moderna y por fin existe en FiveM.
Una API amigable para desarrolladores
Una llamada a función para lanzar una notificación desde cualquier script: exports['agency-notify']:Show({title, body, icon, level, duration, actions}). Devuelve un ID que puedes usar para actualizar o descartar la notificación después. Eso es todo. Sin acoplamiento al framework, sin globales mágicas.
Standalone por una razón
Agency-Notify es un bloque de construcción independiente del framework. Tus scripts QBCore, tus scripts ESX y tu código standalone personalizado llaman todos a la misma API. Así es como mantienes coherente el lenguaje visual de un servidor a través de decenas de scripts de distintos autores.
Instalación y Configuración
La instalación de Agency-Notify es directa. Descarga el recurso desde Keymaster de cfx.re, descomprímelo en tu carpeta de recursos del servidor y agrégalo a tu server.cfg. No se requieren dependencias adicionales para la funcionalidad básica.
Opciones de Configuración
El archivo de configuración principal te permite personalizar el comportamiento de las notificaciones en todo el servidor:
- Posición predeterminada — arriba a la derecha, abajo a la izquierda, centrado en la parte superior
- Duración predeterminada — cuánto tiempo permanecen visibles las notificaciones antes de desaparecer
- Límite de cola — cuántas notificaciones pueden acumularse antes de que las más antiguas sean descartadas
- Animaciones — deslizar, desvanecerse, o aparecer de manera instantánea
Compatibilidad con Frameworks
Agency-Notify reemplaza el sistema de notificaciones nativo en ESX y QBCore. Las funciones de notificación existentes (ESX.ShowNotification, QBCore.Functions.Notify) se redirigen automáticamente a través de Agency-Notify, por lo que tus scripts existentes funcionan sin modificaciones.
Para servidores standalone, usa los exports directos: exports['agency-notify']:SendNotification() con los parámetros de tipo, título y mensaje.
Por Qué Esto Importa para el Roleplay
El aspecto visual de las notificaciones establece el tono de toda la experiencia del servidor. Las notificaciones nativas de GTA V parecen del modo historia para un solo jugador, no de un mundo RP inmersivo. Agency-Notify hace que cada alerta del sistema se sienta parte de tu servidor específico, no un juego genérico.
Comparación con Alternativas
Muchos servidores FiveM todavía usan notificaciones DrawNotification nativas de GTA V. Estas ventanas emergentes amarillas funcionan, pero rompen completamente la inmersión. Agency-Notify está diseñado para funcionar inmediatamente con ESX, QBCore y configuraciones standalone, sin modificaciones extensas.
Impacto en el Rendimiento
Agency-Notify está diseñado para ser ligero. Las notificaciones se cargan y descargan de manera eficiente, y el script no ejecuta un bucle constante en segundo plano. El impacto en la tasa de ticks del cliente es insignificante incluso con alta frecuencia de notificaciones.
Preguntas Frecuentes
- ¿Puedo usar Agency-Notify con mi framework personalizado? Sí, a través de exports directos que funcionan independientemente del framework.
- ¿Las notificaciones persisten entre sesiones? No, las notificaciones son eventos de interfaz de usuario temporales y no se almacenan en la base de datos.
- ¿Puedo tener notificaciones diferentes para diferentes trabajos? Sí, puedes pasar parámetros de estilo junto con cada notificación para personalización por evento.
Acerca de Agency Scripts
Agency Scripts es una colección de recursos premium de FiveM diseñados para servidores de roleplay que se toman en serio la inmersión. Cada recurso está construido con los mismos principios: compatibilidad multi-framework, rendimiento optimizado y configuración flexible para adaptarse a cualquier concepto de servidor.
Todos los recursos de Agency están disponibles a través del sistema de licencias de cfx.re Keymaster. Una vez comprado, puedes desplegar el recurso en cualquier servidor que poseas, con soporte activo disponible a través del Discord de Agency Scripts.
Soporte y Comunidad
La comunidad de Agency Scripts incluye miles de servidores de FiveM que utilizan estos recursos. El Discord oficial es donde los desarrolladores comparten sus configuraciones, hacen preguntas y sugieren nuevas características. Las actualizaciones son regulares e incluyen tanto correcciones de errores como nuevas características basadas en los comentarios de la comunidad.
Para preguntas de instalación, problemas de compatibilidad o solicitudes de características, Discord es el mejor canal. La documentación se mantiene actualizada y cubre todas las configuraciones con ejemplos prácticos. También hay una wiki comunitaria activa con guías contribuidas por los propios operadores de servidores.
Por Qué los Servidores Eligen Agency Scripts
La razón principal por la que los servidores de FiveM eligen Agency Scripts es la consistencia. Cuando todas tus herramientas vienen del mismo proveedor, tienen el mismo estilo de configuración, el mismo soporte y el mismo estándar de calidad. No hay sorpresas al actualizar un recurso porque saben qué esperar. Para los administradores de servidores que quieren pasar más tiempo en el roleplay y menos en solucionar problemas de scripts, esa consistencia tiene un valor real.
Requisitos del Sistema
Para usar los recursos de Agency Scripts, tu servidor FiveM necesita cumplir con los siguientes requisitos mínimos:
- Versión de servidor FiveM — artifact 4752 o superior recomendado
- Framework — ESX 1.2+, QBCore (cualquier versión principal), o configuración standalone
- Base de datos — MariaDB o MySQL 5.7+ con oxmysql como capa de base de datos
- ox_lib — recomendado para elementos UI mejorados, no siempre obligatorio
Los recursos de Agency Scripts están probados en los artifacts de servidor más recientes y se actualizan regularmente para mantenerse al día con los cambios de FiveM. Si usas un artifact particularmente antiguo y encuentras problemas, actualizar el servidor suele ser el primer paso de diagnóstico.
Licencias y Keymaster
Como todos los recursos premium de FiveM, los recursos de Agency Scripts se licencian a través del sistema Keymaster de cfx.re. Compras el recurso en el Tebex de Agency Scripts, luego aparece en tu cuenta de Keymaster donde puedes vincularlo a los identificadores de tu servidor. Las licencias son per-servidor pero no tienen fecha de caducidad una vez compradas.