Skip to content
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Server-Tag-Rollen

Belohne Benutzer mit Rollen, die den Tag deines Servers tragen.

<ModuleOverview moduleName="guild-tag-roles" />

## Funktionen {#features}

- Weise Benutzern, die den Server-Tag deines Servers ausgerüstet haben und anzeigen lassen, automatisch Rollen zu.
- Entferne die zugewiesenen Rollen automatisch, wenn ein Benutzer das Server-Tag ablegt oder ausblendet.
- Echtzeit-Erkennung über User-Update-Events, sobald Discord Änderungen am Server-Tag erkennt.
- Regelmäßiger vollständiger Sync alle 3 Stunden, um verpasste Änderungen zu erfassen.

## Einrichtung {#setup}

1. Stelle sicher, dass dein Server in den Discord-Servereinstellungen ein Server-Tag eingerichtet hat.
2. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=guild-tag-roles) auf deinem Server.
3. Öffne die [Modul-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=guild-tag-roles%7Cconfig) und füge die Rollen hinzu, die Benutzern mit ausgerüstetem Server-Tag zugewiesen werden sollen.
4. Stelle sicher, dass der Bot über die Berechtigung **Rollen verwalten** verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest.

## Nutzung {#usage}

Einmal konfiguriert, arbeitet das Modul automatisch. Wenn ein Benutzer das Server-Tag deines Servers ausrüstet oder ablegt, versucht der Bot, die konfigurierten Rollen in Echtzeit zuzuweisen oder zu entfernen. Zusätzlich wird beim Bot-Start sowie alle 3 Stunden ein vollständiger Sync aller Mitglieder durchgeführt, um sicherzustellen, dass die Rollen korrekt bleiben.

## Konfiguration {#configuration}

Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=guild-tag-roles%7Cconfig).

| Feld | Beschreibung |
| ----- | --------------------------------------------------------------------------------- |
| Rollen | Rollen, die Benutzern zugewiesen werden sollen, die das Server-Tag deines Servers ausgerüstet haben und anzeigen lassen. |

## Fehlerbehebung {#troubleshooting}

- **Rollen werden nicht zugewiesen**: Stelle sicher, dass der Bot über die Berechtigung "Rollen verwalten" verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest. Überprüfe außerdem, ob der Benutzer das Server-Tag sowohl ausgerüstet als auch auf "sichtbar" gestellt hat.
- **Rollen werden nicht sofort aktualisiert**: Die Echtzeit-Erkennung hängt davon ab, dass Discord Daten zum Server-Tag in User-Update-Events sendet. Falls eine Änderung nicht sofort erfasst wird, korrigiert der regelmäßige Sync (alle 3 Stunden) dies nach.
- **Das Modul scheint Änderungen am Server-Tag nicht zu erkennen**: Stelle sicher, dass für deinen Discord-Server in den Server-Einstellungen tatsächlich ein Server-Tag konfiguriert wurde. Der Bot prüft, ob der primäre Server des Benutzers mit deinem Server übereinstimmt.
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Automatisches Reagieren

Reagiert automatisch mit ausgewählten Emojis in ausgewählten Kanälen oder wenn ein Benutzer markiert wird.

<ModuleOverview moduleName="auto-react" />

## Funktionen {#features}

- Reagiert in konfigurierten Kanälen oder Kategorien automatisch mit festgelegten Emojis auf jede Nachricht.
- Reagiert auf Nachrichten, wenn ein bestimmter Benutzer erwähnt wird (per @mention).
- Reagiert auf Nachrichten von bestimmten Benutzern (Autoren) oder Benutzern mit bestimmten Rollen.
- Antwortet automatisch mit einer konfigurierten Nachricht, wenn ein bestimmter Benutzer erwähnt wird.
- Unterstützung für mehrere Emojis pro Trigger (getrennt durch `|`).
- Option, nur auf direkte @Erwähnungen oder auch auf Erwähnungen in Antworten zu reagieren.

## Einrichtung {#setup}

