Module

Nachrichten und Rollenwahl kombinieren

Beide Formate unterstützen Vorschau, Akzentfarben, Bilder, mehrere Einbettungen sowie das Aufklappen, Kopieren, Entfernen und Umsortieren der Einbettungen. V1 nutzt feste Discord-Felder, V2 frei angeordnete Blöcke. Die folgenden Abschnitte erklären die verfügbaren Eingaben und die Unterschiede.

Eine Rollen-Komposition einrichten

Zulässig sind nur Rollen unterhalb der höchsten Bot-Rolle und unterhalb deiner eigenen höchsten Rolle. Für Serverinhaber entfällt die eigene Hierarchiegrenze. @everyone, verwaltete Rollen sowie Rollen mit Serververwaltungs- oder Moderationsrechten, einschließlich Zugriff auf das Audit-Log, sind für öffentliche Selbstvergabe ausgeschlossen. Wenn du zuerst Rollen für eine noch unbeschriftete Option auswählst, wird der erste Rollenname als bearbeitbarer Vorschlag eingesetzt. Mitglieds- und Serverplatzhalter werden in diesem Modul nicht dynamisch ersetzt, der V2-Zeit-Token ist davon ausgenommen.

Benötigte Discord-Rechte

Fjord benötigt Kanal ansehen, Nachrichten senden und Links einbetten im Zielkanal sowie Rollen verwalten. Die Fjord-Rolle muss oberhalb aller zu vergebenden Rollen stehen. Verwaltete Rollen, @everyone und Rollen mit Verwaltungsrechten stehen nicht zur Auswahl.

Der interne Name ist auch für einen Entwurf Pflicht und darf höchstens 100 Zeichen enthalten. Ohne Zielkanal wird nur gespeichert. Zur Veröffentlichung sind ein erreichbarer Kanal und sichtbarer Text, eine Einbettung oder mindestens eine vollständige Rollenoption nötig. Jede angelegte Rollenoption braucht eine Beschriftung von 1–80 Zeichen und 1–25 zuweisbare Rollen. Emoji ist optional, eine Beschreibung von höchstens 100 Zeichen wird nur im Auswahlmenü angezeigt. Die Menübeschriftung vor der Auswahl ist optional, höchstens 150 Zeichen lang und verwendet ohne Eingabe den Standard. Bei Mehrfachauswahl ist die Höchstzahl gleichzeitig wählbarer Optionen einzustellen, maximal 25. Unvollständige Optionen müssen ausgefüllt oder entfernt werden, auch im Entwurf.

Nachrichteninhalt und Erwähnungen

Normaler Nachrichteninhalt darf höchstens 2.000 Zeichen enthalten. Mit den Einfügehilfen setzt du Rollen, Kanäle und Server-Emojis an der Schreibposition ein. In diesem Modul werden Erwähnungen ohne Ping veröffentlicht. Sie ersetzen keine Rollenoption.

Einbettungen gestalten

Discord zeigt das Autorensymbol nur an, wenn zusätzlich ein Autorenname eingetragen ist. Trage oben einen Namen ein, damit das Icon in der Vorschau erscheint. Discord zeigt das Footersymbol nur an, wenn zusätzlich ein Footertext eingetragen ist. Trage oben einen Text ein, damit das Icon in der Vorschau erscheint.

V2

Ein Bildblock kann als Galerie bis zu zehn Bilder enthalten. Mit „+ Weiteres Bild“ ergänzt du weitere Bilder, die sich einzeln entfernen lassen. Für jedes Bild und Thumbnail sind eine Bildbeschreibung mit bis zu 80 Zeichen und die Spoiler-Einstellung optional. Ein Abschnitt unterstützt bis zu drei Texte mit jeweils bis zu 4000 Zeichen. Mit „+ Weiterer Text“ ergänzt du bis zu zwei weitere Texte. Unter Zubehör wählst du zwischen Thumbnail und Link-Button. Der Link-Button benötigt eine Beschriftung mit bis zu 80 Zeichen und eine vollständige HTTP(S)-URL mit bis zu 512 Zeichen. Emoji und Deaktivierung sind optional. Die zusätzlichen Abschnittstexte und der Zubehör-Button zählen zum Komponentenlimit. Die einzelnen Bilder einer Galerie zählen nicht als zusätzliche Komponenten.

