Docs

i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/fun/chess.md

@@ -0,0 +1,106 @@
+# Schach
+
+Spiele Schach gegen andere Servermitglieder oder die KI, direkt in Discord!
+
+<ModuleOverview moduleName="chess" />
+
+## Funktionen {#features}
+
+- Fordere ein anderes Mitglied zu einer PvP-Schachpartie heraus oder starte ein Spiel gegen die KI (Leicht, Mittel, Schwer).
+- Spiele laufen in dedizierten Discord-Threads für ein sauberes, asynchrones Gameplay. Threads werden automatisch archiviert, wenn das Spiel endet.
+- Drei Möglichkeiten, Züge zu machen: Gib einen Zug direkt im Spiel-Thread ein, verwende die algebraische Notation über ein Popup-Modal (z. B. `e2e4`, `Nf3`, `O-O`) oder nutze geführte Auswahlmenüs, um deine Figur und das Zielfeld auszuwählen.
+- Volle Rochade-Unterstützung – verwende die Standardnotation (`O-O`, `O-O-O`) oder die Koordinatennotation (`e1g1`). Rochadezüge sind in den Auswahlmenüs gekennzeichnet.
+- **Bauerntransformations-Auswahl** – Wenn ein Bauer die letzte Reihe erreicht, wähle über ein Dropdown-Menü aus, in welche Figur er umgewandelt werden soll (Dame, Turm, Läufer oder Springer), anstatt immer zu einer Dame gezwungen zu sein.
+- **Materialbilanz-Anzeige** – Das Spiel-Embed zeigt nach jedem Zug an, wer materiell im Vorteil ist (z. B. *Weiß +3*).
+- Visuelle Schachbrett-Bilder werden für jeden Zug generiert, inklusive Hervorhebung von Schach und dem letzten Zug. Das Brett wird automatisch aus der Perspektive des Spielers gerendert, der an der Reihe ist, sodass asynchrone Spiele deine eigenen Figuren immer unten anzeigen.
+- Remisangebote, Aufgaben und die Zughistorie sind integriert. Remisangebote sind nur in PvP-Spielen verfügbar, nicht gegen die KI.
+- Beendete Spiele enthalten eine **Züge**-Schaltfläche im letzten Brett-Embed, um den gesamten Spielverlauf schnell zu überprüfen.
+- Konfigurierbares Zug-Zeitlimit mit automatischen Erinnerungen und Aufgeben-Niederlage bei Inaktivität.
+- Mehrere gleichzeitige Spiele pro Spieler (keine doppelten Spiele zwischen denselben zwei Spielern).
+- Spiele werden automatisch als verloren gewertet, wenn ein Spieler den Server verlässt.
+
+## Einrichtung {#setup}
+
+1. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=chess) auf deinem Server.
+2. Öffne optional die [Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=chess%7Cconfiguration) um die Einstellungen für **Zugzeitüberschreitung**, **Aufgeben Zeitüberschreitung**, **Maximale gleichzeitige Spiele** und **KI-Gegner aktiviert** anzupassen.
+
+Spiel-Threads werden in dem Kanal erstellt, in dem der Befehl `/chess` verwendet wird – es muss kein dedizierter Spiel-Kanal konfiguriert werden.
+
+## Nutzung {#usage}
+
+### Einen Spieler herausfordern {#challenging}
+
+Verwende `/chess challenge`, um ein anderes Mitglied herauszufordern. Der herausgeforderte Benutzer hat 2 Minuten Zeit, um die Einladung anzunehmen oder abzulehnen. Sobald sie angenommen wurde, wird im aktuellen Kanal ein neuer Thread mit dem Schachbrett und den Aktionsschaltflächen erstellt.
+
+### Gegen die KI spielen {#ai}
+
+Verwende `/chess challenge-ai`, um ein Spiel gegen die KI zu starten. Wähle eine Schwierigkeitsstufe: Leicht, Mittel oder Schwer. Du spielst immer als Weiß.
+
+### Züge ausführen {#moves}
+
+Wenn du an der Reihe bist, hast du drei Optionen:
+
+- **Im Thread schreiben** – Gib deinen Zug einfach als Nachricht im Spiel-Thread ein (z. B. `e2e4`, `Nf3`, `O-O`). Die Nachricht wird automatisch gelöscht und der Zug wird verarbeitet.
+- **Zug-Schaltfläche** – Klicke auf "Zug", um ein Pop-up-Fenster zu öffnen, in dem du deinen Zug in algebraischer Notation eingibst (z. B. `e2e4`, `e2-e4`, `Nf3`).
+- **Auswahlmenüs** – Der Bot zeigt ein Auswahlmenü für Figuren an. Wähle eine Figur und anschließend das Zielfeld im nächsten Menü. Rochade-Züge sind gekennzeichnet, sofern sie verfügbar sind.
+
+Wenn ein Bauer die letzte Reihe erreicht, ersetzt der Bot die Spielsteuerung durch ein **Beförderungs-Auswahlmenü**. Wähle die gewünschte Figur (Dame, Turm, Läufer oder Springer) und der Zug wird mit deiner Auswahl abgeschlossen.
+
+Nach deinem Zug wird das Bild des Schachbretts aktualisiert und der Gegner wird markiert.
+
+### Remis, Aufgeben und Verlauf {#actions}
+
+- **Remis anbieten** – Klicke auf die Schaltfläche "Remis anbieten" (nur in PvP-Spielen, gegen die KI nicht verfügbar). Dein Gegner sieht bei seinem nächsten Zug eine Schaltfläche "Remis annehmen". Wenn er stattdessen einen Zug ausführt, wird das Remis-Angebot implizit abgelehnt.
+- **Aufgeben** – Klicke auf "Aufgeben" und bestätige die Auswahl. Der Gegner gewinnt sofort.
+- **Züge** – Klicke auf "Züge", um den vollständigen Spielverlauf anzuzeigen.
+
+### Zugzeitüberschreitungen {#timeouts}
+
+Wenn ein Spieler innerhalb des konfigurierten Zeitlimits keinen Zug ausführt, erhält er eine Erinnerung im Thread. Wenn er innerhalb der Verfallzeit immer noch keinen Zug ausführt, wird das Spiel automatisch als verloren gewertet.
+
+## Befehle {#commands}
+
+<SlashCommandExplanation />
+
+| Befehl                                               | Beschreibung                                                     |
+| ----------------------------------------------------- | --------------------------------------------------------------- |
+| `/chess challenge user:<User>`                        | Fordere ein anderes Mitglied zu einer Schachpartie heraus.                      |
+| `/chess challenge-ai [difficulty:<Easy/Medium/Hard>]` | Starte eine Schachpartie gegen die KI (Standard-Schwierigkeitsgrad: Mittel). |
+| `/chess games`                                        | Zeige deine aktiven Schachpartien an.                                  |
+| `/chess history [user:<User>]`                        | Zeige den Verlauf beendeter Schachpartien an (deine eigenen oder die eines anderen Spielers).  |
+
+## Konfiguration {#configuration}
+
+Öffne die Konfiguration in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=chess%7Cconfiguration).
+
+| Feld                   | Beschreibung                                                                                              | Standard |
+| ----------------------- | -------------------------------------------------------------------------------------------------------- | ------- |
+| Zugzeitüberschreitung (Stunden)    | Stunden, bis eine Erinnerung im Spiel-Thread gesendet wird.                                               | 24      |
+| Aufgeben Zeitüberschreitung (Stunden) | Stunden der Inaktivität, bis das Spiel automatisch als verloren gewertet wird.                                                        | 48      |
+| Maximale gleichzeitige Spiele    | Maximale Anzahl aktiver Spiele pro Spieler.                                                         | 5       |
+| KI-Gegner aktiviert     | Ermögliche Spielern, Partien gegen die KI zu starten. Wenn diese Option deaktiviert ist, wird der Befehl `/chess challenge-ai` ausgeblendet. | true    |
+
+## Fehlerbehebung {#troubleshooting}
+
+<details>
+  <summary>Das Brettbild wird nicht angezeigt</summary>
+  <ul>
+    <li>Das Brettbild wird von einer externen API generiert. Falls die API vorübergehend nicht verfügbar ist, funktioniert das Spiel trotzdem – das Bild fehlt dann lediglich im Embed.</li>
+  </ul>
+</details>
+
+<details>
+  <summary>Mein Zug wurde als ungültig abgelehnt</summary>
+  <ul>
+    <li>Stelle sicher, dass du einen legalen Zug eingibst. Die Fehlermeldung listet alle legalen Züge für deine aktuelle Position auf.</li>
+    <li>Wenn du eine Notation wie <code>Nf3</code> verwendest und mehrere Springer f3 erreichen können, nutze stattdessen die Koordinatennotation (z. B. <code>G1F3</code>).</li>
+  </ul>
+</details>
+
+## Gespeicherte Daten {#data-usage}
+
+Die folgenden Daten werden von diesem Modul gespeichert:
+
+- **Spielaufzeichnungen**: Spieler-IDs, Brettzustand (FEN), Anzahl der Züge, Spielstatus, Thread-/Kanal-IDs und Zeitstempel für jedes Spiel. Beendete Spiele werden für den Verlauf unbegrenzt aufbewahrt.
+
+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).

