Message Builder

System wysyłania niestandardowych wiadomości embed z zapisanych szablonów. Szablony tworzy się i edytuje w dashboardzie — komendy służą do wysyłania i przeglądania.

Komendy

/embed send

Wysyła zapisany szablon embeda do wybranego kanału.

Parametr	Typ	Wymagany	Opis
template_name	string	Tak	Nazwa szablonu (autocomplete — podpowiedzi z listy)
channel	TextChannel	Nie	Kanał docelowy (domyślnie bieżący kanał)

Uprawnienia: Konfigurowane (moderation_roles / custom)

Przykład: /embed send template_name:Regulamin channel:#regulamin

Sukces:

• Embed z szablonu wysłany do wybranego kanału (widoczny publicznie)
• Opcjonalny tekst content wyświetlany nad embedem
• Ephemeral potwierdzenie z nazwą szablonu i kanałem
• Zapisany last_sent_channel_id i last_sent_message_id w szablonie
• Log w module "message_builder"

Błędy:

• Brak uprawnień do wysyłania
• Szablon nie znaleziony (wielkość liter nie ma znaczenia)
• Szablon bez tytułu i opisu (pusty — edytuj w dashboardzie)
• Kanał nie jest na liście dozwolonych (jeśli allowed_channels skonfigurowane)
• Bot nie ma uprawnień do pisania w kanale docelowym

Autocomplete

Parametr template_name obsługuje autocomplete — po wpisaniu kilku liter Discord zaproponuje pasujące szablony (max 25 podpowiedzi).

---

/embed list

Wyświetla listę wszystkich zapisanych szablonów embed dla serwera.

Parametr	Typ	Wymagany	Opis
(brak)	—	—	—

Uprawnienia: Każdy (Everyone)

Przykład: /embed list

Sukces: Ephemeral embed z listą szablonów (nazwa + podgląd tytułu) oraz łączna liczba
Błędy:

• Brak zapisanych szablonów (informacja)

---

Tworzenie szablonów

Szablony tworzy się wyłącznie w dashboardzie za pomocą wizualnego edytora:

1. Dashboard → Cog "Message Builder" → Edit
2. Panel boczny z listą szablonów (create/edit/delete)
3. Główny area — inline embed editor (edytor = podgląd)
4. Pole content nad embedem (tekst wyświetlany przed embedem)
5. Kolor: presety + custom picker
6. Obrazy: klikalne placeholdery → wklej URL
7. Pola (fields): przycisk "Add Field"

Struktura szablonu

{
  "name": "Regulamin",
  "content": "Przeczytaj regulamin serwera:",
  "embed": {
    "title": "Regulamin Serwera",
    "description": "1. Szanuj innych\n2. Bez spamu...",
    "color": "#5865F2",
    "thumbnail": "https://...",
    "image": "https://...",
    "author_name": "ArcBot",
    "author_icon": "https://...",
    "footer": "Ostatnia aktualizacja: 2026-06-12",
    "fields": [
      { "name": "Kary", "value": "Za złamanie...", "inline": false }
    ]
  },
  "last_sent_channel_id": "123456789",
  "last_sent_message_id": "987654321"
}

---

Konfiguracja

Opcja	Opis	Domyślna wartość
send_permission	Kto może wysyłać embedy	moderation_roles
send_roles	Role dla custom permission	brak
allowed_channels	Dozwolone kanały (puste = wszystkie)	brak (bez ograniczeń)
templates	Lista zapisanych szablonów	[]

Tracking

Po każdym wysłaniu szablonu, bot zapisuje last_sent_channel_id i last_sent_message_id. Umożliwia to przyszłe edycje/aktualizacje wysłanych wiadomości z poziomu dashboardu.