Tutorial: Geburtstags-Glückwünsche in 5 Minuten einrichten

Dieses Tutorial führt dich durch die komplette Einrichtung des Geburtstags-Moduls auf deinem Discord-Server. Am Ende kann jeder User per Slash-Befehl oder Klick sein Datum privat eintragen, und der Bot gratuliert automatisch zur konfigurierten Uhrzeit.

Voraussetzungen

• TeraOne ist auf deinem Server installiert (oder ein Custom-Bot mit deinem Branding).
• Du hast Manage Server-Rechte auf dem Server.
• Optional: ein Text-Channel mit Schreibrechten für den Bot, in dem die Glückwünsche erscheinen sollen.

Schritt 1: Modul aktivieren

1. Öffne das Dashboard auf tera-one.de und logge dich mit Discord ein.
2. Wähle deinen Server aus der Sidebar.
3. Klicke auf den Geburtstag-Tab (🎂-Icon zwischen Welcome und Leveling).
4. Oben rechts findest du den Aktivierungs-Toggle. Schalte ihn ein.

Schritt 2: Channel und Zeitzone

Im Einstellungen-Tab:

• Glückwunsch-Channel — Dropdown listet alle Text-Channels mit Bot-Schreibrechten. Wähle den, in dem die Glückwünsche erscheinen sollen (z.B. #allgemein oder ein eigener #geburtstage-Channel).
• Zeitzone — Standard ist Europe/Berlin. Falls dein Server überwiegend in einer anderen Zeitzone aktiv ist, wähle die passende IANA-Zone.
• Uhrzeit — Standard ist 00:00. Stelle ein wann der Bot gratulieren soll. Tipp: Manche Communities mögen 09:00 lieber, weil dann mehr User online sind.

Schritt 3: Optionale Geburtstags-Rolle

Lege im Discord-Server eine Rolle an (z.B. 🎂 Geburtstag), die der User für 24h bekommt. Wichtig:

• Die TeraOne-Bot-Rolle muss in der Server-Hierarchie über der Geburtstags-Rolle stehen (sonst kann der Bot sie nicht setzen).
• Der Bot braucht ManageRoles-Permission auf dem Server.

Wähle die Rolle dann im Einstellungen-Tab unter Geburtstags-Rolle. Die 24-Stunden-Entfernung läuft automatisch — du musst nichts weiter tun.

Schritt 4: Canvas-Card designen

Im Einstellungen-Tab gibt es den eingebetteten Welcome-Card-Editor (jetzt mit Birthday-Modus). Wähle eines der drei vorgefertigten Birthday-Templates:

• Classic — Rosa-orangener Verlauf, großer Titel mit {user.name}.
• Confetti — Dunkler Hintergrund, gelber Akzent, zeigt zusätzlich {age}.
• Minimal — Weißer Hintergrund, dezenter Stil mit {birthday}.

Anpassen kannst du:

• Hintergrund — Solid, Gradient oder eigenes Bild (PNG/JPG bis 8 MB).
• Textfelder — Frei platzierbar mit Variablen wie {user}, {age}, {birthday}.
• Avatar — Position, Größe, optional mit Ring.

Vergiss nicht, oben Speichern zu klicken.

Schritt 5: Eintrags-Panel im Channel posten

Damit User ihren Geburtstag einfach eintragen können, postest du ein Embed-Panel mit Klick-Button in einen Channel deiner Wahl:

1. Wechsle in Discord in den Channel (z.B. #geburtstage).
2. Tippe /geburtstag panel und drücke Enter.
3. Der Bot postet ein Embed mit dem Titel "Geburtstag eintragen" und einem 🎂-Button.
4. User klicken den Button und tragen Tag.Monat (Pflicht) und Jahr (optional) ein.

Alternativ können User auch direkt /geburtstag set nutzen — derselbe Modal öffnet sich.

Schritt 6: Testen

Um sicherzugehen dass alles läuft:

1. Trage dich selbst mit /geburtstag set ein. Setze als Datum heute und das Jahr leer.
2. Wechsle ins Dashboard, Übersicht-Tab. Du solltest dich unter "Heute" sehen.
3. Im Einstellungen-Tab: setze die Notify-Zeit auf 2 Minuten in der Zukunft (z.B. wenn es jetzt 14:30 ist, stelle 14:32 ein). Speichern.
4. Warte 2 Minuten. Der Glückwunsch sollte im konfigurierten Channel erscheinen, dich pingen und (falls gesetzt) die Rolle bekommen.
5. Setze die Notify-Zeit zurück auf den gewünschten Wert.

Häufige Fragen

Was wenn der Bot nicht gratuliert?

• Stelle sicher, dass das Modul aktiviert ist (Toggle oben rechts).
• Prüfe ob der Bot Schreibrechte im Glückwunsch-Channel hat.
• Schau in die Übersicht — taucht der User dort als "Heute" auf? Falls nicht, ist die Server-Zeitzone vielleicht abweichend.

Kann ich Einträge für andere User anlegen?

Ja. Im Eintrag hinzufügen-Tab gibt es einen User-Picker (suche per @-mention). Eingaben durch Admins werden im addedByUserId-Feld vermerkt — User selbst können nur einmal pro Jahr ändern.

Was passiert mit den Daten wenn ein User den Server verlässt?

Der Eintrag bleibt erhalten, der Bot gratuliert aber nur Mitgliedern, die noch im Server sind. Wenn der User wiederkommt, wird er wieder berücksichtigt.

---

Fertig. Wenn etwas nicht klappt, schau im Docs-Bereich oder melde dich in unserem Support-Server.