1. Aktiviere das Modul in deinem [SCNX-Dashboard](https://scnx.app/de/glink?page=bot/modules?query=auto-react&ref=scnx-app-docs).
2. Konfiguriere das Modul wie im [Abschnitt Konfiguration](#configuration) beschrieben, um deine Reaktionen und Antworten einzurichten.
3. Der Bot benötigt die Berechtigung "Reaktionen hinzufügen" in jedem Kanal, in dem er reagieren soll.

## Nutzung {#usage}

Sobald das Modul konfiguriert ist, arbeitet es automatisch ohne jegliche Benutzerinteraktion. Wenn eine Nachricht gesendet wird, prüft der Bot die folgenden Trigger nacheinander und reagiert entsprechend:

- Wenn die Nachricht in einem konfigurierten **Kanal** gesendet wird, reagiert der Bot mit den festgelegten Emojis.
- Wenn die Nachricht in einem Kanal innerhalb einer konfigurierten **Kategorie** gesendet wird, reagiert der Bot mit den festgelegten Emojis.
- Wenn der Autor der Nachricht eine konfigurierte **Rolle** hat, reagiert der Bot mit den festgelegten Emojis.
- Wenn die Nachricht von einem konfigurierten **Autor** gesendet wird, reagiert der Bot mit den festgelegten Emojis.
- Wenn ein konfigurierter **Benutzer in der Nachricht erwähnt wird**, reagiert der Bot mit den festgelegten Emojis.
- Wenn ein konfigurierter **Benutzer erwähnt wird** und eine Antwort konfiguriert ist, antwortet der Bot mit der festgelegten Nachricht.

## Konfiguration {#configuration}

### Konfiguration {#config-main}

In dieser Konfigurationsdatei kannst du automatische Reaktionen konfigurieren. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=auto-react%7Cconfigs/config).

| Feld | Beschreibung |
|-------|-------------|
| Kanäle | Füge Kanäle und die Emojis hinzu, mit denen der Bot auf jede Nachricht reagieren soll. Mehrere Emojis können mit `\|` getrennt werden. |
| Erwähnungen | Füge Benutzer und die Emojis hinzu, mit denen der Bot reagieren soll, wenn sie erwähnt werden. Mehrere Emojis können mit `\|` getrennt werden. |
| Rollen | Füge Rollen hinzu. Wenn ein Benutzer mit einer dieser Rollen eine Nachricht sendet, reagiert der Bot mit den konfigurierten Emojis. Mehrere Emojis können mit `\|` getrennt werden. |
| Autoren | Füge Benutzer und die Emojis hinzu, mit denen der Bot auf deren Nachrichten reagieren soll. Mehrere Emojis können mit `\|` getrennt werden. |
| Kategorien | Füge Kategorien und die Emojis hinzu, mit denen der Bot auf jede Nachricht in Kanälen dieser Kategorie reagieren soll. Mehrere Emojis können mit `\|` getrennt werden. |
| Nur auf @Erwähnungen reagieren? | Wenn aktiviert, reagiert der Bot nur auf direkte @Erwähnungen. Wenn deaktiviert, reagiert der Bot auch auf Erwähnungen in Antworten oder andere Arten von Erwähnungen. |

### Antworten {#config-replies}

In dieser Konfigurationsdatei kannst du automatische Antworten auf Erwähnungen von Benutzern konfigurieren. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=auto-react%7Cconfigs/replies).

| Feld | Beschreibung |
|-------|-------------|
| Nutzer | Der Benutzer, dessen Erwähnung die Antwort auslösen soll. |
| Antwort | Die Antwortnachricht, die der Bot sendet, wenn der konfigurierte Benutzer erwähnt wird. |

## Fehlerbehebung {#troubleshooting}

<details>
<summary>Der Bot reagiert nicht auf Nachrichten</summary>
<ul>
<li>Stelle sicher, dass der Bot die Berechtigung "Reaktionen hinzufügen" in dem Kanal hat.</li>
<li>Stelle sicher, dass die Emojis gültig sind. Wenn benutzerdefinierte Emojis verwendet werden, muss der Bot Zugriff darauf haben.</li>
<li>Vergewissere dich, dass die korrekten Kanal-, Benutzer- oder Rollen-IDs konfiguriert sind.</li>
</ul>
</details>
<details>
<summary>Der Bot reagiert nicht auf Erwähnungen in Antworten</summary>
<ul>
<li>Standardmäßig reagiert der Bot nur auf direkte @Erwähnungen. Deaktiviere die Option "Nur auf @Erwähnungen reagieren?", um auch auf Erwähnungen in Antworten zu reagieren.</li>
</ul>
</details>
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
# Zähl-Spiel
Comment thread
Timon611 marked this conversation as resolved.

