Giveaways: Gewinnspiele mit Bedingungen, Bonuslosen und Rerolls

Mit Giveaways startest du Gewinnspiele auf deinem Server: Kage postet eine Nachricht mit einem Join-Button, sammelt die Teilnahmen, lost zum Ende automatisch Gewinner aus und kann ihnen eine Rolle geben oder eine Direktnachricht schicken. Du legst Bedingungen fest, etwa eine nötige Rolle, ein Mindest-Kontoalter oder Bonus-Lose für bestimmte Rollen.

Eine kurze Anleitung findest du im Ratgeber Giveaways einrichten.

Voraussetzungen

• Rechte: Der Befehl /giveaway ist nur mit Server verwalten nutzbar. Im Dashboard brauchst du dasselbe Recht (oder einen für dieses Modul freigegebenen Zugriff).
• Rechte von Kage im Kanal: Nachrichten senden, Links einbetten und, für die Gewinnerrolle, Rollen verwalten mit einer Rolle über der Gewinnerrolle.
• Obergrenze laufender Giveaways: Der Tarif begrenzt, wie viele Giveaways gleichzeitig laufen dürfen: Premium bis zu 10, Enterprise bis zu 50. Beenden eines Giveaways schafft wieder Platz.

Ein Giveaway starten

Du kannst ein Giveaway per Befehl oder im Dashboard unter Gewinnspiele → Neues Gewinnspiel starten. Die Felder sind dieselben:

Kage postet ein Embed mit Preis, Gewinnerzahl, Teilnehmerzahl, optionalem Sponsor und Bild und dem Ende als Datum und relative Zeit. Darunter steht der Button „Join 🎉“. Du erhältst die Giveaway-ID und einen Link.

Die Teilnahme

Ein Mitglied klickt auf Join. Kage prüft der Reihe nach:

1. Läuft das Giveaway noch?
2. Hat das Mitglied die benötigte Rolle?
3. Trägt es eine ausgeschlossene Rolle?
4. Ist sein Discord-Konto alt genug?
5. Ist es lange genug auf dem Server?

Besteht es alle Prüfungen, trägt Kage es ein. Pro Person gibt es eine Teilnahme, ein zweiter Klick meldet „du bist bereits dabei“. Die Teilnehmerzahl im Embed aktualisiert sich nach jeder neuen Teilnahme. Wird eine Bedingung nicht erfüllt, erhält das Mitglied eine private Meldung, warum.

Hat das Giveaway eine Bonus-Rolle, zählen Mitglieder mit dieser Rolle mit der eingestellten Zahl an Losen, alle anderen mit einem Los. Trägt jemand mehrere Bonus-Rollen, gilt die höchste Zahl.

Auslosung und Ende

Kage prüft alle 30 Sekunden, ob ein Giveaway abgelaufen ist.

1. Kage lost die Gewinner gewichtet und ohne Zurücklegen: Wer mehr Lose hat, gewinnt wahrscheinlicher, aber jede Person kann nur einmal gewinnen.
2. Kage aktualisiert die Nachricht: Der Button verschwindet, das Embed zeigt die Gewinner (oder, dass es keine Teilnahmen gab) und die Fußzeile „Giveaway ended“.
3. Kage postet im Kanal eine Gratulation mit den Erwähnungen der Gewinner, oder meldet, dass niemand teilgenommen hat.
4. Wenn eine Gewinner-Rolle gewählt ist, vergibt Kage sie an die Gewinner. Ist die Option per DM benachrichtigen an, schickt Kage zusätzlich eine Direktnachricht.
5. Das Ende steht im Reiter Logs des Moduls.

Kage markiert ein Giveaway immer als beendet, auch wenn etwas schiefgeht (zum Beispiel ein gelöschter Kanal), damit es nicht endlos neu versucht wird.

Befehle

Die Gruppe /giveaway ist nur mit Server verwalten nutzbar. Die Antworten sieht nur du, außer beim Reroll.

Beim Reroll schließt Kage die bisherigen Gewinner aus und lost unter den übrigen Teilnehmenden, mit denselben Gewichten. Gibt es niemanden mehr, meldet Kage das. Bei einem noch laufenden Giveaway ist ein Reroll nicht möglich.

Beenden und Reroll gibt es nur als Befehle. Im Dashboard startest und beobachtest du Giveaways.

Im Dashboard

Unter Gewinnspiele siehst du Laufende und Abgeschlossene Giveaways (die zuletzt abgeschlossenen) mit Preis, Gewinner- und Teilnehmerzahl, Bedingungen, Bonus-Rollen, Sponsor und Gewinner-Rolle.

Einstellungen im Überblick

Giveaways haben keine Modul-Einstellungen: Alles legst du pro Giveaway beim Start fest. Die Dashboard-Seite startet sie über das Formular Neues Gewinnspiel.

Ergebnis überprüfen

1. Start: Starte ein Testgiveaway mit 1 Minute Laufzeit. Das Embed erscheint mit dem Join-Button.
2. Teilnahme: Klicke mit einem Testkonto auf Join. Die Teilnehmerzahl steigt auf 1.
3. Ende: Nach spätestens etwa 30 Sekunden nach Ablauf erscheint die Gratulation im Kanal.
4. Reroll: /giveaway reroll lost, wenn es weitere Teilnehmende gibt.

Fehlerbehebung

Der Join-Button reagiert nicht

Das Giveaway ist beendet oder nicht mehr aktiv. Der Button zeigt dann eine entsprechende Meldung. Nach einem Neustart des Bots funktioniert der Button weiter.

Ein Mitglied kann nicht teilnehmen

Es fehlt die benötigte Rolle, es trägt eine ausgeschlossene Rolle, sein Konto oder seine Server-Mitgliedschaft ist zu jung, oder es ist bereits dabei. Die private Meldung nennt den Grund.

Das Giveaway lässt sich nicht starten

Prüfe die Rechte von Kage im Kanal (Nachrichten senden, Links einbetten). Prüfe, ob die Obergrenze laufender Giveaways erreicht ist, und ob die Bild-URL mit http:// oder https:// beginnt.

Keine Auslosung nach Ablauf

Die Auslosung folgt innerhalb von etwa 30 Sekunden. War Kage offline, holt er sie nach, sobald er wieder läuft.

Die Gewinner-Rolle wird nicht vergeben

Kages Rolle steht in der Rollenliste unter der Gewinner-Rolle, oder ihm fehlt Rollen verwalten. Kage meldet diesen Fehler nicht; die Gratulation im Kanal erscheint trotzdem. Vergib die Rolle in diesem Fall von Hand.

Die DM kommt nicht an

Der Gewinner hat Direktnachrichten von Servermitgliedern gesperrt. Kage überspringt die DM stillschweigend. Die Gratulation im Kanal erscheint trotzdem.

Weiterführend

Umfragen: Umfragen. Rollen mit Bedingungen: Role Panels.