🎮 gamingpartys Discord Bot | Event-Alerts für deinen Server

Die gamingpartys.de Discord App bringt alle Gamescom-Partys, Meetups, Messen und Community-Events direkt auf deinen Discord-Server. Der Bot informiert deine Community vollautomatisch über neue Events, ermöglicht interaktive Zu-/Absagen (RSVP) mit Live-Zählern, bietet flexible Filter und lässt Admins entscheiden, ob Events sofort oder erst nach manueller Prüfung veröffentlicht werden.

---

📥 1. Bot einladen & Voraussetzungen

🔗 Einladungslink

Füge den Bot über folgenden Link zu deinem Server hinzu:
👉 gamingpartys.de Discord Bot einladen

🛡️ Benötigte Berechtigungen

Damit der Bot reibungslos funktioniert, benötigt er in den Zielkanälen folgende Rechte:

• Kanal anzeigen (ViewChannel)
• Nachrichten senden (SendMessages)
• Links einbetten (EmbedLinks)
• Dateien anhängen (AttachFiles)
• Nachrichtenverlauf sehen (ReadMessageHistory)
• @everyone, @here und alle Rollen erwähnen (MentionEveryone) (optional, für Benachrichtigungs-Pings)
• Events verwalten (ManageEvents) (optional, damit Nutzer über den Button „Create Event“ direkt Server-Events anlegen können)

---

⚙️ 2. Einrichtung für Server-Admins

Die Einrichtung dauert weniger als eine Minute und erfolgt direkt über Slash-Commands.

/config [event-channel] [approve-feature]

Richtet die Kanäle für den Bot auf eurem Server ein. (Benötigt die Discord-Berechtigung „Server verwalten“)

• event-channel (Pflichtfeld): Der öffentliche Text- oder Ankündigungskanal, in dem Events für alle Mitglieder sichtbar gepostet werden.
• approve-feature (Optional): Ein interner Team- oder Moderationskanal für einen Freigabe-Workflow.

💡 Die zwei Betriebsmodi:

1. Direkt-Modus (Standard):
   Wird nur event-channel gesetzt, werden neu eingetragene Events sofort und automatisch in eurem Ankündigungskanal gepostet.
2. Prüf-/Freigabe-Workflow (Empfohlen für kuratierte Server):
   Wird zusätzlich ein approve-feature-Kanal angegeben, landen neue Events zuerst dort. Admins sehen eine Vorschau mit Buttons (Approve, Delete, Ping @everyone) und entscheiden selbst, ob und wann das Event im öffentlichen Kanal erscheint.

---

/config-check (Neu)

Ein Diagnose-Tool für Server-Admins, das mit einem Klick prüft:

• Sind Event- und Freigabekanal gültig und erreichbar?
• Verfügt der Bot in beiden Kanälen über alle notwendigen Berechtigungen?
• Kann der Bot einen gültigen Server-Einladungslink generieren?

---

📋 3. Alle Befehle im Überblick

Dank der Discord-Autovervollständigung (Autocomplete) müsst ihr keine kryptischen Event-IDs mehr suchen: Tippt bei den Befehlen einfach die ersten Buchstaben des Event-Namens ein!

---

🔍 /event-info

Das Herzstück für alle Event-Informationen — vereint Detailansicht und gefilterte Suche in einem Befehl.

Option	Typ	Beschreibung
event	Optional	Name des Events (mit Such-Vorschlägen). Zeigt die vollständigen Event-Details mit Buttons.
day	Optional	Filtert Events nach Wochentag (Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday).
target_aud	Optional	Filtert nach Zielgruppe: Public (Alle), Business (Fachbesucher), Press (Presse), Exhibitor (Aussteller).
catering	Optional	Filtert nach Verpflegung: Free Food & Drinks, Free Drinks, Free Food.
free_only	Optional	Wenn true, werden nur Events mit kostenlosem Eintritt gelistet.
private	Optional	Ob die Antwort nur für dich sichtbar (ephemeral) sein soll (Standard: true).

• 💡 Ohne Optionen ausgeführt:
  Führt man /event-info ohne Optionen aus, erscheint an oberster Stelle ein praktischer Tipp-Kasten und ein interaktives Dropdown-Menü, über das sich die Liste jederzeit bequem nach Tag, Zielgruppe oder Catering filtern lässt.

---

🎟️ /rsvp [event] [display]

Verwalte deine Teilnahme an einem Event oder wirf einen Blick auf die Gästeliste.

• event (Pflichtfeld): Wähle das gewünschte Event bequem über die Autovervollständigung aus.
• display (Pflichtfeld):
  • RSVP Panel: Öffnet das kompakte Event-Panel mit den interaktiven Buttons für Zu- und Absagen.
  • List View: Zeigt die formatierte Teilnehmerliste aller Nutzer, die mit Going (✅) oder Maybe (❔) markiert sind.

