Agency-Notify Exports & API
Sistema de notificaciones con estilos V1 Classic y V2 Ultra, ajustes dentro del juego, prioridad inteligente AgencyAI.
01Client Exports
| Export | Descripción |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02Eventos
| Nombre | Lado | Descripción |
|---|---|---|
Agency:Notify:Send | Client | Legacy v1 entry point to display a notification with the same payload as the export. |
Agency:Notify:LoadSettings | Client | Applies per-player saved UI settings (position, color, scale, style) from the server. |
Agency:Notify:SaveSettings | Server | Validates and persists the player's notify settings (position, accent, scale, style). |
+Conviene saber
Esta página lista los exports y eventos disponibles para Agency-Notify, permitiendo que otros recursos activen notificaciones o interactúen con la configuración de notificaciones del jugador. Los exports y eventos están disponibles solo del lado del cliente, ya que no hay exports del lado del servidor. La integración es sencilla y no requiere dependencias obligatorias, aunque oxmysql puede usarse para almacenamiento persistente si está habilitado en la configuración.
- Uso del export en el cliente
- El export Notify está disponible del lado del cliente y te permite mostrar una notificación V2 con soporte para funciones de AgencyAI, como prioridad inteligente, duración y protección contra spam. Puedes pasar un objeto de datos con campos como title, text, type y duration para personalizar la notificación.
- Soporte para eventos heredados
- Agency-Notify incluye compatibilidad heredada v1 mediante el evento cliente Agency:Notify:Send. Este evento acepta la misma carga útil que el export Notify, facilitando la actualización de scripts antiguos o mantener compatibilidad hacia atrás con cambios mínimos.
- Eventos de persistencia de configuración
- Dos eventos gestionan la configuración de notificaciones del jugador: Agency:Notify:LoadSettings (cliente) aplica las preferencias de UI guardadas, mientras que Agency:Notify:SaveSettings (servidor) valida y persiste configuraciones como posición, color, escala y estilo. La persistencia requiere oxmysql y debe estar habilitada en la configuración.
?Preguntas frecuentes
¿Existen exports del lado del servidor disponibles en Agency-Notify?
No, Agency-Notify solo proporciona exports del lado del cliente. Toda la activación de notificaciones y gestión de configuraciones se maneja en el cliente, con eventos de persistencia disponibles para guardar y cargar configuraciones si oxmysql está habilitado.
¿Es oxmysql obligatorio para que funcione Agency-Notify?
oxmysql es opcional. Solo se necesita si desea habilitar la persistencia en la base de datos para la configuración de notificaciones de los jugadores. Sin oxmysql, las notificaciones y la configuración de la interfaz funcionan con normalidad, pero la configuración no se guardará entre sesiones.
¿Cómo puedo activar una notificación desde otro recurso?
Puede usar el export Notify del cliente para mostrar una notificación. Pase un objeto de datos con los campos deseados (título, texto, tipo, duración, etc.). Alternativamente, use el evento cliente Agency:Notify:Send para compatibilidad heredada con la misma estructura de datos.
¿Qué debo verificar si las notificaciones no aparecen?
Asegúrese de que Agency-Notify esté iniciado correctamente usando ensure Agency-Notify en su server.cfg. Verifique que esté llamando al export o evento cliente con la carga de datos correcta. Si usa persistencia, confirme que oxmysql esté instalado y habilitado en la configuración.