Zum Hauptinhalt springen

Basisalarme

Diese Seite erklärt, wie Basisalarme in dzbot funktionieren, wie Benachrichtigungen gesendet werden und welche Rechte für Mitarbeiter und Spieler benötigt werden.

Was ein Basisalarm macht​

Ein Basisalarm überwacht eine konfigurierte Position und einen Radius.

  • Wenn relevante Spieleraktivitäten in diesem Bereich stattfinden, wird eine Benachrichtigung gesendet.
  • Benachrichtigungen gehen entweder an Direktnachrichten (DM-Modus) oder einen dedizierten Discord-Kanal (Kanalmodus).
  • Basisalarme können einem Spieler oder einer Fraktion gehören.

Kernlebenszyklus​

Basisalarme werden in der Regel nach diesem Lebenszyklus verwaltet:

  1. Alarm erstellen (persönlich oder fraktionsbezogen).
  2. Position festlegen/überprüfen und Radius-Verhalten verifizieren.
  3. Empfänger definieren (Besitzer, Fraktionsmitglieder und optionale zusätzliche Spieler).
  4. Alarm aktiv halten und finanzieren.
  5. Kürzliche Alarmchronik überprüfen und bei Bedarf anpassen.

Standards für Positionen stammen aus dem Gameplay-Kontext:

  • Persönliche Alarme versuchen, von der zuletzt gehissten Flaggenposition vorabzufüllen.
  • Fraktionsalarme versuchen, von den Fraktions-Spawn-Koordinaten vorabzufüllen.

Der Radius ist für normale Shop-erstellte Alarme festgelegt; Admins können den Radius im Admin-Basisalarm-Bearbeitungsbereich überschreiben.

Trigger- und Empfängermodell​

Auslösebedingungen​

Ein Alarm wird nur für Benachrichtigungen berücksichtigt, wenn alle diese Bedingungen erfüllt sind:

  • Alarm ist aktiv.
  • Alarm liegt im Bereich der Ereignisposition.
  • Alarm ist bezahlt (oder als kostenlos konfiguriert).

Hinweis zur Datenaktualität: Triggerchroniken und Kontexte zu nahegelegenen Aktivitäten hängen von importierten Server-Logs ab und können mit Verzögerung angezeigt werden (siehe Logs-Import).

Wer Benachrichtigungen erhält​

Empfänger basieren auf Alarmeigentum und -freigaben:

  • Persönlicher Alarmbesitzer
  • Manuell hinzugefügte Spieler (nur Benachrichtigungsempfänger)
  • Alle Mitglieder der verknüpften Fraktion (bei Fraktionsalarmen)

Deaktivierte Benutzer sind von der DM-Zustellung ausgeschlossen.

Im Shop-UI erhalten manuell hinzugefügte Spieler bei persönlichen Alarmen Benachrichtigungen, jedoch keinen Verwaltungszugriff auf diese Alarminformationen.

Wer keinen Alarm auslöst​

Das System schließt berechtigte Spieler und ihre verknüpften Geräte-Spieler von Triggerbenachrichtigungen aus. Dies vermeidet Selbst-Alarmlärm von Besitzern/Mitgliedern und ihren verknüpften Konten.

Bezahlmodell​

Basisalarme können kostenlos oder kostenpflichtig sein, abhängig von den Servereinstellungen.

  • Kostenpflichtige Alarme werden regelmäßig in Rechnung gestellt.
  • Spielergebundene Alarme versuchen zuerst, einen BaseAlarmCoupon des Spielers zu verbrauchen, bevor Guthaben belastet wird.
  • Fraktionsgebundene Alarme versuchen zuerst passende Gutscheine von Fraktionsmitgliedern zu verbrauchen, die deren Besitzer ausdrücklich für Fraktions-Basisalarme freigegeben haben.
  • Wenn mehrere Spieler-Gutscheine verfügbar sind, wird zuerst der mit der kleinsten Restanzahl verbraucht.
  • Wenn mehrere fraktionsfähige Gutscheine verfügbar sind, wird zuerst der mit der größten Restanzahl verbraucht.
  • Bei Zahlungsfehlern wird der Alarm automatisch deaktiviert.
  • Deaktivierte Alarme senden keine Benachrichtigungen, bis sie reaktiviert werden.

Für das breitere Wirtschaftskonzept siehe Transaktionen Konzept.

Benachrichtigungsmodi​

DM-Modus​

Wenn kein dedizierter Discord-Kanal festgelegt ist, erhalten berechtigte Empfänger Direktbenachrichtigungen.

Kanalmodus​

Wenn ein Kanal zugewiesen ist, werden Warnungen stattdessen an diesen Kanal gesendet.

Bei aktiver automatischer Kanalverwaltung kann dzbot Kanäle und Berechtigungen für den Alarmkontext erstellen/aktualisieren.

Hinweis: Stummschaltung ist spezifisch für DMs. Im Kanalmodus werden Warnungen im Kanal gepostet.

Rechte-Modell​

Basisalarme verwenden serverweite Rechte sowie optionale Fraktionsmitgliedsrechte.

Serverweite Basisalarmrechte​

  • base_alarm.access: Spielerbezogene Basisalarme-Seiten öffnen und nutzen.
  • base_alarm.access_all: Vollständige Admin-Übersicht und breite Sichtbarkeit.
  • base_alarm.create: Basisalarme aus Admin-Workflows erstellen.
  • base_alarm.edit: Normalen Eigentumseinschränkungen zur Bearbeitung umgehen.
  • base_alarm.delete: Alarme aus dem Adminbereich entfernen.

Verwandte Rechte im Fraktionskontext​

  • factions.access_all: Breiter Zugriff auf Fraktionsarbeitsbereiche.
  • Fraktionsmitgliedsrecht change_base_alarm: Ermöglicht Mitgliedern das Verwalten von Änderungen an Fraktionsalarmen.

Die Selbstbedienungserstellung von Spieler-/Fraktionsalarmen im Shop verwendet base_alarm.access (plus Fraktionsmitgliedschaftsberechtigungen, falls zutreffend).

Die Verwaltung von Fraktionsalarmen in Shop-Detailansichten hängt weiterhin von Fraktionsmitgliedschaftsüberprüfungen ab, es sei denn, base_alarm.edit ist gewährt.

Leitfaden für Adminrechtezuweisung​

Empfohlene praktische Bundles:

  • Spieler-Selbstbedienung: base_alarm.access
  • Fraktionsoperator: base_alarm.access + Fraktionsmitgliedsrecht change_base_alarm
  • Moderator (Fokus auf Lesen): base_alarm.access_all
  • Alarmmanager: base_alarm.access_all, base_alarm.create, base_alarm.edit
  • Volle Admin-Kontrolle: Füge base_alarm.delete hinzu.

Wenn Mitarbeiter Fraktionsalarme ohne Fraktionsmitgliedschaft verwalten müssen, verwende Admin-Basisalarm-Workflows mit base_alarm.access_all und base_alarm.edit. factions.access_all gewährt allein keinen vollständigen Zugriff auf Shop-Details für Fraktionsalarme.

Wo Benutzer mit Basisalarmen interagieren​

Spielerbezogene Ansichten sind dokumentiert unter Basisalarme in der Spielansicht.

Verwandte Dokumentation​