In V2 kannst du Container und Bilder, einschließlich Thumbnails, als Spoiler kennzeichnen. Ihr Inhalt ist zunächst verborgen und wird per Klick angezeigt.

V2 bietet bis zu zehn Container mit eigener Akzentfarbe. Verwende Textblöcke oder Abschnitte mit einem optionalen Thumbnail rechts, jeweils mit bis zu 4000 Zeichen und Markdown. Trennlinien können eine sichtbare Linie oder nur Abstand anzeigen, jeweils klein oder groß. Bausteine lassen sich hinzufügen, kopieren, entfernen und mit den Pfeilen umordnen. Leere Text- und Bildbausteine erzeugen keinen sichtbaren Inhalt. Die V2-Textbereiche bieten Rollen-, Kanal- und Server-Emoji-Auswahl.

V2 hat keine klassischen Autorenfelder, Titellink-Eingaben, Inline-Felder, Footericons oder einen Zeitstempelschalter. Überschriften und Links setzt du mit Markdown in Textblöcken. Eine kleine Fußzeile lässt sich mit dem unten gezeigten Markdown schreiben, ein Zeitstempel mit dem Zeit-Token. V1 bietet umgekehrt keine frei angeordneten V2-Blöcke. In einer Nachricht werden die beiden Formate nicht gemischt.

-# ... · {time.full}

Für V2 gilt eine gemeinsame Grenze von 40 Komponenten für die gesamte Nachricht. Container, Textanzeigen, Abschnitte, Thumbnail, Bildgalerie, Trennlinie, Aktionszeile, Button und Auswahlmenü zählen jeweils mit. Menüoptionen zählen nicht einzeln. Auch automatisch ergänzte Trennlinien und Bedienelemente verbrauchen das Budget. Ein Container mit Text, Bild, Trennlinie und einem Button samt Aktionszeile benötigt beispielsweise sechs Komponenten. Die zehn Container können daher nicht beliebig voll ausgestattet werden.

Bilder hochladen und prüfen

Die Bildgrenzen gelten pro Datei. In V1 dürfen Autorensymbol, Thumbnail und Footersymbol jeweils höchstens 5 MB groß sein. Die Grenze für das große Bild entspricht der unten angegebenen Grenze für Bildblöcke in V2. PNG, JPG/JPEG, WebP und GIF werden unterstützt. Datei auswählen ersetzt ein Bild, Entfernen leert den Bildplatz. Ohne zugehörigen Autoren- oder Footertext sind deren Icons nicht sichtbar.

Wähle PNG, JPG/JPEG, WebP oder GIF. Bilder werden beim Speichern hochgeladen. Thumbnails dürfen höchstens 5 MB groß sein, Bildblöcke höchstens 8 MB.

Rollenpakete, Buttons und Auswahlmenüs

Der interne Name ist auch für einen Entwurf Pflicht und darf höchstens 100 Zeichen enthalten. Ohne Zielkanal wird nur gespeichert. Zur Veröffentlichung sind ein erreichbarer Kanal und sichtbarer Text, eine Einbettung oder mindestens eine vollständige Rollenoption nötig. Jede angelegte Rollenoption braucht eine Beschriftung von 1–80 Zeichen und 1–25 zuweisbare Rollen. Emoji ist optional, eine Beschreibung von höchstens 100 Zeichen wird nur im Auswahlmenü angezeigt. Die Menübeschriftung vor der Auswahl ist optional, höchstens 150 Zeichen lang und verwendet ohne Eingabe den Standard. Bei Mehrfachauswahl ist die Höchstzahl gleichzeitig wählbarer Optionen einzustellen, maximal 25. Unvollständige Optionen müssen ausgefüllt oder entfernt werden, auch im Entwurf.

