Quiz-Modul

Erstelle Quizze für deine Nutzer und lasse sie gegeneinander antreten.

Quiz-Modul

TomatoCake

Erstelle Quiz für deine Nutzer und lasse sie gegeneinander antreten.

Dieses Modul ist Open-Source.

Dieses Modul speichert Daten in der Datenbank deines Bots.

Dieses Modul hat 3 Konfigurationsdateien.

Dieses Modul wird auf über 2200 Servern auf SCNX aktiv verwendet.

Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.

Modul auf SCNX aktivieren

Funktionen

Erstelle einfach Quizze auf deinem Server, lasse deine Mitglieder auf einer Bestenliste konkurrieren und beantworte automatisch eine festgelegte Anzahl von Fragen pro Tag.

Einrichtung

Aktiviere das Modul in deinem SCNX-Dashboard und konfiguriere es.

Verwendung

Um ein öffentliches Quiz zu starten, verwende die Befehle /quiz create oder /quiz create-bool, wie unten im Befehlsbereich beschrieben. Beachte, dass du die in der Hauptkonfiguration festgelegte Rolle besitzen musst, um diese Befehle nutzen zu können.

Wenn Quizze in der Quiz-Liste erstellt wurden, kann jeder Nutzer ein privates Quiz mit dem Befehl /quiz play starten.

Befehle

Dokumentation Verstehen

In dieser Dokumentation bezeichnen wir eine verpflichtende Slash-Befehl-Option mit dem Namen name und dem Typen Typ als name:<Typ>. Optionen, die nicht Pflichtfelder sind, werden als [name:<Typ>] angegeben. Wenn sich die Aktionen eines Befehls zwischen Pflichtfeldern und Nicht-Pflichtfeldern sehr unterscheiden, listen wir sie eventuell separat.

Beispiele

• /moderate ban user:<Mitglied>: Dieser Befehl (/moderate ban) hat nur eine verpflichtende Option mit dem Namen "user", die nur ein Mitglied akzeptiert.
• /moderate ban victim:<Mitglied> reason:<Text>: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert.
• /moderate ban victim:<Mitglied> reason:<Text> [proof:<Anhang>]: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert. Zusätzlich gibt es eine optionale Option mit dem Namen "proof", die einen Anhang als Wert akzeptiert.

Befehl	Beschreibung
/quiz create <Beschreibung> <Kanal> <Quiz-Dauer> <Option 1> <Option 2> [<Kann Stimme geändert werden?> <Option 3 bis 9>]	Erstellt ein öffentliches Quiz mit der angegebenen Beschreibung/Frage im ausgewählten Kanal.
/quiz create-bool <Beschreibung> <Kanal> [<Kann Stimme geändert werden?> <Quiz-Dauer>]	Erstellt ein öffentliches Ja/Nein-Quiz mit der angegebenen Beschreibung/Frage im Kanal.
/quiz play	Spiele ein privates Quiz, das in der Konfiguration des eigenen Bots eingerichtet ist.
/quiz leaderboard	Zeigt die Bestenliste mit den Gesamt- und Tagespunkten der besten Nutzer an.

Konfiguration

Hauptkonfiguration

In diesem Teil kannst du die wichtigsten Einstellungen für das Quiz einrichten. Du findest die Seite in deinem Dashboard.

Feld	Beschreibung
Emojis	Welche Emojis der Bot für die Knöpfe verwendet. Du kannst Emojis sowohl für normale als auch für Ja/Nein-Quizze konfigurieren.
Tägliches Quizlimit	Wie viele Quizze ein Nutzer pro Tag mit /quiz play spielen kann. Standardwert ist fünf.
Quiz-Leaderboard-Kanal	Wird dieser gesetzt, aktualisiert der Bot automatisch die Bestenliste im Kanal. Der Kanal sollte nur dafür verwendet werden.
Rolle zum Erstellen von Quiz	Rolle, die Quizze mit Befehlen erstellen darf. Diese Einstellung beeinflusst nicht, wer /quiz play nutzen kann.
Modus zur Quiz-Auswahl	Wie das nächste /quiz play Quiz für einen Nutzer ausgewählt wird: Bei „Random“ bekommt der Nutzer bei jedem Befehl ein zufälliges Quiz.
Live-Vorschau der Ergebnisse	Zeigt die Antworten der Nutzer bei öffentlichen Quizzen live an, statt erst nach Ende des Quiz.