Ermögliche es deinen Benutzern, gemeinsam zu zählen.

<ModuleOverview moduleName="counter" />

## Funktionen {#features}

- Bestimme einen oder mehrere Kanäle als Zählkanäle, in denen Benutzer gemeinsam zählen.
- Konfigurierbare Erfolgsreaktionen und optionale Zahlen-Easter-Eggs bei speziellen Zahlen.
- Unterstützung für mathematische Ausdrücke (z. B. `2+3` für 5) und Text neben Zahlen.
- Meilensteine, die Benutzer mit Rollen oder Nachrichten belohnen, nachdem sie eine bestimmte Anzahl von Malen gezählt haben.
- Schutz gegen das Löschen von Nachrichten, um Schwindeln zu verhindern.
- Konfigurierbares Strike-System, das Benutzer einschränkt, die wiederholt falsche Nachrichten senden.
- Optionaler Neustart des Spiels, wenn ein Benutzer sich verzählt.

## Einrichtung {#setup}

1. Aktiviere das Modul in [deinem SCNX-Dashboard](https://scnx.app/de/glink?page=bot/modules?query=counter&ref=scnx-app-docs).
2. Öffne die [Konfiguration](#configuration) und richte mindestens einen Zählkanal ein.
3. Der Bot benötigt die Berechtigungen "Nachrichten verwalten", "Reaktionen hinzufügen" und "Kanal verwalten" in den Zählkanälen.

## Nutzung {#usage}

Benutzer senden Zahlen in den konfigurierten Zählkanälen. Die erste Zahl ist `1`, und jede weitere Nachricht muss die nächste Zahl in der Reihenfolge sein. Der Bot reagiert mit einem Erfolgs-Emoji, wenn ein Benutzer korrekt zählt, und zeigt einen Fehler an, wenn die Eingabe ungültig ist.

- Benutzer wechseln sich beim Zählen ab (standardmäßig kann derselbe Benutzer nicht zwei Zahlen hintereinander zählen).
- Wenn der Mathe-Modus aktiviert ist, können Benutzer mathematische Ausdrücke senden, die die korrekte nächste Zahl ergeben.
- Wenn ein Benutzer einen konfigurierten Meilenstein erreicht, erhält er die konfigurierten Rollen und/oder eine Glückwunschbotschaft.
- Wenn ein Benutzer zu viele falsche Nachrichten sendet, kann der Bot seinen Zugriff auf den Zählkanal einschränken.

## Konfiguration {#configuration}

### Konfiguration {#config-main}

In dieser Konfigurationsdatei kannst du das Zähl-Spiel konfigurieren. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=counter%7Cconfig).

| Feld | Beschreibung |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Kanäle | Kanäle, in denen Benutzer am Zähl-Spiel teilnehmen können. |
| Kanalbeschreibung | Text, der als Kanalthema festgelegt wird, nachdem jemand gezählt hat. Verwende `%x%` für die nächste Zahl. Zum Deaktivieren leer lassen. |
| Erfolgsreaktion | Das Emoji, mit dem der Bot reagiert, wenn ein Benutzer korrekt zählt. |
| Spiel neustarten, wenn sich jemand verzählt | Wenn aktiviert, startet das Spiel bei 1 neu, wenn ein Benutzer die falsche Zahl sendet. |
| Nachricht, wenn das Spiel neugestartet wird | Die Nachricht, die gesendet wird, wenn das Spiel aufgrund eines Fehlers beim Zählen neu startet. |
| Nutzer müssen abwechselnd zählen | Wenn aktiviert, müssen sich die Benutzer abwechseln und können nicht zwei Zahlen hintereinander zählen. |
| Verhindern, dass Nutzer die letzte Zählungsnachricht löschen? | Wenn aktiviert, sendet der Bot eine Nachricht, wenn die letzte Zählnachricht gelöscht wird, um Verwirrung zu vermeiden. |
| Löschschutznachricht | Die Nachricht, die gesendet wird, wenn die letzte korrekte Zählnachricht gelöscht wird. |
| Reaktionen nach 5 Sekunden entfernen? | Wenn aktiviert, werden die Reaktionen des Bots nach 5 Sekunden entfernt, um den Kanal sauber zu halten. |
| Nachricht bei falscher Eingabe | Die Nachricht, die gesendet wird, wenn ein Benutzer eine ungültige Eingabe macht. |
| Anzahl von falschen Antworten, um eine Aktion auszulösen | Die Anzahl der falschen Nachrichten, die ein Benutzer senden muss, bevor er eingeschränkt wird. Zum Deaktivieren auf 0 setzen. |
| Rolle bei Sperrung vergeben, anstatt Rechte zu entfernen | Wenn aktiviert, wird dem Benutzer eine Rolle zugewiesen, anstatt ihm die Berechtigung zum Senden von Nachrichten zu entziehen. |
| Rolle, die bei Sperrung vergeben wird | Die Rolle, die eingeschränkten Benutzern zugewiesen wird (gilt nur, wenn die oben genannte Option aktiviert ist). |
| Nachricht, wenn ein Nutzer gesperrt wird | Die Nachricht, die gesendet wird, wenn ein Benutzer eingeschränkt wird. |
| Textcharaktere in der Nachricht erlauben? | Wenn aktiviert, können Benutzer neben der Zahl auch zusätzlichen Text in ihren Nachrichten angeben. |
| Nutzern erlauben, Mathematik in ihren Nachrichten zu verwenden? | Wenn aktiviert, können Benutzer mathematische Ausdrücke einreichen, die die korrekte nächste Zahl ergeben. |
| Zahlen-Easter-Eggs aktivieren? | Wenn aktiviert, reagiert der Bot bei bestimmten Zahlen (z. B. 42, 69, 100, 420) mit speziellen Emojis. |

### Ziele {#config-milestones}

In dieser Konfigurationsdatei kannst du Ziele festlegen, um Benutzer zu belohnen. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=counter%7Cmilestones).

