Direkt zum Hauptinhalt

Components V2 Panel

Components V2 Panel

Der moderne Panel-Stil — seit V2 verwendet das Ticket-Panel die neue Discord Components V2 API

Was ist Components V2?

Discord hat 2024 eine neue Komponenten-API veröffentlicht, die deutlich mehr Layout-Möglichkeiten bietet als klassische Embeds. Quantix Tickets nutzt sie für das Ticket-Panel.

Feature V1 (Embed) V2 (Container)
Akzent-Farbe ✅ ✅
Title + Description ✅ ✅ (TextDisplay)
Image Unter Text MediaGallery
Thumbnail Klein, oben rechts Section-Accessory
Buttons + Select Separat unter Embed Im Container integriert
Position-Wahl Nicht möglich Above / Below
6000-Char-Cap ✅ ❌

Das neue Panel-Layout

┌─────────────────────────────────┐
│ ▌🎟️ Ticket erstellen           │ ← Section + Thumbnail
│ ▌ Klicke auf den Button um...  │
│ ▌                          [📷] │
├─────────────────────────────────┤
│ [Topic auswählen…]             ▼│ ← Select / Button-Row
│                                 │
│ -# Quantix Tickets ©           │ ← Footer (subtext)
└─────────────────────────────────┘

Der vertikale Strich links ist der Akzent-Farb-Border (panelEmbed.color).

Position-Toggle

Sidebar → Tickets → Panel senden → Anzeige-Modus

Über dem Embed:

[Topic auswählen…] ▼     ← oben
─────────────────────
🎟️ Ticket erstellen     ← Embed-Body

Unter dem Embed (Standard):

🎟️ Ticket erstellen     ← Embed-Body
─────────────────────
[Topic auswählen…] ▼     ← unten

Wechseln wirkt live in der Vorschau im Panel.

Display-Modi

Select-Menü (Default)

Ein einzelnes Dropdown mit allen Topics. Gut für viele Topics (>3).

Buttons

Pro Topic ein Button. Max 5 pro Reihe, max 25 Topics insgesamt. Gut für wenige Topics (1–5) wo Direkt-Click schneller geht.

Image vs. Thumbnail

Thumbnail (klein, rechts oben)

  • Erscheint als Section-Accessory rechts neben Titel + Beschreibung
  • Empfohlen: 256 × 256 Pixel (quadratisch)
  • Gut für Logo / Server-Icon

Image (volle Breite)

  • Erscheint als MediaGallery unter dem Embed-Body
  • Empfohlen: 1280 × 320 Pixel (Banner-Format)
  • Gut für visuelle Eyecatcher

Beide gleichzeitig sind möglich — Container hat genug Platz.

Bearbeiten statt Neusenden

Zwei Buttons im Panel:

  • "Panel senden" — postet eine neue Panel-Nachricht
  • "Bearbeiten" — editiert die bestehende Panel-Nachricht

Bearbeiten geht nur, wenn schon mal ein Panel gesendet wurde (cfg.panelMessageId gespeichert). Wenn die Original-Message gelöscht wurde, fällt der Bot automatisch auf "neu senden" zurück.

Wenn das Senden fehlschlägt

Image/Thumbnail-URL ungültig:

Discord rejected das Embed mit einem 50035 (Invalid Form Body) Fehler. Das Panel:

  1. Loggt den Field-Level-Error (welche URL genau)
  2. Retried automatisch ohne Bilder
  3. Postet das Panel trotzdem (Text-only)
  4. Zeigt dir Warning was Discord abgelehnt hat

So gehst du nie mit "Server-Error" leer aus.

Topic-Select reset

Nach Auswahl eines Topics resettet sich die Dropdown-Anzeige automatisch — der Bot editiert das Panel-Message in-place mit refreshter Komponente. Funktioniert auch bei V2-Panels (kein Downgrade auf V1).

nach oben