AdminUtils DE

AdminUtils

🌐 English · Deutsch

AdminUtils bündelt die alltäglichen Moderationsaktionen eines Discord-Servers in einem einzigen Cog aus Slash-/Hybrid-Befehlen: Kicken, Bannen, Timeout, Nachrichten löschen (mit Ausnahmelisten), Nachrichten zwischen Kanälen verschieben, Mitglieder zwischen Voice-Kanälen bewegen und Rollenrechte kopieren. Jede Erfolgsmeldung ist eine pro-Guild-Vorlage, die du an den Ton deines Servers anpassen kannst, und der gesamte Cog bindet sich automatisch in das PDC Web Dashboard ein, sodass Admins diese Vorlagen direkt im Browser bearbeiten können. Autor: pd-codes · benötigt Red 3.5.0+.

Installation

[p]repo add PDC_Redbot_Cogs https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC_Redbot_Cogs AdminUtils
[p]load AdminUtils
[p]slash sync

[p] ist das Präfix deines Bots. Die vollständige Downloader-Anleitung findest du unter Installation. Da mehrere Befehle ausschließlich als Slash funktionieren (siehe Befehlstabelle), ist ein einmaliges [p]slash sync nach dem Laden erforderlich.

Befehle

kick, ban, timeout, purge, purgefast und messagemove sind Hybrid-Befehle — nutzbar sowohl als [p]befehl als auch als /befehl. Die übrigen vier sind als native Application Commands registriert und funktionieren nur als Slash-Befehl.

Befehl	Typ	Parameter	Funktion
kick	Hybrid	member, reason?	Kickt ein Mitglied und postet die Vorlage kick_success.
ban	Hybrid	member, reason?, delete_message_days? (0–7)	Bannt ein Mitglied und löscht optional dessen jüngste Nachrichten. Postet ban_success.
timeout	Hybrid	member, minutes (1–40320), reason?	Versetzt ein Mitglied bis zu 28 Tage in Timeout. Postet timeout_success.
purge	Hybrid	amount (1–500), except_users?	Löscht bis zu amount Nachrichten. Schneller Bulk-Durchlauf für Nachrichten ≤ 14 Tage, danach werden ältere einzeln gelöscht. Überspringt angepinnte Nachrichten und alle in except_users Genannten. Postet purge_success.
purgefast	Hybrid	amount (1–500), except_users?	Bulk-only-Löschung — nur Nachrichten jünger als 14 Tage (Discords Bulk-Limit). Deutlich schneller als purge, ältere Nachrichten bleiben aber unberührt.
messagemove	Hybrid	message (ID oder Link), destination, delete_original? (Standard true)	Kopiert eine Nachricht (Text + Anhänge) in einen Zielkanal/-Thread und löscht das Original, sofern nicht anders angegeben.
move-memberall	nur Slash	source_channel, dest_channel	Verschiebt alle Mitglieder aus einem Voice-Kanal in einen anderen.
move-member	nur Slash	source_channel, dest_channel	Öffnet ein ephemeres Auswahlmenü (max. 25 Mitglieder) plus Bestätigen-/Abbrechen-Buttons und verschiebt dann nur die ausgewählten Mitglieder.
copy-channelrole	nur Slash	channel, source_role, dest_role	Kopiert das Permission-Overwrite eines einzelnen Kanals von einer Rolle auf eine andere.
copy-role	nur Slash	source_role, target_role_name	Erstellt eine völlig neue Rolle, die Serverrechte, Farbe, Hoist-/Mentionable-Flags, Icon, Channel-Overwrites und Position der Quellrolle übernimmt.

Zu except_users

Bei purge und purgefast wird except_users als durch Leerzeichen getrennte Liste übergeben. Jeder Eintrag kann eine Erwähnung (@user), eine reine User-ID oder ein Name sein — Namen werden gegen die Guild aufgelöst: zuerst exakter Anzeigename, dann exakter Username, dann eine unscharfe „enthält"-Suche. Nachrichten der gefundenen User (und alle angepinnten Nachrichten) bleiben erhalten.

Konfiguration — Vorlagen für Erfolgsmeldungen

AdminUtils speichert vier Nachrichtenvorlagen pro Guild (Red Config, Identifier 708921553001). Bei Erfolg eines Befehls wird die passende Vorlage formatiert und als Antwort gesendet (bei Slash-Nutzung ephemeral). Die Standardwerte sind auf Deutsch; passe sie frei an.

Vorlagen-Key	Genutzt von	Verfügbare Variablen	Standard
kick_success	kick	{member}, {reason}	✅ {member} wurde gekickt. Grund: {reason}
ban_success	ban	{member}, {reason}, {delete_days}	✅ {member} wurde gebannt. Grund: {reason} | Nachrichten: {delete_days} Tage
timeout_success	timeout	{member}, {reason}, {minutes}	✅ {member} ist {minutes} Minuten im Timeout. Grund: {reason}
purge_success	purge	{deleted}, {exceptions}	✅ {deleted} Nachrichten gelöscht. Ausnahmen: {exceptions}

Alle Vorlagenvariablen des Cogs: {member}, {reason}, {minutes}, {delete_days}, {deleted}, {exceptions}. Verwende pro Key nur die jeweils gelisteten Variablen — ein unbekannter Platzhalter bleibt unverändert stehen.

purgefast antwortet mit einer festen Meldung und nutzt keine Vorlage. purge greift nur dann auf purge_success zurück, wenn nicht bereits eine Live-Fortschrittsmeldung angezeigt wurde.

Dashboard-Integration

AdminUtils registriert sich beim Laden automatisch sowohl beim AAA3A-Dashboard als auch beim PDC Web Dashboard (und hängt sich nach, falls das Dashboard-Cog erst später geladen wird). Es bietet drei Oberflächen:

Oberfläche	Mount	Berechtigung	Zweck
Widget „AdminUtils Templates"	Dashboard-Startseite (KPI, klein)	guild_member	Zeigt, wie viele Vorlagen konfiguriert sind.
Panel „Moderations-Nachrichten"	guild_settings	guild_admin	Bearbeitet die Kick-/Ban-/Timeout-/Purge-Vorlagen mit Variablen-Hinweisen pro Feld.
Eigenständige Seite adminutils	eigene Seite (GET/POST)	manage_guild / Bot-Owner	Vollseiten-Editor für alle vier Vorlagen.

Berechtigungen & Hinweise

Jeder Befehl ist doppelt abgesichert — der ausführende User muss die Discord-Berechtigung besitzen, und der Bot ebenfalls (bot_has_guild_permissions):

Befehl(e)	Erforderliche Berechtigung (User + Bot)
kick	kick_members
ban	ban_members
timeout	moderate_members
purge, purgefast, messagemove	manage_messages (+ read_message_history)
move-memberall, move-member	move_members
copy-channelrole, copy-role	manage_roles

Bei copy-role muss die höchste eigene Rolle des Bots über der Quellrolle stehen, sonst scheitern Rollenerstellung oder Positionsübernahme. Der Cog speichert keine personenbezogenen Daten — nur die pro-Guild-Vorlagen.

Siehe auch: Installation · Dashboard-Integration · Start