Message Builder

System zum Versenden benutzerdefinierter Embed-Nachrichten aus gespeicherten Vorlagen. Vorlagen werden im Dashboard erstellt und bearbeitet — Befehle dienen zum Senden und Anzeigen.

Befehle

/embed send

Sendet eine gespeicherte Embed-Vorlage an den gewählten Kanal.

Parameter	Typ	Erforderlich	Beschreibung
template_name	string	Ja	Vorlagenname (Autocomplete — Vorschläge aus der Liste)
channel	TextChannel	Nein	Zielkanal (Standard: aktueller Kanal)

Berechtigungen: Konfigurierbar (moderation_roles / custom)

Beispiel: /embed send template_name:Regeln channel:#regeln

Erfolg:

• Embed aus der Vorlage an den gewählten Kanal gesendet (öffentlich sichtbar)
• Optionaler content-Text über dem Embed angezeigt
• Ephemerale Bestätigung mit Vorlagenname und Kanal
• Gespeichertes last_sent_channel_id und last_sent_message_id in der Vorlage
• Log im Modul "message_builder"

Fehler:

• Keine Versandberechtigung
• Vorlage nicht gefunden (Groß-/Kleinschreibung egal)
• Vorlage ohne Titel und Beschreibung (leer — im Dashboard bearbeiten)
• Kanal nicht auf der erlaubten Liste (wenn allowed_channels konfiguriert)
• Bot hat keine Schreibberechtigung im Zielkanal

Autocomplete

Der Parameter template_name unterstützt Autocomplete — nach Eingabe einiger Buchstaben schlägt Discord passende Vorlagen vor (max 25 Vorschläge).

---

/embed list

Zeigt die Liste aller gespeicherten Embed-Vorlagen für den Server.

Parameter	Typ	Erforderlich	Beschreibung
(keine)	—	—	—

Berechtigungen: Jeder (Everyone)

Beispiel: /embed list

Erfolg: Ephemerales Embed mit Vorlagenliste (Name + Titelvorschau) und Gesamtzahl
Fehler:

• Keine gespeicherten Vorlagen (Information)

---

Vorlagen erstellen

Vorlagen werden ausschließlich im Dashboard über den visuellen Editor erstellt:

1. Dashboard → Cog "Message Builder" → Edit
2. Seitenpanel mit Vorlagenliste (create/edit/delete)
3. Hauptbereich — Inline-Embed-Editor (Editor = Vorschau)
4. content-Feld über dem Embed (Text vor dem Embed)
5. Farbe: Presets + benutzerdefinierter Picker
6. Bilder: klickbare Platzhalter → URL einfügen
7. Felder (Fields): Button "Add Field"

Vorlagenstruktur

{
  "name": "Regeln",
  "content": "Lesen Sie die Serverregeln:",
  "embed": {
    "title": "Serverregeln",
    "description": "1. Respektiert einander\n2. Kein Spam...",
    "color": "#5865F2",
    "thumbnail": "https://...",
    "image": "https://...",
    "author_name": "ArcBot",
    "author_icon": "https://...",
    "footer": "Letzte Aktualisierung: 2026-06-12",
    "fields": [
      { "name": "Strafen", "value": "Bei Verstoß...", "inline": false }
    ]
  },
  "last_sent_channel_id": "123456789",
  "last_sent_message_id": "987654321"
}

---

Konfiguration

Option	Beschreibung	Standardwert
send_permission	Wer Embeds senden darf	moderation_roles
send_roles	Rollen für custom permission	keine
allowed_channels	Erlaubte Kanäle (leer = alle)	keine (unbeschränkt)
templates	Liste gespeicherter Vorlagen	[]

Tracking

Nach jedem Versand einer Vorlage speichert der Bot last_sent_channel_id und last_sent_message_id. Dies ermöglicht zukünftige Bearbeitungen/Aktualisierungen gesendeter Nachrichten aus dem Dashboard.