Message Builder

Das Message-Builder-Modul ermöglicht das Erstellen, Verwalten und Senden benutzerdefinierter Discord-Embeds aus gespeicherten Vorlagen. Vorlagen werden im Dashboard über den visuellen Inline-Editor konfiguriert.

Modul aktivieren

1. Dashboard → Ihr Server → Toggle Message Builder
2. Klicken Sie auf Edit, um Vorlagen zu erstellen und zu verwalten
3. Konfigurieren Sie die Versandberechtigungen
4. Speichern Sie die Änderungen

Konfiguration

Option	Typ	Standard	Beschreibung
send_permission	string	"moderation_roles"	Wer Embeds senden darf
send_roles	Liste	[]	Rollen für den Versand (wenn permission = "custom")
allowed_channels	Liste	[]	Kanäle, in die gesendet werden darf (leer = alle)
templates	array	[]	Liste gespeicherter Vorlagen

Werte für send_permission

• "moderation_roles" — Rollen aus der Moderationskonfiguration
• "custom" — Rollen aus send_roles

Discord-Administratoren haben immer die Berechtigung zum Senden.

Dashboard — Konfiguration

Das Message-Builder-Panel hat ein zweispaltiges Layout:

• Linke Spalte (1/4): Sidebar mit Vorlagenliste (CRUD: create, edit, delete)
• Rechte Spalte (3/4): Visueller Embed-Editor (inline — Editor IST die Vorschau)

Embed-Editor

Der Editor ist gleichzeitig die Vorschau — was Sie sehen, wird genau so gesendet:

• Content — Textfeld über dem Embed (normaler Nachrichtentext)
• Titel — klickbar zum Bearbeiten
• Beschreibung — klickbar zum Bearbeiten
• Farbe — Presets (Kreise) + benutzerdefinierter Rainbow-Picker
• Thumbnail — klickbarer Platzhalter (gestrichelte Umrandung) → URL-Eingabe
• Bild — klickbarer Platzhalter → URL-Eingabe
• Autor — Name + Icon
• Footer — Fußzeilentext
• Felder — Liste von Feldern (Name + Wert + Inline-Toggle) + Button "Add Field"

Vorlagenverwaltung

• Erstellen — Button "New Template", Namen eingeben
• Bearbeiten — Vorlage in der Sidebar klicken, wird in den Editor geladen
• Löschen — Delete-Button auf der Vorlagenkarte
• Senden — Button "Send to Channel" mit Kanalauswahl

Befehle

/embed send

Sendet eine gespeicherte Vorlage an einen Kanal.

Parameter	Erforderlich	Beschreibung
template_name	✅	Vorlagenname (mit Autocomplete)
channel	❌	Zielkanal (Standard: aktueller Kanal)

Ablauf:

1. Prüft Berechtigung (send_permission)
2. Sucht Vorlage nach Name (case-insensitive)
3. Prüft, ob der Kanal erlaubt ist (allowed_channels)
4. Baut Embed aus der Vorlagenkonfiguration
5. Sendet Embed (+ optionaler Content-Text)
6. Aktualisiert last_sent_channel_id und last_sent_message_id in der Vorlage
7. Protokolliert die Aktion

Autocomplete

Der Parameter template_name unterstützt Autocomplete — nach Eingabe eines Namensfragments schlägt Discord passende Vorlagen vor.

/embed list

Zeigt die Liste aller gespeicherten Vorlagen an (ephemeral).

Zeigt:

• Vorlagennamen
• Titelvorschau (auf 50 Zeichen gekürzt)
• Gesamtzahl der Vorlagen

Kanalbeschränkung

Wenn allowed_channels nicht leer ist, können Embeds nur an Kanäle aus dieser Liste gesendet werden. Der Versuch, an einen anderen Kanal zu senden, gibt einen Fehler zurück.

Wenn die Liste leer ist — Versand an jeden Kanal erlaubt.

Tracking gesendeter Nachrichten

Jede Vorlage speichert:

• last_sent_channel_id — ID des Kanals des letzten Versands
• last_sent_message_id — ID der Nachricht

Dies ermöglicht zukünftige Funktionen (Bearbeitung gesendeter Embeds, Vorschau im Dashboard).

Überwachte Ereignisse

Das Message-Builder-Modul lauscht auf keine Ereignisse — es arbeitet ausschließlich über Slash-Befehle und die Dashboard-API.

Protokollierung

Aktionen werden durch Logs unter der Kategorie message_builder protokolliert:

• 📨 Embed Sent — Vorlagenname, wer gesendet hat, an welchen Kanal

Tipps

Best Practices

• Erstellen Sie Vorlagen für wiederkehrende Ankündigungen (z.B. wöchentliche News, Events)
• Verwenden Sie allowed_channels, um einzuschränken, wohin Embeds gesendet werden können
• Das Feld Content (über dem Embed) ist nützlich zum Pingen von Rollen/@everyone
• Testen Sie Embeds mit /embed send auf einem Testkanal vor dem eigentlichen Versand

Vorlagenstruktur

Organisieren Sie Vorlagen mit klaren Namen:

• weekly-update — wöchentliches Update
• event-announcement — Event-Ankündigungsvorlage
• rules — Serverregeln

warnung

Das Löschen einer Vorlage ist unwiderruflich. Stellen Sie sicher, dass sie nicht mehr benötigt wird.