Buttons schalten ihr Rollenpaket um. Besitzt das Mitglied bereits alle Rollen des Pakets, werden sie entfernt. Andernfalls werden nur fehlende Rollen ergänzt. Andere Rollen bleiben unverändert. Die Vorschau verändert keine echten Rollen.

Buttons konfigurieren

Wähle Buttons, füge eine Option hinzu und trage Beschriftung und Zielrollen ein. Wähle bei Bedarf ein Emoji und einen der vier Buttonstile. Wiederhole dies für weitere Pakete und ordne die Optionen mit den Verschiebefunktionen an. Jede Option ist ein einzelner Button, auch wenn sie mehrere Rollen enthält.

Auswahlmenü konfigurieren

Mehrfachauswahl verwendet einen eingestellten Höchstwert von 2–25 Optionen. Sind weniger Optionen vorhanden, begrenzt die gesendete Nachricht die Auswahl automatisch auf deren Anzahl.

Wähle Auswahlmenü. Jede Option erhält Rollen, eine Beschriftung und optional Beschreibung und Emoji. Die Menübeschriftung erscheint vor der Auswahl. Mit „Erlaube Mitgliedern, mehrere Rollen auszuwählen“ aktivierst du die Mehrfachauswahl. „Maximale Auswahl“ begrenzt gleichzeitig wählbare Optionen, nicht die Rollen im Paket. Ohne Mehrfachauswahl kann ein Mitglied eine Option wählen.

Das Auswahlmenü gleicht die gesamte übermittelte Auswahl mit den Rollen des Mitglieds ab: Gewählte Rollen werden hinzugefügt, wenn sie fehlen, und behalten, wenn sie schon vorhanden sind. Nicht gewählte Rollen aus diesem Menü werden entfernt. Eine leere Auswahl entfernt alle Rollen dieses Menüs. Rollen außerhalb dieses Menüs bleiben unverändert. Bei überlappenden Paketen bleibt eine gemeinsame Rolle erhalten, solange eine gewählte Option sie benötigt.

Die Haken zeigen die Auswahl im Discord-Client, nicht zuverlässig den aktuellen Rollenbestand. Sie können nach einem Clientneustart oder in einem anderen Client fehlen. Wählt ein Mitglied dort nur eine Option, behält oder erhält es deren Rollen, alle anderen Rollen dieses Menüs werden entfernt. Eine bereits vorhandene, erneut ausgewählte Rolle bleibt erhalten. Der Bot setzt das Menü nach der Bedienung nicht zurück.

Komponente V1 / V2

Auch V2 fasst bis zu fünf Buttons in einer Aktionszeile zusammen. Ein Auswahlmenü benötigt seine eigene Zeile. Statt der V1-Grenze von fünf Zeilen gilt in V2 das gesamte Komponentenbudget.

Neue Kompositionen beginnen mit V2.

Wähle V1 oder V2 vor dem ersten Speichern. Danach ist die Version unveränderlich, auch bei einem Entwurf oder nach dem Entfernen der Veröffentlichung. Für ein anderes Format erstelle eine neue Komposition. Duplizieren erhält die Version. Gespeicherte V1-Nachrichten werden weder automatisch umgewandelt noch gelöscht.

V1 erlaubt mehrere unabhängige Rollenwahlen unter der gesamten Nachricht. Alle teilen sich höchstens fünf Aktionszeilen. Jedes Menü belegt eine Zeile, bis zu fünf Buttons teilen sich eine Zeile. Fünf Menüs sind daher nur ohne zusätzliche Buttonzeilen möglich. Jede Rollenwahl enthält höchstens 25 Optionen. V2 ordnet jedem Container eine eigene Rollenwahl mit Buttons oder einem Menü zu, deren Komponenten das gemeinsame Budget verbrauchen. Verschieben einer V1-Einbettung verschiebt keine unabhängige Rollenwahl. Dieses Modul bietet Rollenbuttons in Blau, Grau, Grün oder Rot. Es gibt keinen separaten Editor für zusätzliche Webseiten-Link-Button-Zeilen und kein einmaliges Senden. In einem V2-Abschnitt kannst du aber einen Link-Button als Zubehör statt eines Thumbnails wählen. Dieser öffnet eine Webseite und verändert keine Rollen.

