Fjord

Fjord Dokumentation

Module

01

Willkommen

Begrüße neue Mitglieder, verabschiede austretende Nutzer und vergib beim Beitritt automatisch Rollen.

Enthaltene Funktionen

  • Individuelle Begrüßungs- und Abschiedsnachrichten
  • Willkommenskarten mit eigener Gestaltung
  • Automatische Rollen für neue Mitglieder
  • Getrennte Kanäle für Ankunft und Abschied

Was kann Willkommen?

Mit Willkommen kannst du neue Mitglieder automatisch begrüßen, austretende Mitglieder verabschieden und beim Beitritt Rollen vergeben. Alle drei Bereiche lassen sich unabhängig voneinander verwenden.

Benötigte Discord-Rechte

Kanal ansehen Nachrichten senden Dateien anhängen Rollen verwalten Links einbettenNicht allgemein erwähnbare Rollen erwähnen

Dieses Recht benötigt Fjord nur, wenn der normale Text einer Begrüßungs- oder Abschiedsnachricht eine nicht allgemein erwähnbare Rolle pingen soll. @everyone und @here werden im Willkommenssystem blockiert und funktionieren dort nicht.

„Dateien anhängen“ wird für die Willkommenskarte benötigt. „Rollen verwalten“ ist nur für automatische Rollen erforderlich.

Einrichtung

  1. Wähle den Server aus, den du verwalten möchtest.
  2. Öffne Willkommen.
  3. Aktiviere die Begrüßung, den Abschied oder die automatischen Rollen.
  4. Wähle einen erreichbaren Textkanal beziehungsweise mindestens eine Rolle.
  5. Prüfe die Vorschau und speichere die Änderungen.

Für automatische Rollen muss die Fjord-Rolle oberhalb aller Rollen stehen, die vergeben werden sollen.

Begrüßungsnachricht

Der Schalter und die Kanalauswahl lassen sich getrennt bearbeiten. Ausschalten erhält den gewählten Kanal. „Kein Kanal“ leert zunächst nur die Auswahl, der Editor bleibt zugänglich. Erst beim Speichern ohne Kanal wird der betreffende Dienst deaktiviert und der Nachrichteneditor geschlossen. Das gilt für Willkommen und Abschied.

Die Begrüßungsnachricht wird gesendet, sobald ein Mitglied dem Server beitritt. Kanal, Nachrichtentext und Willkommenskarte werden gemeinsam gespeichert. Eine Vorschau zeigt vor dem Speichern, wie Text und Karte zusammenspielen.

Begrüßungsnachricht sendenOptional

Schaltet die automatische Begrüßung ein oder aus.

KanalPflicht bei Aktivierung

Legt fest, in welchem erreichbaren Textkanal die Begrüßung veröffentlicht wird.

NachrichtOptional

Enthält den normalen Nachrichtentext. Platzhalter, Rollen, Kanäle und Server-Emojis können über die Auswahlen eingesetzt werden.

WillkommenskarteOptional

Fügt der Begrüßung eine persönlich gestaltete Bildkarte hinzu.

Platzhalter für Nachrichten

PlatzhalterWird ersetzt durchBeispiel
{member.user.name}Discord-Benutzername des Mitgliedscorvus48
{member.mention}Erwähnung des neuen Mitglieds@Mira
{member.user.id}Discord-Benutzer-ID des Mitglieds123456789012345678
{member.user.global_name}Globaler Anzeigename des MitgliedsMira
{guild.name}Name des ServersFjord Community
{guild.member_count}Aktuelle Mitgliederzahl1.248

Nutze die Platzhalter-Auswahl im Editor. So wird der Name exakt eingesetzt und Tippfehler in geschweiften Klammern werden vermieden.

Nachrichteneditoren und Kartenanhänge

{guild.icon}Server-Icon
{member.avatar}Avatar des Mitglieds

Ohne gespeicherte Gestaltung ist bei Willkommen die Karte eingeschaltet und die Einbettung ausgeschaltet. Abschied beginnt mit normalem Text ohne Einbettung und ohne Karte. Begrüßung, Abschied und Rollenvergabe werden unabhängig aktiviert. Beide Nachrichteneditoren bieten V1 und V2, optionalen Text und optionale Einbettungen. Der Schalter für die generierte Karte steht im Begrüßungseditor. Ein leerer Nachrichtentext verwendet den angezeigten Standardtext.

Nachrichteninhalt bis zu 1.800 Zeichen, getrennt vom Einbettungstext.

Willkommen und Abschied haben jeweils eine eigene V1/V2-Auswahl. Ein Wechsel verlangt eine Bestätigung und setzt den Nachrichtentext, die Einbettungen, Bilder und Link-Buttons des betreffenden Editors zurück. Kanal, Aktivierung und das separate Kartendesign bleiben erhalten. Erst Speichern übernimmt den Wechsel. Abbrechen stellt den vorherigen gespeicherten Stand wieder her.

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.