---

💡 /suggest-event (Neu)

Community-Events oder Partys vorschlagen.

Öffnet ein übersichtliches Eingabe-Formular (Modal) mit folgenden Feldern:

1. Event Name (Pflicht)
2. Datum & Uhrzeit
3. Location / Veranstaltungsort
4. Link / Website zur Quelle
5. Details & Notizen (z. B. Einlassbedingungen, Freigetränke, Besonderheiten)

Nach dem Absenden wird der Vorschlag direkt an das Moderationsteam weitergeleitet.

---

📅 /events

Zeigt eine Übersicht mit Schnellzugriffs-Buttons zu den wichtigsten externen Community-Ressourcen:

• 🌐 Party & Event Guide (gamingpartys.de Website)
• 📊 Google Sheets Übersicht
• 🗓️ Google Calendar

---

❓ /help

Öffnet eine kompakte Kurzanleitung mit allen verfügbaren User- und Admin-Befehlen direkt in Discord.

---

🖱️ 4. Kontextmenü-Funktionen (Rechtsklick / Apps)

Zusätzlich zu den Slash-Befehlen bietet der Bot moderne Kontextmenüs:

👤 User-Kontextmenü: Event Profile

• So geht’s: Rechtsklick auf einen beliebigen User (oder am Smartphone: Profil öffnen ➔ ...) ➔ Apps ➔ Event Profile.
• Funktion: Zeigt eine private Übersicht aller Events an, bei denen dieser Nutzer aktuell als Going (✅) oder Maybe (❔) eingetragen ist – inklusive klickbarer Event-Links und Startzeiten.

🔄 Nachrichten-Kontextmenü: Refresh Event Post

• So geht’s: Rechtsklick auf eine beliebige Event-Nachricht des Bots ➔ Apps ➔ Refresh Event Post.
• Funktion: Aktualisiert den Event-Beitrag direkt an Ort und Stelle mit den neuesten Daten aus der Datenbank (Beschreibung, Zeiten, RSVP-Zähler), ohne eine neue Nachricht senden zu müssen.

---

🔘 5. Interaktive Buttons unter den Event-Posts

Unter jeder Event-Ankündigung befinden sich praktische Buttons:

Button	Aussehen	Funktion
Going	🟢 Going (X)	Trägt dich als sicherer Teilnehmer (✅) ein. Der Zähler auf dem Button erhöht sich sofort live.
Maybe	⚪ Maybe (Y)	Trägt dich als interessiert / vielleicht (❔) ein.
Not going	🔴 Not going (Z)	Trägt dich aus dem Event aus bzw. vermerkt deine Absage (❌).
RSVP List	🔵 RSVP List	Öffnet die aktuelle Teilnehmerliste des Events in einer privaten Nachricht.
Maps	⚪ Maps	Öffnet direkt Google Maps mit der hinterlegten Location (sofern Geodaten hinterlegt sind).
Create Event	🔵 Create Event	Erstellt aus den Daten automatisch ein natives Discord-Server-Event in eurem Server-Kalender.
Report Event	🔴 Report Event	Öffnet ein Melde-Formular, um veraltete oder fehlerhafte Event-Daten an das Bot-Team zu melden.

⚡ Echtzeit-Counter: Sobald ein User auf Going, Maybe oder Not going klickt, aktualisieren sich die Zahlen auf den Buttons direkt auf der Discord-Nachricht für alle sichtbar!

---

❓ Häufige Fragen & Fehlerbehebung (FAQ)

Warum postet der Bot keine neuen Events?

1. Führe /config-check aus. Der Bot teilt dir sofort mit, ob ein Kanal fehlt oder Berechtigungen fehlen.
2. Stelle sicher, dass der Bot im konfigurierten Kanal die Rechte Kanal anzeigen, Nachrichten senden und Links einbetten besitzt.
3. Falls das approve-feature eingerichtet ist: Prüfe den Freigabekanal – dort warten Events auf die Freigabe durch das Server-Team.

Können normale Mitglieder Events manipulieren?Nein. Normale Mitglieder können lediglich ihren eigenen Teilnahmestatus (RSVP) setzen, Events über `/suggest-event` vorschlagen oder fehlerhafte Daten melden. Konfigurationsbefehle wie /config und /config-check sind strikt auf Nutzer mit der Berechtigung „Server verwalten“ beschränkt.Wie ändere ich den Kanal für Events?Führe den Befehl /config einfach erneut mit dem neuen Kanal aus. Die vorherige Konfiguration wird automatisch überschrieben.

---

Offizielle Dokumentation bereitgestellt von gamingpartys.de.