Nachrichten

Mit der Nachrichten-Konfiguration kannst du die Nachrichten des Moduls individuell anpassen.

Feld	Beschreibung
title	Der Titel des Quiz, der im Embed-Titel angezeigt wird.
color	Die Standardfarbe des Quiz-Embeds.
options	Text mit einer Einführung zu den möglichen Quiz-Optionen.
liveView	Wird vor dem Live-Ansichts-Bereich des Quiz angezeigt, falls aktiviert.
expiresOn	Name des Zusatzfelds, falls das Quiz ein Enddatum hat.
thisQuizExpiresOn	Zusätzlicher Text im Zusatzfeld, falls ein Enddatum gesetzt ist. %date% zeigt ein Discord-Timestamp im lokalen Format des Nutzers.
endedQuizTitle	Titel des Quiz-Embeds, wenn das Quiz beendet ist.
endedQuizColor	Farbe des Embeds, wenn das Quiz beendet ist.
leaderboardTitle	Titel der Bestenliste im Embed-Titel.
leaderboardSubtitle	Untertitel der Bestenliste in der Embed-Beschreibung.
leaderboardColor	Farbe des Bestenlisten-Embeds.
leaderboardButton	Text des Knopfes auf der Bestenliste.

Quiz bearbeiten

Unter Quiz berbeiten werden die Quizfragen verwaltet. Hier kannst du Fragen hinzufügen, bearbeiten und löschen.

Jede Quizfrage hat folgende Felder:

Feld	Beschreibung
Frage oder Behauptung	Titel des Quiz, sollte eine Frage sein, z.B. „Was ist dein Lieblingsspiel?“.
Zeitlimit	Zeit, nach der eine Antwort ungültig ist. Standardwert ist eine Minute.
Richtige Antworten	Liste aller korrekten Antworten. Diese werden mit den falschen Antworten gemischt. Beispiel: „Minecraft“.
Falsche Antworten	Das Gegenteil der richtigen Antworten – bei Auswahl verliert der Nutzer. Beispiel: „Fortnite“.

Fehlerbehebung

Quiz-Nachrichten werden nicht gesendet

Überprüfe deine Konfiguration:

• Das Quiz muss mindestens eine richtige und eine falsche Antwort haben.
• Das Quiz muss einen Titel besitzen.

• Stelle sicher, dass die Nachrichten-Konfiguration gültig ist, insbesondere dürfen Felder nicht leer sein.

Leaderboard-Nachricht wird nicht gesendet

Stelle sicher, dass der ausgewählte Kanal leer ist und keine Nachrichten enthält, damit der Bot die Bestenliste anzeigen kann.

Falsche Emoji-Konfiguration

Überprüfe die Farbe des Buttons deiner Auswahl – ist er grün, hast du gewonnen! Andernfalls solltest du vielleicht die Regeln von Schere, Stein, Papier erneut lesen...

Gespeicherte Daten

Folgende Daten werden zu jedem mit dem Bot erstellten Quiz gespeichert:

• Die ID der Quiz-Nachricht
• Die Beschreibung/Frage des Quiz
• Liste der Optionen
• Liste der abgegebenen Stimmen
• Datum der letzten möglichen Antwort, falls vorhanden
• Die Kanal-ID des Kanals, in dem das Gewinnspiel gestartet wurde
• Ob Nutzer ihre Stimmen ändern dürfen
• Ob das Quiz öffentlich im Kanal (wie eine Umfrage) oder privat per /quiz play gestartet wurde
• Die Quiz-Art (z.B. Ja/Nein-Quiz)
• Metadaten zum Eintrag (Erstellungs- und Änderungsdatum)

Der Bot speichert zudem folgende Daten zu jedem Nutzer, der an einem Quiz teilgenommen hat:

• Die Nutzer-ID
• Die Gesamtanzahl Erfahrungspunkte (richtige Antworten)
• Die Anzahl Erfahrungspunkte des aktuellen Tages
• Die Anzahl beantworteter Quizze am aktuellen Tag
• Falls die zufällige Quiz-Auswahl deaktiviert ist, die ID des nächsten Quiz
• Metadaten zum Eintrag (Erstellungs- und Änderungsdatum)

Einmal täglich werden die Quizdaten des Vortags aus der Datenbank entfernt. Um alle Quiz-bezogenen Daten zu löschen, lösche die Modul-Datenbank.