Skip to content

Cog Management DE

Domekologe edited this page Jun 30, 2026 · 1 revision

Cog-Verwaltung

🌐 English · Deutsch

Die Seite /cogs ist die Zentrale des Bot-Owners für alles rund um Cogs und Befehle. Sie ist auf bot_owner beschränkt und bündelt vier Bereiche in Tabs: geladene Cogs verwalten, den Downloader (Repos und Updates), Slash-Befehlssteuerung und globale Owner-Panels einzelner Cogs. Alles hier läuft als serverseitiger RPC-Call zum Bot; siehe API & Gateway zu den zugrundeliegenden Methoden.

Screenshot: die Verwaltungsseite /cogs

Tab „Cogs" – laden / entladen / neu laden

Listet jeden installierten Cog mit Ladezustand, Herkunfts-Repo und ob er Dashboard-Inhalte beisteuert. Ein Repo-Filter-Dropdown grenzt die Liste ein; Cogs ohne Repo (Reds Core-Cogs) erhalten eine „System"-Pille. Pro Cog möglich:

Aktion Effekt
Laden Lädt den Cog und nimmt ihn in Reds Paketliste auf.
Entladen Entlädt ihn und entfernt ihn aus der Paketliste.
Neu laden Entladen + Laden, übernimmt Codeänderungen.

Die Pflicht-Cogs pdc_webdashboard und pdc_webdashboard_stats lassen sich aktivieren, ihr Schalter ist im geladenen Zustand jedoch gesperrt – ein Pflicht-Cog kann nicht entladen werden, nur geladen, wenn er aus ist.

Das Neuladen des pdc_webdashboard-Cogs selbst wird gesondert behandelt: Der Reload wird ~1 Sekunde verzögert, damit die aktuelle Antwort noch rausgeht, bevor das Gateway neu startet. Ein Klick auf Neu laden bei pdc_webdashboard öffnet einen Bestätigungsdialog (er startet das RPC-Gateway neu, mit dem diese Seite spricht) mit der empfohlenen Reihenfolge – erst pdc_webdashboard neu laden, ~10 s warten, dann abhängige Cogs – gefolgt von einem Countdown, der die Seite nach Bestätigung automatisch neu lädt. Dieser Dialog erscheint nur beim Cog pdc_webdashboard.

Tab „Downloader"

Eine Sicht auf Reds Downloader: Repositories werden als aufklappbare Abschnitte gezeigt, jeweils mit Repo-Pill beschriftet. In einem Repo siehst du seine installierten Cogs (mit Commit) und die installierbaren Cogs.

Aktion Wirkung
Update-Check Führt git fetch + Update aller Repos aus und meldet, welche Repos sich geändert haben und für welche installierten Cogs nun ein Update verfügbar ist.
Aktualisieren (pro Cog) Bringt einen einzelnen installierten Cog auf den neuesten Repo-Stand und führt dann automatisch ReloadSlash-Sync aus, damit die Änderung sofort live ist.
Installieren Installiert einen verfügbaren Cog aus einem Repo (danach per Laden aktivieren).
Deinstallieren Entlädt, entfernt die Dateien und synchronisiert Slash-Befehle neu.
Repo hinzufügen / entfernen Repositories verwalten (ein Repo mit installierten Cogs lässt sich erst entfernen, wenn diese deinstalliert sind).

Das Aktualisieren pro Cog ist der zentrale Komfort: Es verkettet Update → Reload → Slash-Sync in einem Klick, sodass du nicht drei Befehle einzeln ausführen musst.

Screenshot: Downloader Tab

Screenshot: Downloader mit aufklappbaren Repos und Update-Badges

Tab „Slash"

Listet Application-Befehle (Slash / Kontextmenü) nach Cog gruppiert, inklusive aktuell deaktivierter Befehle (Red entfernt deaktivierte Befehle aus dem Live-Tree, daher liest das Dashboard sie zusätzlich aus der Definition jedes Cogs, um sie anzuzeigen). Möglich:

  • Einzelnen Befehl an/aus schalten.
  • Alle Befehle eines Cogs auf einmal an/aus.
  • Den Befehls-Tree zu Discord synchronisieren.

Aktivieren/Deaktivieren wirkt sofort in Reds Config; ein Sync schiebt die Änderung zu Discord, damit sie im Client erscheint (oder verschwindet). (Neu hinzugefügte Hybrid-Slash-Befehle sind in Red zunächst deaktiviert.)

Eine rote Gruppe „(Nicht existent)" am Ende listet Discord-Registrierungen, die kein geladener Cog mehr trägt (Waisen / Ghosts). Mit dem Button Mit Discord synchronisieren entfernen.

Screenshot: Slash-Tab nach Cog gruppiert mit Schaltern

Tab „Global"

Manche Cogs steuern globale Owner-Panels bei – botweite Konfiguration, die nicht an eine einzelne Gilde gebunden ist. Sie erscheinen hier als Tabs, einer pro beitragendem Cog, jeweils mit dem deklarativen Formular des Cogs. Hier liegen die botweiten Cog-Settings, getrennt von den gildenbezogenen Panels in den Gilden-Einstellungen.

Verwandte Seiten

  • Web-UI – der Rest des Dashboards
  • Cog-Integration – wie ein Cog Panels/Widgets/Listen bereitstellt
  • API & Gateway – die cogs.*-, downloader.*- und slash.*-Methoden
  • Self-Update – die Web-App selbst aktualisieren (nicht die Cogs)

Clone this wiki locally