📝 FORMULARE📝 FORMS

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

Jede Interaktion kann ihr eigenes Formular haben. So fragt „Vorfall melden“ nach dem beteiligten Fahrer und dem Hergang, während „Strafe anfechten“ nach der Strafe und einer Begründung fragt.

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

Every interaction can have its own form. “Report incident” might ask for the driver involved and what happened, while “Appeal a penalty” asks for the penalty and a reason.

• Schaltest du das Formular aus, bleiben die Felder gespeichert, werden aber nicht verwendet.
• Ein eingeschaltetes Formular ohne Felder erscheint in Discord nicht – das RC öffnet sich dann direkt.
• Das Race Control Limit prüft der Bot schon beim Klick, also bevor das Formular erscheint.

• 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 RC opens straight away.
• The bot checks the race control limit on the click, before the form appears.

Das gibt es nur bei Race Control: Ein User Select Menu hat zusätzlich den Haken „Ausgewählte Nutzer zum Kanal hinzufügen“. Ist er gesetzt, bekommen alle Mitglieder, die der Meldende in diesem Feld auswählt, Zugang zum neuen RC-Kanal. So kann der beteiligte Fahrer direkt Stellung nehmen, und die Rennleitung muss niemanden von Hand hinzufügen.

Was die hinzugefügten Fahrer dürfen

• Sehen und schreiben: Sie können den Kanal sehen, den Verlauf lesen, schreiben, Dateien anhängen und Links einbetten – also zum Beispiel ihre eigene Sicht und einen Clip liefern.
• Nicht: Nachrichten anderer verwalten, das RC schließen oder übernehmen. Das bleibt der Rennleitung vorbehalten – es sei denn, jemand hat selbst eine Rennleitungs-Rolle.
• Wählt der Meldende sich selbst aus, passiert nichts weiter – er ist ohnehin im Kanal.
• Der Zugang wird beim Öffnen festgelegt. Soll später noch jemand dazukommen oder raus, geht das von Hand über die Kanal-Einstellungen in Discord.
• Ihre Nachrichten landen wie alle anderen im Transcript.

Erfahren die Beteiligten davon?

Sie sehen den neuen Kanal in ihrer Kanalliste. Außerdem stehen sie als Erwähnung in den Formular-Antworten der Willkommensnachricht. Beim Nachrichtentyp „Nachricht“ löst diese Erwähnung eine Benachrichtigung aus; in einem Embed nicht – dort sind Erwähnungen in Discord stumm.

This only exists in race control: a User Select Menu has the extra tick box “Add selected users to the channel”. If it is ticked, every member the reporting driver picks in this field gets access to the new RC channel. That way the driver involved can give their side right away, and your stewards do not have to add anyone by hand.

What the added drivers may do

• See and write: they can see the channel, read the history, write, attach files and embed links – for example to give their side and a clip.
• Not: manage other people's messages, close or claim the RC. That stays with your stewards – unless someone has a steward role themselves.
• If the reporting driver picks themselves, nothing else happens – they are in the channel anyway.
• Access is set when the RC is opened. If someone should join or leave later, do it by hand in the channel settings in Discord.
• Their messages end up in the transcript like all others.

Do the drivers involved find out?

They see the new channel in their channel list. They are also mentioned in the form answers of the welcome message. With the “Message” type this mention triggers a notification; in an embed it does not – mentions in embeds are silent in Discord.

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

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

• 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:Rennen / Runde}. Der Name muss genau dem Label entsprechen.
• Leere Antworten lässt der Bot weg.
• Erwähnungen: Antworten aus User Select, Role Select und Mentionable Select stehen als Erwähnung da. Beim Typ „Nachricht“ bekommen die erwähnten Mitglieder bzw. die Mitglieder der erwähnten Rollen dadurch eine Benachrichtigung – sofern sie den RC-Kanal sehen können. Im Embed bleiben Erwähnungen stumm.

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

Datei-Uploads

• Direkt nach der Willkommensnachricht postet der Bot die Dateien mit der Zeile „📎 Label – von @Name“ in den RC-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:Race / lap}. The name must match the label exactly.
• Empty answers are left out.
• Mentions: answers from User Select, Role Select and Mentionable Select appear as mentions. With the “Message” type the mentioned members, or the members of the mentioned roles, get a notification – as long as they can see the RC channel. In an embed, mentions stay silent.

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

File uploads

• Right after the welcome message the bot posts the files into the RC 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.

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 rc_btn_… oder opt_…), nicht die Beschriftung. Die häufigsten Meldungen:

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 rc_btn_… or opt_…), not its label. The most common messages:

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

• Kurz halten: Drei Felder – Beteiligte, Rennen/Runde, Hergang – reichen für die meisten Vorfälle.
• Pflicht nur, wo nötig: Jedes Pflichtfeld ist eine Hürde vor der Meldung. Clips und Screenshots lieber optional lassen.
• Beispiele in die Beschreibung: „z. B. Monza, Runde 12“ spart Rückfragen der Stewards.
• Meldefrist in einen Infotext: Dann liest sie jeder, bevor er meldet.
• „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 „Strafe“ lassen sich später leicht mit {modal:Strafe} einsetzen.

• Keep it short: three fields – drivers involved, race/lap, what happened – are enough for most incidents.
• Only require what you need: every required field is a hurdle before the report. Keep clips and screenshots optional.
• Put examples in the description: “e.g. Monza, lap 12” saves your stewards follow-up questions.
• Put the reporting deadline in a text block: that way everyone reads it before reporting.
• 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 “Penalty” are easy to insert later with {modal:Penalty}.