V1

V1 verwendet klassische Discord-Einbettungen mit einer Akzentfarbe und fest angeordneten Bereichen. Bis zu zehn Einbettungen sind möglich. Die Zahlen in der Tabelle sind maximale Zeichenanzahlen. Autor, Titel, Beschreibung, Footer und alle Feldnamen und Feldwerte dürfen zusammen über sämtliche Einbettungen höchstens 6.000 Zeichen enthalten. Der normale Nachrichtentext zählt separat. Je V1-Einbettung sind höchstens 25 Felder möglich.

Alle Gestaltungsbereiche sind optional. Fügst du ein Feld hinzu, sind sowohl Feldname als auch Feldwert erforderlich. Entferne unbenutzte Felder. „Nebeneinander“ erlaubt Inline-Felder, deren endgültige Anordnung von Discord und der Bildschirmbreite abhängt. Autorenlink und Autorensymbol benötigen einen Autorennamen, Titellink einen Titel und Footersymbol einen Footertext. Die optionalen Links sind vollständige HTTP(S)-Adressen. Der Zeitstempel zeigt den Versandzeitpunkt.

Rollen- und Kanalauswahl gibt es im normalen Nachrichtentext, in der V1-Beschreibung und im Feldwert. In Autor, Titel, Footer und Feldname stehen diese Erwähnungsauswahlen nicht zur Verfügung. Server-Emojis sind in diesen Textbereichen möglich. Autoren-URL und Titellink sind reine URL-Eingaben ohne Rollen, Kanäle oder Emojis. Erwähnungen in klassischen Einbettungen lösen keine Benachrichtigung aus.

Grenzen und Bilder

Pro Server sind höchstens 50 Kompositionen und pro Komposition bis zu zehn Einbettungen möglich. Jede Rollenwahl enthält höchstens 25 Optionen. V2 erlaubt insgesamt 40 Komponenten, einschließlich Container, Text, Bilder, Aktionszeilen und Bedienelemente. Menüoptionen zählen nicht einzeln. Bilddateien dürfen höchstens 8 MB groß sein. Beachte das Komponentenbudget vor dem Speichern.

Discord-Vorschau verwenden

Die Vorschau zeigt Text, Reihenfolge, Bilder und Rollenbedienelemente im gewählten Format. Öffne das Menü oder betätige einen Button, um die Auswahl zu simulieren. Dies weist keinem echten Mitglied Rollen zu. Lade zuerst die Serverressourcen, damit die Rollen- und Emoji-Auswahl vollständig verfügbar ist. Prüfe die endgültige Vergabe nach dem Veröffentlichen in Discord.

Einbettungen verwalten

Klappe die Einbettungen zum Bearbeiten auf. Du kannst sie verschieben, duplizieren und entfernen. Beim Duplizieren eines V2-Containers wird auch dessen Rollenwahl kopiert. Wenn du den Container entfernst, entfällt seine Rollenwahl. Eine Kopie wird verhindert, wenn sie die Einbettungs- oder Komponentengrenze überschreiten würde.

Kompositionen besitzen einen internen Namen mit höchstens 100 Zeichen. Er erscheint nur im Dashboard. Eine duplizierte Komposition ist unabhängig vom Original. Prüfe ihren Kanal und die Rollenoptionen, bevor du sie veröffentlichst. Speichern übernimmt Änderungen. Abbrechen verwirft offene Änderungen.