EingabeZeichenlimitStatus
Autor256Optional
Autor URL512Optional
Titel256Optional
Titellink (optional)512Optional
Beschreibung4096Optional
Footertext2048Optional
Feldname256Pflicht nach Hinzufügen
Feldwert1024Pflicht nach Hinzufügen

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.

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}

Container

Schnellfarben · 10

Textblock

Markdown · 4000

Abschnitt mit Thumbnail

Markdown · 4000 · Thumbnail ≤ 5 MB

Bild

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

Trennlinie

Trennlinie anzeigen · Klein / Groß

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.

Die sechs Nachrichtenplatzhalter gelten auch für die Textbereiche beider Einbettungsformate. Ohne globalen Anzeigenamen wird der Benutzername verwendet. Der Mitglieds-Erwähnungsplatzhalter steht nicht in V1-Bereichen zur Auswahl, die keine Erwähnungen unterstützen. Für V1-Autorensymbol, Thumbnail, großes Bild und Footersymbol sowie für V2-Thumbnails und Bildblöcke kannst du ein eigenes Bild, das Server-Icon oder den Mitgliedsavatar wählen. Ohne Server-Icon bleibt das Bild leer. Die Vorschau nutzt dein Konto, die gesendete Nachricht das tatsächliche Mitglied. Diese dynamischen Bildquellen gibt es nur bei Willkommen und Abschied.

Bei ausgeschalteter Einbettung wird die aktivierte Willkommenskarte als eigenes Bild mit dem normalen Text gesendet. Bei eingeschalteter Einbettung belegt sie das große Bild der ersten V1-Einbettung oder wird in den ersten V2-Container eingefügt. Dieser Kartenplatz lässt sich nicht mit einem eigenen großen Bild überschreiben. In weiteren Einbettungen und zusätzlichen V2-Bildblöcken sind eigene Bilder möglich. Nach dem Umsortieren gehört der Kartenplatz zur neuen ersten Einbettung. Das Kartendesign ist unabhängig von V1/V2.

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.

Inhalte in Nachrichten einsetzen

Der Nachrichteneditor besitzt eigene Auswahlen für Platzhalter, Rollen, Kanäle und Server-Emojis. Ein ausgewählter Eintrag wird an der aktuellen Schreibposition eingesetzt.

AuswahlVerwendung
PlatzhalterFügt dynamische Mitglieds- oder Serverangaben aus der oben stehenden Tabelle ein.
RollenDurchsuche die Rollen des Servers und setze die gewünschte Rollenerwähnung ein. @everyone steht nicht zur Auswahl.
KanäleDurchsuche die verfügbaren Kanäle und setze eine Kanalverknüpfung ein.
Server-EmojisDurchsuche die eigenen Emojis des Servers und setze ein statisches oder animiertes Server-Emoji ein.

Du kannst die Auswahlen über die Schaltflächen im Editor öffnen. Während des Schreibens öffnet @ die Rollenauswahl, # die Kanalauswahl und : die Auswahl der Server-Emojis. Weitere eingegebene Zeichen filtern die jeweilige Liste.

Begrüßungs- und Abschiedsnachrichten dürfen jeweils höchstens 1.800 Zeichen enthalten. Eingesetzte Einträge zählen zum Nachrichteninhalt.

Willkommenskarte gestalten

Der Karteneditor bietet Inhalt, Layout, Fläche, Ring und Text.

Inhalt

Inhalt umfasst Hintergrundbild, optionalen Farbhintergrund, Titel, Untertitel und eine durchsuchbare Schriftartenauswahl mit Vorschauen und Seiten.

Layout

Layout bietet Links oder Zentriert.

Fläche

Fläche bietet normale Deckkraft von 0–100 % oder eine zuschaltbare Liquid-Ebene mit Farbe, Deckkraft von 0–100 % und Unschärfe von 0–64 px. Bei aktiver Liquid-Ebene ist der normale Deckkraftregler gesperrt.

Ring

Ring bietet Grundfarbe, Intensität von 0–100 % und einen optionalen Shader mit Farbe, Stärke von 0–100 % und Winkel von 0–360°.

Text

Text bietet Grundfarbe, Intensität und optionalen Shader mit Farbe, Stärke und Position von 0–100 %.

Es gibt keine freien Regler für Avatargröße, einzelne Schriftgrößen oder beliebige Textpositionen.

Zurücksetzen stellt das Standarddesign her. Speichern oder Abbrechen erfolgt über die gemeinsame Speicherleiste.

Verwende den Standardhintergrund, eine einfarbige Fläche oder ein eigenes Bild. Ein eigenes Bild kann im Zuschneideeditor verschoben und vergrößert werden. Die Fläche bietet außerdem eine Liquid-Ebene mit Farbe, Deckkraft und Unschärfe.

