> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plugins.avenvault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AeroDesk Häufig gestellte Fragen

> Häufige Fragen zu AeroDesk-Einrichtung und -Funktionalität: Slash-Befehl-Registrierung, MongoDB-Fehler und Ticket-Sperrprobleme.

Hier sind die häufigsten Probleme, auf die Server-Administratoren stoßen, und wie du sie löst.

## Einrichtung und Konfiguration

### Wie finde ich Rollen-IDs und Kanal-IDs für die Konfiguration?

Du musst den Entwicklermodus in Discord aktivieren.

<Steps>
  <Step title="Entwicklermodus aktivieren">
    Gehe zu den Discord-Einstellungen > Erweitert > Aktiviere den Entwicklermodus.
  </Step>

  <Step title="ID kopieren">
    Mache einen Rechtsklick auf eine beliebige Rolle, einen Kanal oder einen Benutzer und klicke ganz unten im Menü auf **Kanal-ID kopieren** oder **Rollen-ID kopieren**.
  </Step>
</Steps>

### Ich habe den Bot eingeladen, aber ich sehe `/ticketpanel` oder `/stats` nicht?

Slash-Befehle benötigen bestimmte Berechtigungsbereiche (Scopes), um registriert zu werden.

<Steps>
  <Step title="Scope prüfen">
    Stelle sicher, dass du den Bot mit aktiviertem `applications.commands`-Scope im OAuth2-URL-Generator eingeladen hast.
  </Step>

  <Step title="Bot neu einladen">
    Werfe den Bot vom Server und lade ihn mit der korrekten URL erneut ein.
  </Step>
</Steps>

<Tip>
  Du kannst versuchen, F5 zu drücken, aber globale Slash-Befehle können manchmal bis zu einer Stunde brauchen, um sich nativ über alle Discord-Server zu synchronisieren, obwohl sie normalerweise sofort erscheinen.
</Tip>

## Funktionalität und Fehler

### Der Bot gibt eine `MongoTimeoutException` in der Konsole aus und stürzt ab.

Das bedeutet, dass der Bot deine MongoDB-Datenbank nicht erreichen kann.

<Steps>
  <Step title="URI prüfen">
    Überprüfe deine `config.yml`, um sicherzustellen, dass die `database.uri` korrekt formatiert ist.
  </Step>

  <Step title="IP-Whitelist prüfen">
    Wenn du MongoDB Atlas (Cloud) verwendest, stelle sicher, dass du die IP-Adresse deines Servers im Reiter **Network Access** auf die Whitelist gesetzt hast (oder richte sie auf `0.0.0.0/0` ein, um alle IPs zuzulassen).
  </Step>
</Steps>

### Wenn ein Teammitglied ein Ticket übernimmt, wird der Kanal nicht gesperrt!

Das ist fast immer ein Problem mit der Discord-Rollenhierarchie oder den Berechtigungen.

<Steps>
  <Step title="Claim-Modus prüfen">
    Stelle sicher, dass `enableClaimRemoval: true` in deiner Konfiguration für diese Kategorie eingestellt ist.
  </Step>

  <Step title="Bot-Rolle positionieren">
    Stelle sicher, dass die höchste Rolle des Bots in deinen Discord-Servereinstellungen über den Team-Rollen platziert ist. Der Bot kann keine Berechtigungen von Rollen entfernen, die höher als seine eigene sind.
  </Step>

  <Step title="Berechtigungen prüfen">
    Stelle sicher, dass der Bot über die Berechtigungen **Kanäle verwalten** und **Rollen verwalten** verfügt (die Berechtigung **Administrator** wird jedoch empfohlen).
  </Step>
</Steps>

### Warum generieren die HTML-Transkripte keinen Link?

Der Bot lädt die generierte HTML-Datei über die in deiner Konfiguration angegebene `logsChannelId` direkt auf das Discord-CDN hoch. Wenn der Bot in diesem speziellen verdeckten Log-Kanal nicht über die Berechtigung **Dateien anhängen** oder **Nachrichten senden** verfügt, schlägt der Upload fehl und es kann kein Link generiert werden. Überprüfe die Kanalberechtigungen!