Agency-Notify V2 Exports & API
Sistema de notificações com estilos V1 Classic e V2 Ultra, configurações no jogo, Smart Mode com prioridade.
01Exports do cliente
| Export | Descrição |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional Smart Mode priority/duration/spam handling. |
02Eventos
| Nome | Lado | Descrição |
|---|---|---|
Agency:Notify:Send | Cliente | Ponto de entrada antigo v1 que mostra uma notificação com os mesmos dados do export. |
Agency:Notify:LoadSettings | Cliente | Aplica as definições de interface guardadas do jogador vindas do servidor (posição, cor, escala, estilo). |
Agency:Notify:SaveSettings | Servidor | Valida e guarda as definições de notificação do jogador (posição, destaque, escala, estilo). |
+Bom saber
Esta página lista os exports e eventos disponíveis para Agency-Notify, permitindo que outros recursos acionem notificações ou interajam com as configurações de notificação do jogador. Os exports e eventos são fornecidos apenas para uso no cliente, pois não há exports no servidor. A integração é simples e não requer dependências obrigatórias, embora oxmysql possa ser usado para armazenamento persistente das configurações se habilitado no config.
- Uso do Export no Cliente
- O export Notify está disponível no lado do cliente e permite exibir uma notificação V2 com suporte a recursos do Smart Mode, como prioridade inteligente, duração e proteção contra spam. Você pode passar um objeto de dados com campos como title, text, type e duration para personalizar a notificação.
- Suporte a Eventos Legados
- Agency-Notify inclui compatibilidade legada v1 através do evento client Agency:Notify:Send. Este evento aceita o mesmo payload do export Notify, facilitando a atualização de scripts antigos ou a manutenção da compatibilidade com poucas alterações.
- Eventos de Persistência de Configurações
- Dois eventos gerenciam as configurações de notificação do jogador: Agency:Notify:LoadSettings (cliente) aplica preferências de UI salvas, enquanto Agency:Notify:SaveSettings (servidor) valida e persiste configurações como posição, cor, escala e estilo. A persistência requer oxmysql e deve estar habilitada no config.
?Perguntas frequentes
Existem exports do lado servidor disponíveis no Agency-Notify?
Não, Agency-Notify fornece apenas exports do lado cliente. Todo o acionamento de notificações e gerenciamento de configurações é feito no cliente, com eventos de persistência disponíveis para salvar e carregar configurações se oxmysql estiver habilitado.
O oxmysql é necessário para o funcionamento do Agency-Notify?
oxmysql é opcional. Ele é necessário apenas se você quiser ativar a persistência no banco de dados para as configurações de notificação do jogador. Sem oxmysql, as notificações e configurações da interface funcionam normalmente, mas as configurações não serão salvas entre as sessões.
Como faço para disparar uma notificação de outro recurso?
Você pode usar o export Notify do cliente para exibir uma notificação. Passe um objeto de dados com os campos desejados (título, texto, tipo, duração, etc.). Alternativamente, use o evento client Agency:Notify:Send para compatibilidade legada com a mesma estrutura de payload.
O que devo verificar se as notificações não estiverem aparecendo?
Certifique-se de que o Agency-Notify está corretamente iniciado usando ensure Agency-Notify no seu server.cfg. Verifique se você está chamando o export ou evento do cliente com o payload de dados correto. Se estiver usando persistência, confirme que o oxmysql está instalado e habilitado na configuração.