📝 FORMULARE📝 FORMS

Frag vor dem Öffnen eines Tickets die wichtigsten Infos ab – mit Textfeldern, Auswahllisten, Checkboxen und Datei-Upload. In Discord heißen diese Fenster „Modals“.

Ask for the key details before a ticket is opened – with text fields, select menus, checkboxes and file uploads. Discord calls these windows “modals”.

WAS IST EIN FORMULAR?WHAT IS A FORM?

Klickt ein Mitglied auf einen Button (oder wählt eine Option), zeigt Discord ein Fenster mit Eingabefeldern. Erst nach „Absenden“ legt der Bot das Ticket an; die Antworten stehen dann im Ticket-Kanal. Schließt das Mitglied das Fenster, passiert nichts – es entsteht kein Ticket.

Jede Interaktion kann ihr eigenes Formular haben. So fragt etwa der Button „Technik“ nach Plattform und Screenshots, während „Melden“ nach dem betroffenen Fahrer fragt.

Vorschau eines Formulars
So erscheint das Formular „Support-Anfrage“. Pflichtfelder tragen ein rotes Sternchen.

When a member clicks a button (or picks an option), Discord shows a window with input fields. Only after “Submit” does the bot create the ticket; the answers then appear in the ticket channel. If the member closes the window, nothing happens – no ticket is created.

Every interaction can have its own form. The “Technical” button might ask for the platform and screenshots, while “Report” asks for the driver involved.

Preview of a form
This is how the “Support request” form appears. Required fields have a red asterisk.

FORMULAR EINRICHTENSETTING UP A FORM

Schritt 3 öffnen
Öffne im Panel-Editor den Schritt „Modal Handler“.
Interaktion wählen
Links stehen alle Buttons und Auswahl-Optionen aus Schritt 1. Das Kennzeichen „Modal“ zeigt, wo schon ein Formular aktiv ist. Ist die Liste leer, lege zuerst in Schritt 1 Buttons oder ein Auswahlmenü an.
Formular einschalten
Schalte „Modal für diese Interaktion aktivieren“ ein. Der Editor legt gleich ein kurzes Textfeld an.
Titel vergeben
„Modal Titel“ steht oben im Fenster, höchstens 45 Zeichen. Bleibt er leer, heißt das Fenster „Ticket erstellen“ – auch auf englischen Servern.
Felder hinzufügen
Über „+ Komponente“ fügst du bis zu fünf Felder hinzu; danach ist der Knopf gesperrt. Die Reihenfolge änderst du durch Ziehen – so erscheinen die Felder auch in Discord. Der Papierkorb löscht ein Feld nach einer Rückfrage.
Prüfen und speichern
Kontrolliere rechts die Vorschau und speichere das Panel in Schritt 6.
Formular im Modal Handler bearbeiten
Links die Interaktionen, in der Mitte die Felder, rechts die Vorschau.
Die zwölf Feldtypen
Das Menü „+ Komponente“ mit allen Feldtypen.
  • Schaltest du das Formular aus, bleiben die Felder gespeichert, werden aber nicht verwendet.
  • Ein eingeschaltetes Formular ohne Felder erscheint in Discord nicht – das Ticket öffnet sich dann direkt.
  • Das Ticket-Limit prüft der Bot schon beim Klick, also bevor das Formular erscheint.
Open step 3
Open the “Modal Handler” step in the panel editor.
Pick an interaction
All buttons and select options from step 1 are listed on the left. The “Modal” badge shows where a form is already active. If the list is empty, create buttons or a select menu in step 1 first.
Turn the form on
Switch on “Enable modal for this interaction”. The editor adds a short text field right away.
Give it a title
The “Modal Title” is shown at the top of the window, 45 characters at most. If you leave it empty, the window is called “Ticket erstellen” – in German, even on English servers.
Add fields
With “+ Component” you add up to five fields; after that the button is disabled. Drag the fields to change their order – that is also the order in Discord. The bin icon deletes a field after a confirmation.
Check and save
Check the preview on the right and save the panel in step 6.
Editing a form in the Modal Handler
Interactions on the left, the fields in the middle, the preview on the right.
The twelve field types
The “+ Component” menu with all field types.
  • If you switch the form off, its fields stay saved but are not used.
  • A form that is switched on but has no fields does not appear in Discord – the ticket opens straight away.
  • The bot checks the ticket limit on the click, before the form appears.

DIE ZWÖLF FELDTYPENTHE TWELVE FIELD TYPES

Jedes Formular hat höchstens fünf Felder. Diese Typen stehen zur Wahl:

✏️Textfeld (kurz)

Eine Zeile, etwa für Ingame-Namen oder einen Betreff. Einstellbar: Placeholder (bis 100 Zeichen), Min. und Max. Zeichen (0–4000, Standard höchstens 100) und ein vorbelegter Text. Antwort: der eingegebene Text.

