Agency-Notify V2 Exports & API
Système de notification avec styles V1 Classic et V2 Ultra, paramètres en jeu, Smart Mode avec priorité intelligente.
01Exports client
| Export | Description |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional Smart Mode priority/duration/spam handling. |
02Événements
| Nom | Côté | Description |
|---|---|---|
Agency:Notify:Send | Client | Ancien point d'entrée v1 qui affiche une notification avec les mêmes données que l'export. |
Agency:Notify:LoadSettings | Client | Applique les réglages d'interface enregistrés du joueur envoyés par le serveur (position, couleur, échelle, style). |
Agency:Notify:SaveSettings | Serveur | Valide et enregistre les réglages de notification du joueur (position, accent, échelle, style). |
+Bon à savoir
Cette page liste les exports et événements disponibles pour Agency-Notify, permettant à d'autres ressources de déclencher des notifications ou d'interagir avec les paramètres de notification des joueurs. Les exports et événements sont fournis uniquement côté client, car il n'y a pas d'exports côté serveur. L'intégration est simple et ne nécessite aucune dépendance obligatoire, bien que oxmysql puisse être utilisé pour le stockage persistant des paramètres si activé dans la configuration.
- Utilisation de l'export client
- L'export Notify est disponible côté client et vous permet d'afficher une notification V2 avec prise en charge de Smart Mode, notamment la priorité intelligente, la durée et la protection contre le spam. Vous pouvez passer un objet data avec des champs comme title, text, type et duration pour personnaliser la notification.
- Support des événements legacy
- Agency-Notify inclut une compatibilité legacy v1 via l'événement client Agency:Notify:Send. Cet événement accepte la même charge utile que l'export Notify, facilitant la mise à jour des anciens scripts ou le maintien de la compatibilité avec un minimum de modifications.
- Événements de persistance des paramètres
- Deux événements gèrent les paramètres de notification des joueurs : Agency:Notify:LoadSettings (client) applique les préférences UI sauvegardées, tandis que Agency:Notify:SaveSettings (serveur) valide et persiste les paramètres tels que la position, la couleur, l'échelle et le style. La persistance nécessite oxmysql et doit être activée dans la configuration.
?Questions fréquentes
Y a-t-il des exports côté serveur disponibles dans Agency-Notify ?
Non, Agency-Notify ne fournit que des exports côté client. Tout le déclenchement des notifications et la gestion des paramètres sont effectués côté client, avec des événements de persistance disponibles pour sauvegarder et charger les paramètres si oxmysql est activé.
Est-ce que oxmysql est requis pour que Agency-Notify fonctionne ?
oxmysql est optionnel. Il est uniquement nécessaire si vous souhaitez activer la persistance en base de données pour les paramètres de notification des joueurs. Sans oxmysql, les notifications et les paramètres de l'interface fonctionnent normalement, mais les paramètres ne seront pas sauvegardés entre les sessions.
Comment déclencher une notification depuis une autre ressource ?
Vous pouvez utiliser l'export client Notify pour afficher une notification. Passez un objet data avec les champs souhaités (title, text, type, duration, etc.). Alternativement, utilisez l'événement client Agency:Notify:Send pour la compatibilité legacy avec la même structure de données.
Que dois-je vérifier si les notifications n'apparaissent pas ?
Assurez-vous que Agency-Notify est correctement démarré en utilisant ensure Agency-Notify dans votre server.cfg. Vérifiez que vous appelez l'export client ou l'événement avec la bonne charge utile. Si vous utilisez la persistance, vérifiez que oxmysql est installé et activé dans la configuration.