O gueto das notificações
As notificações na maioria dos servidores FiveM ainda parecem o ESX por defeito de 2019. Uma barra colorida simples no topo, talvez um ícone, uma linha de texto. Os jogadores treinaram-se a ignorá-las. É um enorme canal desperdiçado para comunicar informação importante.
O que são notificações modernas
O Agency-Notify traz notificações estilo toast que se empilham de forma limpa, suportam conteúdo rico (ícones, imagens, texto multi-linha, botões de ação) e têm níveis de severidade claros com tratamentos visuais distintos. Success, warning, error, info — cada um tem a sua própria animação, cor e peso tipográfico.
Agrupamento que evita spam
Se três notificações semelhantes fossem disparar em rápida sucessão, o Agency-Notify fá-las colapsar numa única notificação agrupada. Acabaram-se os três toasts idênticos de "Ganhaste 500 $" a bloquear o ecrã. É um comportamento que os jogadores esperam de qualquer app moderna e finalmente existe no FiveM.
API amigável para programadores
Uma chamada de função para disparar uma notificação a partir de qualquer script: exports['agency-notify']:Show({title, body, icon, level, duration, actions}). Devolve um ID que podes usar para atualizar ou dispensar a notificação mais tarde. É só isto. Sem acoplamento a framework, sem globais mágicas.
Standalone por uma razão
O Agency-Notify é um bloco de construção independente de framework. Os teus scripts QBCore, os teus scripts ESX e o teu código standalone personalizado chamam todos a mesma API. É assim que mantés a linguagem visual de um servidor coerente através de dezenas de scripts de autores diferentes.
Instalação e Configuração
A instalação do Agency-Notify é direta. Baixe o recurso do Keymaster da cfx.re, extraia para sua pasta de recursos do servidor e adicione ao seu server.cfg. Não são necessárias dependências adicionais para a funcionalidade básica.
Opções de Configuração
O arquivo de configuração principal permite personalizar o comportamento das notificações em todo o servidor:
- Posição padrão — canto superior direito, canto inferior esquerdo, centralizado no topo
- Duração padrão — por quanto tempo as notificações ficam visíveis antes de desaparecer
- Limite de fila — quantas notificações podem se acumular antes que as mais antigas sejam descartadas
- Animações — deslizar, desaparecer gradualmente ou aparecer instantaneamente
Compatibilidade com Frameworks
Agency-Notify substitui o sistema de notificações nativo no ESX e QBCore. As funções de notificação existentes são redirecionadas automaticamente através do Agency-Notify, então seus scripts existentes funcionam sem modificações.
Para servidores standalone, use os exports diretos: exports['agency-notify']:SendNotification() com os parâmetros de tipo, título e mensagem.
Por Que Isso Importa para o Roleplay
O aspecto visual das notificações define o tom de toda a experiência do servidor. As notificações nativas do GTA V parecem do modo história para um jogador, não de um mundo de RP imersivo. Agency-Notify faz com que cada alerta do sistema pareça parte do seu servidor específico.
Comparação com Alternativas
Muitos servidores FiveM ainda usam notificações nativas DrawNotification do GTA V. Esses popups amarelos funcionam, mas quebram completamente a imersão. Agency-Notify é projetado para funcionar imediatamente com ESX, QBCore e configurações standalone, sem extensas modificações.
Impacto no Desempenho
Agency-Notify é projetado para ser leve. As notificações são carregadas e descarregadas de forma eficiente, e o script não executa um loop constante em segundo plano. O impacto na taxa de ticks do cliente é insignificante mesmo com alta frequência de notificações.
Perguntas Frequentes
- Posso usar Agency-Notify com meu framework personalizado? Sim, através de exports diretos que funcionam independentemente do framework.
- As notificações persistem entre sessões? Não, as notificações são eventos temporários de interface do usuário e não são armazenados no banco de dados.
- Posso ter notificações diferentes para diferentes trabalhos? Sim, você pode passar parâmetros de estilo junto com cada notificação para personalização por evento.
Sobre o Agency Scripts
Agency Scripts é uma coleção de recursos premium do FiveM projetados para servidores de roleplay que levam a imersão a sério. Cada recurso é construído com os mesmos princípios: compatibilidade multi-framework, desempenho otimizado e configuração flexível para se adaptar a qualquer conceito de servidor.
Todos os recursos do Agency estão disponíveis através do sistema de licenças da cfx.re Keymaster. Uma vez comprado, você pode implantar o recurso em qualquer servidor que possua, com suporte ativo disponível através do Discord do Agency Scripts.
Suporte e Comunidade
A comunidade do Agency Scripts inclui milhares de servidores FiveM que usam esses recursos. O Discord oficial é onde os desenvolvedores compartilham suas configurações, fazem perguntas e sugerem novos recursos. As atualizações são regulares e incluem tanto correções de bugs quanto novos recursos baseados no feedback da comunidade.
Para dúvidas de instalação, problemas de compatibilidade ou solicitações de recursos, o Discord é o melhor canal. A documentação é mantida atualizada e cobre todas as configurações com exemplos práticos.
Requisitos do Sistema
Para usar os recursos do Agency Scripts, seu servidor FiveM precisa atender aos seguintes requisitos mínimos:
- Versão do servidor FiveM — artifact 4752 ou superior recomendado
- Framework — ESX 1.2+, QBCore (qualquer versão principal) ou configuração standalone
- Banco de dados — MariaDB ou MySQL 5.7+ com oxmysql como camada de banco de dados
- ox_lib — recomendado para elementos de UI aprimorados, nem sempre obrigatório
Os recursos do Agency Scripts são testados nos artifacts de servidor mais recentes e atualizados regularmente para acompanhar as mudanças do FiveM. As licenças são por servidor mas não têm data de expiração uma vez compradas através do Keymaster.
Por Que os Servidores Escolhem Agency Scripts
A principal razão pela qual os servidores FiveM escolhem Agency Scripts é a consistência. Quando todas as suas ferramentas vêm do mesmo fornecedor, elas têm o mesmo estilo de configuração, o mesmo suporte e o mesmo padrão de qualidade. Não há surpresas ao atualizar um recurso porque você sabe o que esperar.
Para administradores de servidor que querem passar mais tempo no roleplay e menos tempo solucionando problemas de scripts, essa consistência tem valor real. Em vez de ter dez recursos diferentes de dez desenvolvedores diferentes, todos com filosofias de design diferentes e documentação inconsistente, você tem um ecossistema coeso.
Integração Entre Recursos
Os recursos Agency são projetados para funcionar juntos. Agency-Notify é usado por Agency-Reports para alertar admins. Agency-HUD complementa Agency-Phone para uma experiência de interface unificada. Agency-Admin pode suspender jogadores que abusaram do sistema Agency-Blackmarket. Essas integrações não são acidentais — são recursos planejados que fazem o ecossistema funcionar melhor como um todo do que como partes separadas.
Quando você adiciona um novo recurso Agency a um servidor que já usa outros recursos Agency, a compatibilidade está garantida. Não é preciso testar se os eventos colidem, se as configurações do banco de dados conflitam ou se os estilos de UI são inconsistentes. Tudo se encaixa.