📄Textfeld (mehrzeilig)

Ein großes Feld für Beschreibungen. Dieselben Einstellungen wie das kurze Textfeld, Standard höchstens 4000 Zeichen. Antwort: der eingegebene Text.

📋String Select Menu

Eine Auswahlliste mit eigenen Optionen (bis 25). Jede Option hat ein Label (bis 100 Zeichen) und optional ein Emoji, eine Beschreibung und eine Vorauswahl. Dazu Min. und Max. Auswahl (0–25 bzw. 1–25) und ein Placeholder. Ein neues Feld startet ohne Optionen. Antwort: die Labels der gewählten Optionen, mit Komma getrennt.

👤User Select Menu

Auswahl von Servermitgliedern, etwa „Betroffener Fahrer“. Einstellbar: Placeholder, Min. und Max. Auswahl. Antwort: Erwähnungen der gewählten Mitglieder. Diese bekommen dadurch keinen Zugang zum Ticket.

🛡️Role Select Menu

Auswahl von Server-Rollen, etwa „Für welches Team fährst du?“. Einstellbar: Placeholder, Min. und Max. Auswahl. Antwort: die gewählten Rollen als Erwähnung.

#️⃣Channel Select Menu

Auswahl von Kanälen. Unter „Kanaltypen“ grenzt du ein: Text, Sprache, Kategorie, Ankündigung, Stage, Forum – keiner gewählt heißt alle. Antwort: Links zu den gewählten Kanälen.

@Mentionable Select

Auswahl von Mitgliedern oder Rollen in einem Feld. Einstellbar: Placeholder, Min. und Max. Auswahl. Antwort: Erwähnungen, erst Mitglieder, dann Rollen.

📎Datei-Upload

Mitglieder hängen Dateien an, etwa Screenshots oder Log-Dateien. Einstellbar: Min. und Max. Dateien (0–10 bzw. 1–10) und die erlaubten Dateitypen – Bilder, Videos, Audio und/oder Endungen wie .pdf, .log, .txt (höchstens 10; keiner gewählt heißt alle). Antwort: die Dateinamen; die Dateien selbst postet der Bot direkt nach der Willkommensnachricht. Mehr zu Uploads

☑️Checkbox

Ein einzelnes Häkchen, zum Beispiel „Benachrichtigung per DM“. Einstellbar: „Vorab angehakt“. Eine einzelne Checkbox kann Discord nicht zur Pflicht machen. Antwort: „✅ Ja“ oder „❌ Nein“.

✅Checkbox-Gruppe

Mehrere Häkchen zur Auswahl (bis 10 Optionen), etwa verfügbare Renntage. Einstellbar: Min. und Max. Auswahl (0–10 bzw. 1–10), Vorauswahl je Option. Antwort: die Labels der angehakten Optionen.

🔘Radio-Gruppe

Genau eine Antwort aus 2 bis 10 Optionen, etwa die Plattform. Höchstens eine Option darf vorausgewählt sein. Antwort: das Label der gewählten Option.

ℹ️Infotext

Ein Hinweistext ohne Eingabe, bis 4000 Zeichen, Markdown wie **fett** funktioniert. Gut für Regeln oder Erklärungen vor dem Ausfüllen. Belegt einen der fünf Plätze. Antwort: keine.

Each form has at most five fields. These types are available:

✏️Text Field (short)

A single line, for example for an in-game name or a subject. Settings: placeholder (up to 100 characters), min. and max. characters (0–4,000, by default at most 100) and pre-filled text. Answer: the text entered.

📄Text Field (multiline)

A large field for descriptions. Same settings as the short text field, by default up to 4,000 characters. Answer: the text entered.

📋String Select Menu

A drop-down with your own options (up to 25). Each option has a label (up to 100 characters) and, optionally, an emoji, a description and a preselection. Plus min. and max. selection (0–25 and 1–25) and a placeholder. A new field starts without options. Answer: the labels of the chosen options, separated by commas.

👤User Select Menu

Pick server members, for example “Driver involved”. Settings: placeholder, min. and max. selection. Answer: mentions of the chosen members. They do not get access to the ticket because of this.

🛡️Role Select Menu

Pick server roles, for example “Which team do you drive for?”. Settings: placeholder, min. and max. selection. Answer: the chosen roles as mentions.

#️⃣Channel Select Menu

Pick channels. Under “Channel types” you can narrow it down: Text, Voice, Category, Announcement, Stage, Forum – none selected means all. Answer: links to the chosen channels.

@Mentionable Select

Pick members or roles in one field. Settings: placeholder, min. and max. selection. Answer: mentions, members first, then roles.

📎File upload

Members attach files, for example screenshots or log files. Settings: min. and max. files (0–10 and 1–10) and the allowed file types – images, videos, audio and/or extensions such as .pdf, .log, .txt (at most 10; none selected means all). Answer: the file names; the bot posts the files themselves right after the welcome message. More on uploads