| Feld | Beschreibung |
| ------------- | ------------------------------------------------------------------------------- |
| Nachrichtenzahl | Die Anzahl der gültigen Zählnachrichten, die ein Benutzer senden muss, um diesen Meilenstein zu erreichen. |
| Rollen | Rollen, die dem Benutzer zugewiesen werden, wenn er diesen Meilenstein erreicht (optional). |
| Nachricht | Eine Glückwunschbotschaft, die gesendet wird, wenn der Benutzer diesen Meilenstein erreicht. |

## Fehlerbehebung {#troubleshooting}

<details>
<summary>Der Bot reagiert nicht im Zähl-Kanal</summary>
<ul>
<li>Stelle sicher, dass der Kanal in der Konfiguration zur Liste "Kanäle" hinzugefügt wurde.</li>
<li>Stelle sicher, dass der Bot im Kanal über die Berechtigung "Reaktionen hinzufügen" verfügt.</li>
</ul>
</details>
<details>
<summary>Mathematische Ausdrücke funktionieren nicht</summary>
<ul>
<li>Stelle sicher, dass die Option "Nutzern erlauben, Mathematik in ihren Nachrichten zu verwenden?" in der Konfiguration aktiviert ist.</li>
</ul>
</details>
<details>
<summary>Benutzer erhalten keine Ziele-Rollen.</summary>
<ul>
<li>Stelle sicher, dass die Rolle des Bots in der Server-Rollenhierarchie höher eingestuft ist als die Rollen, die er zuweisen soll.</li>
<li>Stelle sicher, dass das Ziel korrekt mit der richtigen Nachrichtenanzahl konfiguriert ist.</li>
</ul>
</details>

## Gespeicherte Daten {#data-usage}

Die folgenden Daten werden zu jedem Zähl-Kanal gespeichert:

- Die Kanal-ID
- Die aktuelle Zahl im Zähl-Spiel
- Die ID des Benutzers, der zuletzt gezählt hat
- Eine Anzahl der gültigen Nachrichten pro Benutzer in diesem Kanal
- Metadaten über den Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung)

Um alle von diesem Modul gespeicherten Daten zu löschen, [setze die Modul-Datenbank zurück](/de/docs/custom-bot/additional-features/#reset-module-database).
Loading