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.