☑️Checkbox

A single tick box, for example “Notify me by DM”. Setting: “Checked by default”. Discord cannot make a single checkbox required. Answer: “✅ Yes” or “❌ No”.

✅Checkbox group

Several tick boxes (up to 10 options), for example available race days. Settings: min. and max. selection (0–10 and 1–10), preselection per option. Answer: the labels of the ticked options.

🔘Radio group

Exactly one answer out of 2 to 10 options, for example the platform. At most one option may be preselected. Answer: the label of the chosen option.

ℹ️Text block

An information text without input, up to 4,000 characters; Markdown like **bold** works. Good for rules or explanations before filling in. Takes one of the five slots. Answer: none.

EINSTELLUNGEN FÜR ALLE FELDERSETTINGS FOR ALL FIELDS

EinstellungBedeutung
Label PflichtDer Feldname über dem Eingabefeld, bis 45 Zeichen. Er muss im Formular eindeutig sein, denn über ihn setzt du die Antwort mit {modal:Label} in Nachrichten ein.
Beschreibung (optional)Ein kurzer Hinweis unter dem Feldnamen, bis 100 Zeichen – gut für Beispiele.
Pflichtfeld„Ja“ (Standard) oder „Nein“. Pflichtfelder tragen in Discord ein rotes Sternchen. Beim Datei-Upload und bei der Checkbox-Gruppe hängt „Pflicht“ am Minimum: Pflicht heißt mindestens 1. Checkbox und Infotext haben keine Pflicht-Einstellung.
Einstellungen eines Datei-Uploads
Label, Beschreibung, Anzahl der Dateien, Pflichtfeld und die erlaubten Dateitypen.
SettingMeaning
Label requiredThe field name above the input, up to 45 characters. It must be unique within the form, because you insert the answer into messages with {modal:Label}.
Description (optional)A short hint below the field name, up to 100 characters – good for examples.
Required“Yes” (default) or “No”. Required fields have a red asterisk in Discord. For file uploads and checkbox groups, “required” is tied to the minimum: required means at least 1. Checkbox and text block have no required setting.
Settings of a file upload field
Label, description, number of files, required and the allowed file types.

SO ERSCHEINEN DIE ANTWORTEN IM TICKETHOW THE ANSWERS APPEAR IN THE TICKET

  • Standard-Willkommensnachricht: Der Bot hängt die Antworten automatisch an – beim Typ „Nachricht“ als Block „Angaben:“, beim Embed als ein Feld pro Antwort (bis 1024 Zeichen je Feld).
  • Eigene Nachricht pro Interaktion: Hier gibt es keinen automatischen Block. Setze die Antworten mit {modal:Feldname} selbst ein, zum Beispiel {modal:Betreff}. Der Name muss genau dem Label entsprechen.
  • Leere Antworten lässt der Bot weg.

Beispiel – Typ „Nachricht“ mit ausgefülltem Formular:

THE GRID · Bot@Lena Willkommen @Lena! Dein Ticket wurde erstellt. Angaben: Betreff: Kein Ton im Boxenfunk Bereich: Discord & Rollen Beschreibung: Seit gestern hört mich im Boxenfunk niemand mehr.

Datei-Uploads

  • Direkt nach der Willkommensnachricht postet der Bot die Dateien mit der Zeile „📎 Label – von @Name“ in den Ticket-Kanal. Bilder bleiben so auch im Transcript erhalten.
  • Wie groß eine Datei sein darf, hängt vom Boost-Level deines Servers ab: 10 MB ohne Boost und auf Level 1, 50 MB auf Level 2, 100 MB auf Level 3.
  • Größere Dateien kann der Bot nicht hochladen. Er postet dann einen Hinweis mit einem Link, der nach etwa 24 Stunden abläuft – sichere solche Dateien rechtzeitig.
  • Gibst du bei den Dateitypen nur Endungen an, verlangt Discord wegen der Handy-Apps bei Bildern zusätzlich .jpg und bei Videos .mp4 und .mov.
  • Default welcome message: the bot appends the answers automatically – for the “Message” type as a block “Angaben:” (details), for an embed as one field per answer (up to 1,024 characters per field).
  • Dedicated message per interaction: there is no automatic block here. Insert the answers yourself with {modal:Field name}, for example {modal:Subject}. The name must match the label exactly.
  • Empty answers are left out.

Example – “Message” type with a filled-in form:

THE GRID · Bot@Lena Welcome @Lena! Your ticket has been created. Angaben: Subject: No sound in team radio Area: Discord & roles Description: Since yesterday nobody can hear me in team radio.

