CPS Utility Bot — Handbuch

Zugang & Bewerbung

Der Bot ist nicht öffentlich verfügbar. Um Zugang zu erhalten, bewirb dich über unser Discord mit folgenden Informationen:

• Servername und thematische Ausrichtung
• Aktuelle Mitgliederzahl
• Welche Features du nutzen möchtest
• Die Server-ID (Guild ID)

Nach Genehmigung schaltet der Bot-Owner den Bot für deinen Server frei.

Setup-Reihenfolge

Die Einrichtung erfolgt in drei Schritten:

Setup-Assistent (/start)

Der Wizard führt durch alle Konfigurationsbereiche:

• Auto-Logger — Kanal oder Forum, alle Events
• Ticket/Support Log — Kanal für Transkripte
• Chat-Support — Ticket-Kategorie und Support-Rollen
• Voice-Support — Struktur (Option A/B) und Benachrichtigung
• Auto-Roles — Rollen für neue User/Bots
• Welcome/Goodbye — Kanäle und Nachrichten
• Vorschläge — Vorschlagskanal
• Custom Voice — Join-to-Create Kanal
• Ankündigung — Kanal für Studio-Ankündigungen

Einstellungen ändern

Nach Abschluss von /start können Einstellungen nur noch über /edit angepasst werden. Dabei wählt man gezielt einen Bereich aus und konfiguriert nur diesen — alle anderen Einstellungen bleiben unberührt.

🎫 Support-System

Über /support wird ein Ticket-Kanal in der konfigurierten Kategorie erstellt. Nur der Ersteller, Support-Rollen und Moderatoren können das Ticket schließen. Beim Schließen wird automatisch ein Transkript erstellt und an den Supporter und den Log-Kanal gesendet.

🎙️ Voice-Support

Vollautomatisch über den Warteraum. Zwei Strukturoptionen:

• Option A (Lounge): Supporter geht in die Lounge → klickt Übernehmen → neuer Support-Kanal wird erstellt
• Option B (Räume): Vorkonfigurierte Support-Räume — Supporter geht rein → User wird verschoben

Benachrichtigung per DM oder Sammelruf-Kanal wählbar. Nach der Session: Transkript via Modal.

📋 Auto-Logger

Loggt über 25 Events — wahlweise in einem Kanal oder einem Forum (mit eigenem Thread pro Typ):

• Mitglied beigetreten/verlassen, Ban/Unban, Timeout
• Nachrichten gelöscht/bearbeitet, Massen-Löschung
• Rollen & Nicknames geändert, Rollen erstellt/gelöscht
• Kanal erstellt/gelöscht/bearbeitet
• AutoMod ausgelöst, Server-Boost, Geplante Events
• Webhooks, Stage-Channels, Bots hinzugefügt
• Commands ausgeführt, Pins aktualisiert

🔊 Custom Voice Channels

User betritt den Join-to-Create Kanal → Bot erstellt automatisch [Name]'s Channel → User wird verschoben → Kanal löscht sich wenn leer.

Channel-Owner kann über /voice Commands seinen Kanal verwalten: sperren, umbenennen, Limit setzen, User erlauben/blockieren.

👋 Welcome / Goodbye

Automatische Nachrichten bei Beitritt und Verlassen. Format (Embed oder Text) und Nachricht frei konfigurierbar mit Variablen: {user} {server} {membercount} {usertag} {userid}

📣 Embeds senden

Moderatoren können mit /emblem Embeds direkt in den aktuellen Kanal senden. Zwei Modi stehen zur Verfügung:

• Text: Nachricht eingeben, Stil (Normal/Info/Warnung/Wichtig), optionaler Titel und Bild
• JSON: Vollständiges Discord-Embed als JSON-Objekt — ideal für komplexe Layouts

Der Owner-Command /gondorsleuchtfeuer nutzt dasselbe System, sendet die Nachricht aber an den Ankündigungs-Kanal aller verbundenen Partner-Server gleichzeitig.

💡 Vorschlagssystem

Via /suggest wird ein Embed mit 👍/👎 Buttons gepostet. Jeder User hat eine Stimme. Moderatoren können den Status ändern: Offen → In Prüfung → Angenommen/Abgelehnt. Das Embed aktualisiert sich entsprechend.

🔗 Multi-Server Sync

Bans werden automatisch auf alle verbundenen Server übertragen. Kicks vom Primär-Server werden ebenfalls synchronisiert. Warns und Timeouts per Bot-Befehl können ebenfalls server-übergreifend vergeben werden.

Konzept

Communities mit mehreren Discord-Servern können diese mit dem Bot verknüpfen. Ein Primär-Server dient als Verwaltungszentrale, beliebig viele Sekundär-Server können sich damit verbinden.

Setup für Zweit-Server

• Bot auf dem Zweit-Server einladen und mit /activate freischalten
• Auf dem Zweit-Server /connect <Haupt-Server-ID> ausführen
• Fertig — keine weitere Konfiguration nötig

Was wird übernommen?

Einstellung	Von
Admin- & Mod-Rollen	Primär-Server
Log-Kanal	Primär-Server
Support-Einstellungen	Primär-Server
Tickets → landen auf	Primär-Server
Ankündigungs-Kanal	Optional lokal

Berechtigungen auf Zweit-Servern

Admins und Moderatoren werden anhand ihrer Rollen auf dem Primär-Server erkannt — unabhängig davon welche Rollen sie auf dem Zweit-Server haben.

Moderation Sync

• 🔨 Bans werden immer auf alle Netzwerk-Server übertragen
• 👢 Kicks vom Primär-Server werden auf alle Sekundär-Server übertragen
• ⚠️ Warns und Timeouts via Bot-Befehl können server-übergreifend vergeben werden

Einschränkungen

• Sekundär-Server können nicht selbst als Primär-Server dienen (keine Ketten)
• /start und /setup sind auf Sekundär-Servern gesperrt
• Änderungen an Einstellungen nur über erneutes /connect möglich