i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/fun/duel.md

@@ -0,0 +1,46 @@
+# Duell
+
+Lasse Benutzer das Spiel "Duell" auf deinem Discord spielen.
+
+<ModuleOverview moduleName="duel" />
+
+## Funktionen {#features}
+
+- Fordere einen anderen Benutzer zu einem rundenbasierten Duell-Spiel heraus.
+- Einfache Spielmechanik mit drei Aktionen: Schießen, Blocken und Nachladen.
+- Interaktives, Button-basiertes Gameplay direkt in Discord.
+- Einladungssystem mit Optionen zum Annehmen/Ablehnen und automatischem Ablauf.
+
+## Einrichtung {#setup}
+
+1. Aktiviere das Modul in [deinem SCNX-Dashboard](https://scnx.app/de/glink?page=bot/modules?query=duel&ref=scnx-app-docs).
+2. Keine weitere Konfiguration erforderlich. Das Modul besitzt keine Konfigurationsdatei.
+
+## Nutzung {#usage}
+
+Verwende den Befehl `/duel`, um einen anderen Benutzer herauszufordern. Der herausgeforderte Benutzer hat 2 Minuten Zeit, die Einladung anzunehmen oder abzulehnen.
+
+Sobald das Spiel beginnt, wählen beide Spieler in jeder Runde eine von drei Aktionen durch das Klicken von Buttons aus:
+
+- **Schießen** – Feuere deine Waffe auf den Gegner ab. Erfordert mindestens eine Patrone. Wenn der Gegner nicht blockt, gewinnst du.
+- **Blocken** – Verteidige dich gegen einen Schuss. Du kannst nicht mehr als 5-mal hintereinander blocken; danach wird dein Block durchbrochen.
+- **Nachladen** – Füge deiner Waffe eine Patrone hinzu. Du kannst maximal 5 Patronen halten. Während des Nachladens bist du verwundbar.
+
+Beide Spieler treffen ihre Wahl gleichzeitig. Sobald beide gewählt haben, wird die Runde aufgelöst und die nächste Runde beginnt. Das Spiel endet, wenn ein Spieler erfolgreich einen ungeschützten Gegner erschießt.
+
+## Befehle {#commands}
+
+<SlashCommandExplanation />
+
+| Befehl             | Beschreibung                    |
+| ------------------- | --------------------------------- |
+| `/duel user:<User>` | Fordere einen anderen Benutzer zu einem Duell heraus. |
+
+## Fehlerbehebung {#troubleshooting}
+
+<details>
+    <summary>Die Einladung ist abgelaufen</summary>
+    <ul>
+        <li>Der herausgeforderte Benutzer hat 2 Minuten Zeit, die Einladung anzunehmen. Danach läuft sie automatisch ab.</li>
+    </ul>
+</details>

i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/fun/emoji-quiz.md

@@ -0,0 +1,104 @@
+# Emoji-Quiz
+
+Bestimme einen Kanal als Emoji-Quiz-Kanal und lass deine Benutzer Emoji-Kombinationen erraten.
+
+<ModuleOverview moduleName="emoji-quiz" />
+
+## Funktionen {#features}
+
+- Automatisches Emoji-Quizspiel, das in einem festgelegten Kanal läuft.
+- Benutzer erraten die durch Emoji-Kombinationen dargestellte Antwort, indem sie in den Kanal schreiben.
+- Integrierte Fragedatenbank oder Verwendung eigener, benutzerdefinierter Fragen.
+- Tipp-Anforderungs-, Anfangsbuchstaben-Freischaltungs- und Überspringen-Funktion mit konfigurierbaren Ratenbegrenzungen.
+- Optionale Bestenliste zur Verfolgung der Benutzerpunkte.
+- Falsche Tipps können automatisch gelöscht werden, um den Kanal übersichtlich zu halten.
+- Immunitätsrollen, um Ratenbegrenzungen bei Aktionen zu umgehen.
+
+## Einrichtung {#setup}
+
+1. Aktiviere das Modul in [deinem SCNX-Dashboard](https://scnx.app/de/glink?page=bot/modules?query=emoji-quiz&ref=scnx-app-docs).
+2. Erstelle einen leeren Textkanal auf deinem Server für das Quiz.
+3. Öffne die [Konfiguration](#configuration) und setze den "Spiel-Kanal" auf den leeren Kanal.
+4. Der Bot benötigt die Berechtigungen "Nachrichten verwalten", "Kanäle verwalten" und "Nachrichtenverlauf anzeigen" im Spiel-Kanal.
+5. Konfiguriere optional benutzerdefinierte Fragen oder aktiviere die Bestenliste.
+
+## Nutzung {#usage}
+
+Sobald der Bot eingerichtet ist, postet er eine Emoji-Kombination im Spiel-Kanal. Benutzer erraten die Antwort, indem sie ihre Tipps direkt in den Kanal schreiben. Der Bot erzwingt eine Abklingzeit von 5 Sekunden zwischen den Tipps.
+
+- Wenn der Tipp richtig ist, reagiert der Bot mit einem Feier-Emoji und postet eine neue Frage.
+- Wenn der Tipp falsch ist, reagiert der Bot mit einem Kreuz-Emoji. Falsche Tipps werden optional nach 5 Sekunden gelöscht.
+- Benutzer können auf die Schaltflächen unter der Quiz-Nachricht klicken, um:
+  - **Tipp anfordern** – Zeigt einen Texthinweis für die aktuelle Frage an (falls verfügbar).
+  - **Ersten Buchstaben freischalten** – Zeigt den ersten Buchstaben der Antwort an.
+  - **Aufgabe überspringen** – Überspringt die aktuelle Frage und lädt eine neue.
+  - **Infos über Fragen** – Zeigt Details zur aktuellen und vorherigen Frage an.
+  - **Bestenliste anzeigen** – Zeigt die 25 besten Spieler an (wenn die Bestenliste aktiviert ist).
+
+Wenn die Bestenliste aktiviert ist, erhalten Benutzer 2 Punkte für einen richtigen Tipp (oder 1 Punkt, wenn ein Hinweis verwendet wurde).
+
+## Konfiguration {#configuration}
+
+### Konfiguration {#config-main}
+
+In dieser Konfigurationsdatei kannst du das Emoji-Quiz konfigurieren. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=emoji-quiz%7Cconfig).
+
+| Feld                                                    | Beschreibung                                                                                                                                    |
+| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| Eigene Spiel-Fragen verwenden?                             | Falls aktiviert, werden deine benutzerdefinierten Fragen anstelle der integrierten Datenbank verwendet. Dies deaktiviert einige Funktionen wie den Schutz vor doppelten Fragen. |
+| Spiel-Kanal                                            | Der Textkanal, in dem das Quiz stattfindet. Der Kanal muss leer sein.                                                                     |
+| Maximale Anzahl von Tipps pro Nutzer pro Stunde | Maximale Anzahl an Freischaltungen des ersten Buchstabens, die ein Benutzer pro Stunde anfordern kann.                                                                            |
+| Maximale Anzahl von Tipps pro Nutzer pro Stunde               | Maximale Anzahl an Tippanfragen, die ein Benutzer pro Stunde stellen kann.                                                                                     |
+| Maximale Anzahl von Überspringen pro Nutzer pro Stunde              | Maximale Anzahl an Überspringungen einer Frage, die ein Benutzer pro Stunde durchführen kann.                                                                                  |
+| Falsche Antworten löschen? (empfohlen)                      | Falls aktiviert, werden falsche Tipps nach 5 Sekunden gelöscht, um den Kanal sauber zu halten.                                                             |
+| Bestenliste aktivieren                                 | Falls aktiviert, erscheint eine Bestenlisten-Schaltfläche und Benutzer erhalten Punkte für richtige Tipps.                                                          |
+| Immune Rollen                                      | Rollen, die von den Limits für das Überspringen, Hinweisen und Enthüllen des ersten Buchstabens ausgenommen sind.                                                                        |
+
+### Eigene Spielfragen {#config-custom}
+
+In dieser Konfigurationsdatei kannst du deine eigenen Quizfragen hinzufügen. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=emoji-quiz%7Ccustom-questions).
+
+| Feld             | Beschreibung                                                                         |
+| ----------------- | ------------------------------------------------------------------------------------- |
+| Fragestellung (= Emojis) | Die den Benutzern angezeigte Emoji-Kombination.                                            |
+| Tipp (optional)   | Ein Text-Hinweis, den Benutzer anfordern können. Leer lassen, um die Tipp-Schaltfläche für diese Frage auszublenden. |
+| Lösung         | Die Antwort, die Benutzer erraten müssen.                                                  |
+
+## Fehlerbehebung {#troubleshooting}
+
+<details>
+    <summary>Der Bot postet keine Quizfragen</summary>
+    <ul>
+        <li>Stelle sicher, dass der Spiel-Kanal leer und in der Konfiguration korrekt eingestellt ist.</li>
+        <li>Stelle sicher, dass der Bot die Berechtigungen "Nachrichten verwalten", "Kanäle verwalten" und "Nachrichtenverlauf anzeigen" im Spiel-Kanal hat.</li>
+    </ul>
+</details>
+<details>
+    <summary>Eigene Fragen werden nicht verwendet</summary>
+    <ul>
+        <li>Stelle sicher, dass "Eigene Spiel-Fragen verwenden??" in der Konfiguration aktiviert ist.</li>
+        <li>Nach dem Ändern dieser Einstellung musst du die aktuelle Frage überspringen oder lösen, damit die Änderung wirksam wird.</li>
+    </ul>
+</details>
+
+## Gespeicherte Daten {#data-usage}
+
+Die folgenden Daten werden für den Spielstatus gespeichert:
+
+- Aktuelle Fragendaten und vorherige Fragendaten (einschließlich Frage, Lösung und Tippnutzung)
+- Die ID der angepinnten Infonachricht im Spielkanal
+- Metadaten über den Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung)
+
+Die folgenden Daten werden über jede Spielaktion gespeichert (Tipp, Überspringen, Freischalten des ersten Buchstabens):
+
+- Die Benutzer-ID desjenigen, der die Aktion ausgeführt hat
+- Die Art der Aktion
+- Metadaten über den Eintrag (Erstellungsdatum und Datum der letzten Aktualisierung)
+
+Wenn die Bestenliste aktiviert ist, werden die folgenden Daten über jeden teilnehmenden Benutzer gespeichert:
+
+- Die Benutzer-ID
+- Die Gesamtpunktzahl
+- 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).