Speichere oder verwirf offene Änderungen, bevor du eine andere Komposition bearbeitest, eine neue erstellst, duplizierst oder löschst.

Entwürfe und Veröffentlichungen verwalten

Speichern ohne Zielkanal erhält einen Entwurf. Mit Zielkanal wird die Nachricht veröffentlicht, spätere Änderungen aktualisieren dieselbe Nachricht. Bei einem Kanalwechsel wird zuerst im neuen Kanal veröffentlicht und anschließend die alte Veröffentlichung entfernt. Eine fehlende Discord-Nachricht wird beim erneuten Speichern neu veröffentlicht. Änderungen gelten erst nach dem Speichern.

Veröffentlichung entfernen löscht nur die Discord-Nachricht und erhält den Entwurf. Komposition löschen entfernt auch die zugehörige Veröffentlichung. Duplizieren erstellt eine eigene Kopie, deren Veröffentlichung du separat einrichtest.

Fehler beheben

Fehlen Rollen, prüfe Rollen verwalten, die Rollenhierarchie und die Verwaltungsrechte der Zielrollen. Schlägt die Veröffentlichung fehl, prüfe den Kanal und seine Rechte. Bei überschrittenem Komponentenbudget entferne Elemente. Teste die Rollenvergabe anschließend mit einem normalen Mitglied in Discord. Die Dashboard-Vorschau verändert keine Mitgliedsrollen.

Voraussetzungen und Grenzen

Eine gültige Gestaltung benötigt nicht alle optionalen Bereiche. Reine Farbe oder leere Bausteine ersetzen keinen sichtbaren Inhalt für eine Veröffentlichung. Die Vorschau sendet keine Nachricht und ersetzt keinen Test im Zielkanal. Beide Editoren bieten keine Abstimmungen, Sticker, Formulare oder frei programmierbaren Aktionen. Die Daten und Bearbeitungsmöglichkeiten hängen außerdem von den freigegebenen Dashboard-Rechten ab.

Vorschau, Spoiler und Bilddateien

In der V2-Vorschau behält ein einzelnes Galeriebild sein Seitenverhältnis. Mehrere Bilder erscheinen in einem Raster mit gleich großen Ausschnitten im Format 16:9. Zwei oder vier Bilder stehen in zwei Spalten, drei sowie fünf bis zehn Bilder in drei Spalten. Ein Thumbnail steht rechts neben dem Abschnittstext. Die Bildbeschreibung dient als Alternativtext und erscheint nicht als zusätzliche Bildunterschrift.

Die Bild- und Container-Spoilerschalter gehören zum V2-Editor. Einzelne Galeriebilder und Thumbnails lassen sich unabhängig verdecken. Ein Container-Spoiler verdeckt den Inhalt, während der äußere Rahmen sichtbar bleibt. Ein Klick deckt den Inhalt in der Vorschau auf, ohne die gespeicherte Spoilereinstellung zu ändern. Auch Mitglieder können Spoiler in Discord per Klick aufdecken.

Für Nachrichtenbilder werden PNG, JPG/JPEG, WebP und GIF akzeptiert. Dateityp und Bildinhalt müssen zusammenpassen. Eine geänderte Dateiendung macht aus einer HTML- oder SVG-Datei kein unterstütztes Bild. Die Dateigrößen aus den Bildtabellen gelten weiterhin pro Datei. Wird ein lokales Bild abgelehnt oder kann es nicht mehr gelesen werden, wähle die Originaldatei erneut aus und speichere noch einmal.

Markdown-Textbereiche unterstützen Web- und E-Mail-Links. Die Vorschau öffnet HTTP(S)- und mailto-Links, aber keine Links auf lokale Dateien oder Blob-Adressen. Autorenlinks, Titellinks und Link-Buttons benötigen vollständige HTTP(S)-URLs. Die Vorschau veröffentlicht keine Nachricht. Prüfe das gespeicherte Ergebnis in Discord, dessen Darstellung je nach Client und Bildschirmbreite abweichen kann.