Le ghetto des notifications
Les notifications sur la plupart des serveurs FiveM ressemblent encore à l'ESX par défaut de 2019. Une simple barre colorée en haut, parfois une icône, une ligne de texte. Les joueurs se sont entraînés à les ignorer. C'est un énorme canal gâché pour communiquer des informations importantes.
À quoi ressemblent les notifications modernes
Agency-Notify propose des notifications de type toast qui s'empilent proprement, supportent du contenu riche (icônes, images, texte multi-lignes, boutons d'action) et offrent des niveaux de gravité clairs avec des traitements visuels distincts. Success, warning, error, info — chacun a sa propre animation, sa couleur et son poids typographique.
Un regroupement qui évite le spam
Si trois notifications similaires devaient se déclencher en succession rapide, Agency-Notify les fusionne en une seule notification groupée. Fini les trois toasts identiques "Tu as gagné 500 $" qui bloquent l'écran. C'est un comportement que les joueurs attendent de n'importe quelle app moderne, et il existe enfin dans FiveM.
Une API pensée pour les développeurs
Un seul appel de fonction pour déclencher une notification depuis n'importe quel script : exports['agency-notify']:Show({title, body, icon, level, duration, actions}). Renvoie un ID que tu peux utiliser pour mettre à jour ou fermer la notification plus tard. C'est tout. Aucun couplage au framework, pas de globales magiques.
Standalone pour une bonne raison
Agency-Notify est une brique indépendante du framework. Tes scripts QBCore, tes scripts ESX et ton code custom standalone appellent tous la même API. C'est comme ça qu'on maintient un langage visuel cohérent sur un serveur, à travers des dizaines de scripts d'auteurs différents.
Installation et configuration
Agency-Notify s'installe en moins de dix minutes. Téléchargez la ressource depuis votre bibliothèque Tebex, copiez le dossier agency-notify dans le répertoire de ressources de votre serveur et ajoutez ensure agency-notify à votre server.cfg. La ressource n'a aucune dépendance de base de données — tout l'état des notifications est géré côté client en mémoire.
Une fois lancée, n'importe quel script de votre serveur peut immédiatement appeler l'API exports. Aucune configuration post-installation n'est requise pour commencer à envoyer des notifications.
Options de configuration
Ouvrez config.lua pour personnaliser les paramètres visuels et comportementaux :
- Position — coin supérieur droit (par défaut), supérieur gauche, inférieur droit ou inférieur gauche.
- Maximum visible — combien de notifications s'empilent avant que les plus anciennes soient supprimées. Défaut : 5.
- Durée par défaut — millisecondes avant la fermeture automatique. Les notifications individuelles peuvent surcharger ce paramètre.
- Style d'animation — glissement depuis la droite (défaut), fondu, ou mise à l'échelle.
- Fenêtre de regroupement — fenêtre temporelle en millisecondes pour regrouper les notifications identiques.
- Son activé — activer ou désactiver le son de notification subtil par niveau de sévérité.
Compatibilité avec les frameworks
Agency-Notify est 100% autonome. Il n'a aucune importation de framework, aucune dépendance QBCore, aucune dépendance ESX. Cela signifie qu'il fonctionne sur n'importe quel serveur FiveM quel que soit votre framework de base.
Pourquoi c'est important pour le roleplay
Les notifications sont le principal canal de retour entre les systèmes du serveur et les joueurs. Quand ce canal paraît daté ou est ignoré, la communication critique du serveur échoue silencieusement. Le système de regroupement d'Agency-Notify traite spécifiquement le problème du spam : si votre serveur déclenche trois notifications rapides pendant un braquage, les joueurs voient un message groupé plutôt que trois toasts en compétition.
Foire aux questions
Puis-je mettre à jour ou fermer une notification après son affichage ?
Oui. L'export Show() retourne un ID. Passez cet ID à exports['agency-notify']:Update(id, {body, level}) pour changer le contenu, ou à exports['agency-notify']:Dismiss(id) pour le supprimer.
Cela remplace-t-il les notifications ox_lib ?
Oui. Agency-Notify couvre les mêmes cas d'usage avec un style visuel différent. Si vous voulez l'esthétique glassmorphism cohérente avec les autres scripts Agency, le remplacement est simple.
Existe-t-il une limite de débit pour prévenir le spam de notifications ?
Le système de regroupement gère automatiquement la déduplication. Pour une limite de débit stricte, définissez Config.RateLimit = true et Config.RateLimitWindow = 1000 dans config.lua.
Comparaison avec les alternatives
Agency-Notify s'adresse aux serveurs qui se soucient de l'expérience de notification en tant que détail produit, pas en tant qu'arrière-pensée. Si vous avez déjà pensé "nos notifications semblent mauvaises et les joueurs les ignorent", c'est le problème que ce script existe pour résoudre. Les niveaux de sévérité (succès, avertissement, erreur, info) ajoutent une seconde couche de signal : les joueurs apprennent rapidement que le vert signifie bon, le rouge signifie agir maintenant.
Prérequis
- Serveur FiveM (tout framework ou autonome)
- Compte cfx.re avec clé de licence Agency-Notify valide
- Aucune dépendance de base de données
Comparaison avec les autres systèmes de notifications
De nombreux serveurs FiveM utilisent encore des notifications DrawNotification natives de GTA V. Ces popups jaunes dans le coin supérieur gauche fonctionnent, mais brisent complètement l'immersion. Elles semblent appartenir à un jeu solo, pas à un serveur RP sérieux.
D'autres ressources de notification open-source existent, mais elles nécessitent souvent une configuration importante et ne s'intègrent pas facilement avec plusieurs frameworks. Agency-Notify est conçu pour fonctionner immédiatement avec ESX, QBCore et les configurations standalone.
Personnalisation avancée
Au-delà des types de base, vous pouvez contrôler :
- Durée d'affichage — courte pour les confirmations, plus longue pour les alertes importantes
- Position à l'écran — en haut à droite, en bas à gauche, centré
- Icônes personnalisées — utilisez les icônes Font Awesome incluses ou ajoutez les vôtres
- Effets sonores — sons discrets ou alertes audibles selon l'urgence
- File d'attente des notifications — empêche le chevauchement quand plusieurs notifications arrivent en même temps
Intégration avec d'autres ressources Agency
Agency-Notify s'intègre nativement avec les autres ressources Agency Scripts. Agency-Reports l'utilise pour alerter les administrateurs des nouveaux rapports. Agency-HUD l'utilise pour les notifications de statut du personnage. Cette cohérence signifie que tous les messages système ont le même aspect visuel professionnel.
Impact sur les performances
Les ressources d'interface utilisateur peuvent parfois affecter les performances du serveur et du client. Agency-Notify est conçu pour être léger — les notifications se chargent et se déchargent efficacement, et le script ne tourne pas en boucle constante en arrière-plan. L'impact sur le tick rate client est négligeable même avec une fréquence élevée de notifications.