Embed-Builder für Discord
Baue dein Embed im Formular und sieh es sofort in der Vorschau. Der Export liefert JSON, discord.js und discord.py; jede Grenze wird mitgezählt, damit Discord die Nachricht nicht ablehnt.
Grundlagen
Macht den Titel zum Link.
Markdown wird gerendert: fett, kursiv, Code, Zeilenumbrüche.
Sechsstelliger Hex-Wert, färbt die linke Kante.
Autor
Felder
Felder sind kurze Paare aus Name und Wert, bis zu drei nebeneinander. Gut für Zahlen, schlecht für Fließtext.
Bilder und Footer
Volle Breite unter dem Text.
Klein, rechts oben.
Export
Sobald das Embed vollständig ist, stehen hier JSON und Code zum Kopieren.
Woran Embeds wirklich scheitern
Discord prüft Embeds streng und antwortet bei Verstößen mit „Invalid Form Body", ohne zu sagen, welches Feld gemeint ist. Die Grenzen: 256 Zeichen im Titel, 4096 in der Beschreibung, 25 Felder mit je 256 Zeichen Name und 1024 Zeichen Wert, 2048 im Footer. Und über allem eine Gesamtgrenze von 6000 Zeichen für alle Texte eines Embeds zusammen.
Die Gesamtgrenze ist die tückische, weil kein einzelnes Feld sie anzeigt: Jedes für sich ist im Rahmen, die Summe nicht. Der Builder zählt deshalb beides mit, jedes Feld einzeln und die Summe, und sagt dir vor dem Abschicken, wo es klemmt.
Vom JSON zur Nachricht
Das erzeugte JSON ist ein Embed-Objekt, wie es die Discord-API erwartet. Per Webhook verschickst du es als `{"embeds": [ … ]}` an die Webhook-URL; in discord.js übergibst du es direkt an `send({ embeds: [ … ] })`, in discord.py baust du daraus mit `Embed.from_dict` ein Objekt. Eine Nachricht darf bis zu zehn Embeds tragen.
Farben erwartet die API als Dezimalzahl, nicht als Hex-Code. Der Builder rechnet das um: Aus `4C8DFF` wird `5017087`. Wer schon einmal eine Stunde gesucht hat, warum `#4C8DFF` im JSON nichts färbt, weiß, warum das dasteht.
Was ein gutes Embed ausmacht
Ein Embed ist eine Visitenkarte, kein Roman. Titel und ein bis zwei Sätze Beschreibung tragen die Nachricht; Felder eignen sich für Zahlen und Paare wie „Server: 1.200", nicht für Fließtext. Inline-Felder stehen zu zweit oder zu dritt nebeneinander, sobald eines nicht inline ist, bricht die Zeile.
In Beschreibung und Feldern gilt Markdown: fett, kursiv, Codeblöcke, Links und auch Discord-Timestamps. In Titel und Footer dagegen nicht, dort bleibt jede Auszeichnung Text. Das ist kein Fehler des Builders, so rendert Discord.
Häufige Fragen
- Warum lehnt Discord mein Embed mit „Invalid Form Body" ab?
- Fast immer ist eine Grenze überschritten oder ein Feld unvollständig. Häufigste Fälle: die Gesamtsumme aller Texte über 6000 Zeichen, ein Feld mit Name aber ohne Wert, eine Beschreibung über 4096 Zeichen oder eine Farbe als Hex-Text statt als Zahl. Der Builder prüft all das vor dem Export und nennt die Stelle.
- Wie viele Zeichen darf ein Embed insgesamt haben?
- Alle Texte eines Embeds zusammen dürfen 6000 Zeichen nicht überschreiten. Mitgezählt werden Titel, Beschreibung, alle Feldnamen und Feldwerte, der Footer und der Autorname; URLs und die Farbe zählen nicht. Bei mehreren Embeds in einer Nachricht gilt die Grenze für die Summe aller Embeds.
- Wie verschicke ich das JSON über einen Webhook?
- Schicke einen POST an die Webhook-URL mit dem Header Content-Type: application/json und dem Rumpf {"embeds": [dein Embed]}. Das geht mit curl, mit fetch oder aus jeder Programmiersprache. Eine Webhook-URL erzeugst du in den Kanaleinstellungen unter Integrationen; sie gehört behandelt wie ein Passwort.
- Funktioniert Markdown im Embed?
- In der Beschreibung und in Feldwerten ja: fett, kursiv, durchgestrichen, Codeblöcke, Links in der Form [Text](URL) und Discord-Timestamps werden gerendert. Im Titel, im Footer und in Feldnamen dagegen nicht, dort erscheint die Auszeichnung als Text. Die Vorschau hier zeigt die gängigen Auszeichnungen.
- Warum wird meine Farbe nicht angezeigt?
- Die API erwartet die Farbe als Dezimalzahl, zum Beispiel 5017087, nicht als Zeichenkette wie "#4C8DFF". Ein Hex-Code im JSON wird stillschweigend ignoriert, das Embed erscheint dann grau. Der Builder exportiert automatisch die richtige Zahl, du wählst nur den Farbton.
Dein Bot verschickt selbst Embeds?
Dann zeig ihn her: Ein Eintrag im Verzeichnis ist kostenlos, und jeder Bot wird von Hand geprüft.