EigenschaftUnterstütztHinweis
DateigrößeMaximal 10 MBGrößere Dateien können nicht als Hintergrund gespeichert werden.
BildformatePNG, JPG/JPEG, WebP und GIFDas tatsächliche Dateiformat wird anhand des Bildinhalts geprüft.
Kartenformat1200 × 600 PixelDas ausgewählte Bild wird im Editor auf diesen Kartenausschnitt zugeschnitten.
AnimationenStatisches ErgebnisDie fertige Karte wird als PNG gespeichert. Animationen aus GIF- oder WebP-Dateien bleiben deshalb nicht erhalten.

Titel ≤ 120 · Untertitel ≤ 160

Kartenplatzhalter

{member.user.name} · {guild.name} · {guild.member_count}

Die Karte hat 1200 × 600 Pixel und wird als statisches PNG ausgegeben. Die Vorschau verwendet dein Konto und Beispieldaten des ausgewählten Servers. Beim Beitritt werden Mitgliedsdaten verwendet. Für die Browservorschau ist eine gültige Dashboard-Verbindung erforderlich.

Abschiedsnachricht

Der Schalter und die Kanalauswahl lassen sich getrennt bearbeiten. Ausschalten erhält den gewählten Kanal. „Kein Kanal“ leert zunächst nur die Auswahl, der Editor bleibt zugänglich. Erst beim Speichern ohne Kanal wird der betreffende Dienst deaktiviert und der Nachrichteneditor geschlossen. Das gilt für Willkommen und Abschied.

Die Abschiedsnachricht wird versendet, wenn ein Mitglied den Server verlässt. Sie kann einen anderen Zielkanal und einen eigenen Text verwenden. Erwähnungen sind nach dem Austritt nicht immer auflösbar. Verwende deshalb bevorzugt {member.user.global_name}.

Abschiedsnachricht sendenOptional

Schaltet die automatische Verabschiedung ein oder aus.

KanalPflicht bei Aktivierung

Legt fest, in welchem erreichbaren Textkanal die Abschiedsnachricht veröffentlicht wird.

NachrichtOptional

Enthält den Abschiedstext mit bis zu 1.800 Zeichen und den verfügbaren Einfügehilfen.

Automatische Rollen

Fjord kann neuen Mitgliedern unmittelbar nach dem Beitritt mehrere Rollen zuweisen. Rollen, die von Discord verwaltet werden, sowie Rollen oberhalb der Fjord-Rolle können nicht vergeben werden.

Automatische RollenOptional

Schaltet die Rollenvergabe beim Beitritt ein oder aus.

RollenPflicht bei Aktivierung

Durchsuche die Rollenauswahl und wähle mindestens eine und höchstens 25 Rollen aus.

  1. Kontrolliere unter Servereinstellungen → Rollen, dass die Fjord-Rolle über den Zielrollen steht.
  2. Aktiviere die automatische Rollenvergabe und wähle die gewünschten Rollen aus.
  3. Speichere die Auswahl.

Rollen mit weitreichenden Verwaltungsrechten sollten nicht automatisch vergeben werden. Fjord zeigt nur Rollen an, die grundsätzlich zuweisbar sind.

Fehler beheben

ProblemPrüfung
Es wird keine Nachricht gesendet.Ist der Dienst aktiviert, der Kanal noch vorhanden und darf Fjord ihn sehen sowie darin schreiben?
Die Karte fehlt.Ist die Karte aktiviert und besitzt Fjord im Zielkanal das Recht „Dateien anhängen“?
Eine Rolle wird nicht vergeben.Liegt die Fjord-Rolle über der Zielrolle und besitzt Fjord das Recht „Rollen verwalten“?
Ein Platzhalter bleibt unverändert.Wurde er über die Platzhalter-Auswahl eingefügt und stimmen Schreibweise sowie Klammern?
Änderungen erscheinen nicht.Speichere die offenen Änderungen über die gemeinsame Speicherleiste, sie übernimmt Nachrichten- und Kartenänderungen zusammen.

V2 fasst bis zu fünf Link-Buttons in einer Aktionszeile zusammen. Statt der V1-Grenze von fünf Zeilen gilt in V2 das gesamte Komponentenbudget.

Link-Buttons öffnen Webseiten und vergeben keine Rollen. Jeder angelegte Button braucht eine Beschriftung mit höchstens 80 Zeichen und eine vollständige HTTP(S)-URL mit höchstens 512 Zeichen. Emoji ist optional. Buttons lassen sich umordnen und entfernen. V1 zeigt sie unter den Einbettungen mit maximal fünf Buttons pro Aktionszeile und fünf Zeilen insgesamt, also höchstens 25 Buttons. V2 zeigt sie im zugehörigen Container und zählt sie einschließlich Aktionszeilen zum 40-Komponenten-Budget.

Link-Buttons werden nur bei aktivierter Einbettung mitgesendet.

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.