File uploads

  • Right after the welcome message the bot posts the files into the ticket channel with the line “📎 Label – from @Name”. That way images are also kept in the transcript.
  • How large a file may be depends on your server's boost level: 10 MB without boost and at level 1, 50 MB at level 2, 100 MB at level 3.
  • The bot cannot upload larger files. It posts a notice with a link instead that expires after about 24 hours – save such files in time.
  • If you only list extensions as file types, Discord also requires .jpg for images and .mp4 and .mov for videos because of the mobile apps.

PRÜFUNGEN UND FEHLERMELDUNGENCHECKS AND ERROR MESSAGES

Der Editor prüft jedes Formular, bevor du speichern kannst. Probleme erscheinen in Schritt 6 als „Modal für "…": …“. In den Anführungszeichen steht die interne Kennung der Interaktion (etwa btn_…), nicht die Beschriftung. Die häufigsten Meldungen:

MeldungLösung
Ein Modal kann höchstens 5 Felder haben.Ein Feld entfernen; Infotexte zählen mit.
Feld N hat keinen Feldnamen.Ein Label eintragen.
Feldname „X“ kommt doppelt vor …Eines der Felder umbenennen, damit {modal:X} eindeutig ist.
Feld N hat keine Optionen.Mindestens eine Option anlegen (Auswahlliste, Checkbox-Gruppe).
Radio-Gruppe (Feld N) braucht mindestens 2 Optionen.Eine zweite Option anlegen.
Feld N: Min. Auswahl (a) ist größer als die Zahl der Optionen (b).Minimum senken oder Optionen ergänzen.
Feld N: Min. Zeichen (a) ist größer als Max. Zeichen (b).Grenzen tauschen oder anpassen.
Vorbelegter Text von Feld N ist länger als Max. Zeichen …Vorbelegten Text kürzen oder Maximum erhöhen.
Feld N: Emoji von Option O ist ungültig …Ein einzelnes Emoji wie 🎫 oder ein Server-Emoji im Format <:name:id> verwenden.
Feld N: Dateityp „x“ ist ungültig …Nur Bilder, Videos, Audio oder Endungen wie .pdf angeben, höchstens 10.
Radio-Gruppe (Feld N) erlaubt nur eine Vorauswahl.Bei allen außer einer Option die Vorauswahl entfernen.

Nur Warnungen (Speichern möglich) sind: ein Formular ohne Titel und ein eingeschaltetes Formular ohne Felder.

The editor checks every form before you can save. Problems appear in step 6 as “Modal "…": …”. The quotes contain the internal ID of the interaction (such as btn_…), not its label. The most common messages:

MessageFix
A modal can have at most 5 fieldsRemove a field; text blocks count too.
Field N has no labelEnter a label.
Label "X" is used twice (fields A and B)Rename one of the fields so that {modal:X} is unique.
Field N has no optionsAdd at least one option (select menu, checkbox group).
Radio group (field N) needs at least 2 optionsAdd a second option.
Field N: min values is greater than the number of optionsLower the minimum or add options.
Field N: min length is greater than max lengthSwap or adjust the limits.
Pre-filled text of field N is longer than its max lengthShorten the pre-filled text or raise the maximum.
Field N: emoji of option O is invalidUse a single emoji like 🎫 or a server emoji in the format <:name:id>.
Field N: invalid file typeOnly use images, videos, audio or extensions like .pdf, at most 10.
Radio group (field N) allows only one defaultRemove the preselection from all options but one.

Only warnings (saving still possible) are: a form without a title and a form that is switched on but has no fields.

TIPPS FÜR GUTE FORMULARETIPS FOR GOOD FORMS

  • Kurz halten: Zwei bis drei Felder werden eher vollständig ausgefüllt als fünf.
  • Pflicht nur, wo nötig: Jedes Pflichtfeld ist eine Hürde vor dem Ticket.
  • Beispiele in die Beschreibung: „z. B. Monza, Runde 12“ spart Rückfragen.
  • „Regeln gelesen“ abfragen: Nimm eine Checkbox-Gruppe mit einer Option und „Min. Auswahl“ 1 – eine einzelne Checkbox kann keine Pflicht sein.
  • Eindeutige Feldnamen: Kurze Labels wie „Betreff“ lassen sich später leicht mit {modal:Betreff} einsetzen.
  • Keep it short: two or three fields get filled in completely more often than five.
  • Only require what you need: every required field is a hurdle before the ticket.
  • Put examples in the description: “e.g. Monza, lap 12” saves follow-up questions.
  • Asking “I have read the rules”: use a checkbox group with one option and “Min. selection” 1 – a single checkbox cannot be required.
  • Clear field names: short labels like “Subject” are easy to insert later with {modal:Subject}.

NOCH FRAGEN?STILL HAVE QUESTIONS?

Tritt unserem Discord-Server bei – das Team hilft dir bei der Einrichtung gerne weiter.

Join our Discord server – the team is happy to help you with the setup.