Agency-Notify V2 Exports & API
Benachrichtigungssystem mit V1 Classic und V2 Ultra Stilen, Spieleinstellungen, Smart Mode mit Priorität, Spam-Schutz.
01Client-Exports
| Export | Beschreibung |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional Smart Mode priority/duration/spam handling. |
02Events
| Name | Seite | Beschreibung |
|---|---|---|
Agency:Notify:Send | Client | Alter v1-Einstieg, der eine Benachrichtigung mit denselben Daten wie der Export zeigt. |
Agency:Notify:LoadSettings | Client | Übernimmt die gespeicherten Oberflächeneinstellungen des Spielers vom Server (Position, Farbe, Größe, Stil). |
Agency:Notify:SaveSettings | Server | Prüft die Benachrichtigungseinstellungen des Spielers und speichert sie (Position, Akzent, Größe, Stil). |
+Gut zu wissen
Diese Seite listet die verfügbaren exports und Events für Agency-Notify auf, die es anderen Ressourcen ermöglichen, Benachrichtigungen auszulösen oder mit den Benachrichtigungseinstellungen der Spieler zu interagieren. Exports und Events sind nur für die Client-Seite verfügbar, da es keine serverseitigen exports gibt. Die Integration ist unkompliziert und erfordert keine zwingenden Abhängigkeiten, obwohl oxmysql für die persistente Speicherung der Einstellungen verwendet werden kann, wenn es in der Konfiguration aktiviert ist.
- Verwendung von Client-Exports
- Der Notify-Export ist auf der Client-Seite verfügbar und ermöglicht das Anzeigen einer V2-Benachrichtigung mit Unterstützung für Smart Mode mit Priorität, Dauer und Spam-Schutz nach festen Regeln. Sie können ein Datenobjekt mit Feldern wie title, text, type und duration übergeben, um die Benachrichtigung anzupassen.
- Unterstützung für Legacy-Events
- Agency-Notify beinhaltet Legacy-Kompatibilität der Version 1 über das Client-Event Agency:Notify:Send. Dieses Event akzeptiert die gleiche Nutzlast wie der Notify-Export, was es einfach macht, ältere Skripte zu aktualisieren oder die Abwärtskompatibilität mit minimalen Änderungen zu gewährleisten.
- Ereignisse zur Persistenz der Einstellungen
- Zwei Events verwalten die Benachrichtigungseinstellungen der Spieler: Agency:Notify:LoadSettings (Client) wendet gespeicherte UI-Präferenzen an, während Agency:Notify:SaveSettings (Server) Einstellungen wie Position, Farbe, Skalierung und Stil validiert und speichert. Persistenz erfordert oxmysql und muss in der Konfiguration aktiviert sein.
?Häufige Fragen
Gibt es serverseitige exports in Agency-Notify?
Nein, Agency-Notify bietet nur clientseitige exports. Das Auslösen von Benachrichtigungen und die Verwaltung der Einstellungen erfolgen auf dem Client, mit Persistenz-Events zum Speichern und Laden der Einstellungen, falls oxmysql aktiviert ist.
Ist oxmysql erforderlich, damit Agency-Notify funktioniert?
oxmysql ist optional. Es wird nur benötigt, wenn Sie die Datenbankpersistenz für Benachrichtigungseinstellungen der Spieler aktivieren möchten. Ohne oxmysql funktionieren Benachrichtigungen und UI-Einstellungen wie gewohnt, aber die Einstellungen werden nicht zwischen den Sitzungen gespeichert.
Wie löse ich eine Benachrichtigung aus einer anderen Ressource aus?
Sie können den Notify Client-Export verwenden, um eine Benachrichtigung anzuzeigen. Übergeben Sie ein Datenobjekt mit den gewünschten Feldern (Titel, Text, Typ, Dauer usw.). Alternativ verwenden Sie das Client-Event Agency:Notify:Send für Legacy-Kompatibilität mit derselben Payload-Struktur.
Was sollte ich überprüfen, wenn Benachrichtigungen nicht angezeigt werden?
Stellen Sie sicher, dass Agency-Notify korrekt mit ensure Agency-Notify in Ihrer server.cfg gestartet wurde. Prüfen Sie, ob Sie den Client-Export oder das Event mit der korrekten Daten-Payload aufrufen. Wenn Sie Persistenz verwenden, vergewissern Sie sich, dass oxmysql installiert und in der Konfiguration aktiviert ist.