Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

Discord Bot

Buttons und Auswahlmenüs (Select Menus) in Discord.js v14 verwenden

26 August 2026 12 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

Mit Buttons und Auswahlmenüs (Select Menus) können Nutzer Ihren Bot bedienen, ohne Befehle einzutippen – sie klicken einfach auf Elemente in der Nachricht. In dieser Anleitung erstellen Sie mit discord.js v14 einen Bestätigungsbutton, ein Menü mit Mehrfachauswahl und ein Rollenauswahl-Panel, das auch nach einem Neustart des Bots funktioniert; außerdem lernen Sie die drei Wege kennen, einen Klick abzufangen, sowie die 3-Sekunden-Regel und die Grenzen der Komponenten.

Bevor Sie beginnen

  • Ein funktionierender Slash-Command-Bot: Die Beispiele verwenden die Projektstruktur aus der Anleitung zum Erstellen eines Bots von Grund auf: den Ordner commands/utility, deploy-commands.js, index.js und die Skripte npm start / npm run deploy.
  • discord.js v14 und Node.js: Die Beispiele wurden nach der Dokumentation von discord.js 14.27.0 geschrieben. Diese Version benötigt Node.js 18 oder neuer; die LTS-Version aus der Einrichtungsanleitung erfüllt diese Voraussetzung. Die installierten Versionen sehen Sie mit den Befehlen npm ls discord.js und node -v.
  • Kein zusätzlicher Intent (Ereignisberechtigung) nötig: Klicks kommen wie Slash-Befehle als Interaktion (interaction) an; GatewayIntentBits.Guilds genügt.
  • Berechtigung für das Rollenpanel: Die Rolle des Bots muss die Berechtigung „Rollen verwalten“ (Manage Roles) haben. Discord erlaubt einem Bot nur, Rollen zu vergeben, die unterhalb seiner eigenen höchsten Rolle liegen; ziehen Sie die Bot-Rolle unter „Servereinstellungen“ → „Rollen“ über die Rollen, die er vergeben soll.
  • Wo der Bot läuft: Code und Befehle sind unter Windows und Linux identisch; entwickeln können Sie auf Ihrem eigenen Computer. Damit das dauerhafte Panel jederzeit antwortet, muss der Bot ständig laufen; verwenden Sie dafür einen VDS. Die HanHosting-Pakete Discord Bot VDS bieten 4 CPU, 2–4 GB RAM und 30–40 GB NVMe-Speicher.

1. Aufbau der Komponenten und Wege zum Abfangen kennenlernen

Um einer Nachricht Komponenten hinzuzufügen, erstellen Sie einen ActionRowBuilder (Aktionszeile), legen Buttons oder ein Menü in diese Zeile und übergeben die Zeile an das Array components der Nachricht. Eine klassische Nachricht hat höchstens 5 Zeilen; eine Zeile enthält höchstens 5 Buttons oder ein einzelnes Auswahlmenü, Buttons und Menü können sich keine Zeile teilen.

Jede interaktive Komponente hat einen von Ihnen festgelegten Wert customId (eigene Kennung); klickt ein Nutzer, sendet Discord diese Kennung an den Bot, und der Bot erkennt daran, welche Komponente betätigt wurde. Discord erwartet auf jede Interaktion innerhalb von 3 Sekunden eine erste Antwort; kommt keine, gilt die Interaktion als fehlgeschlagen, und der Nutzer sieht unter der Nachricht einen Fehlerhinweis. Es gibt drei Wege, einen Klick abzufangen:

MethodeGeeignet fürWenn der Bot neu startet
awaitMessageComponentBestätigungsfragen mit einer einzigen erwarteten AntwortDas Warten geht verloren
createMessageComponentCollector (Collector)Mehrere Klicks über einen bestimmten Zeitraum: Menüs, AbstimmungenDer Collector stoppt
Ereignis interactionCreateUnbefristete Panels: Rollenauswahl, Support-Tickets eröffnenFunktioniert weiter

Die ersten beiden leben im Arbeitsspeicher des Bot-Prozesses und enden, wenn die Zeit abläuft. Beim dritten ist die customId in der Nachricht gespeichert, daher funktionieren auch alte Panels, wenn der Bot wieder gestartet wird.

2. Einen Befehl mit Bestätigungsbuttons schreiben

Erstellen Sie die Datei commands/utility/onay.js. Der Befehl sendet zwei Buttons und wartet 60 Sekunden lang nur auf den Klick der Person, die den Befehl verwendet hat:

const {
  ActionRowBuilder, ButtonBuilder, ButtonStyle, SlashCommandBuilder,
} = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('onay')
    .setDescription('Zeigt die Bestätigungsbuttons an.'),
  async execute(interaction) {
    const onayla = new ButtonBuilder()
      .setCustomId('onayla')
      .setLabel('Bestätigen')
      .setStyle(ButtonStyle.Success);
    const vazgec = new ButtonBuilder()
      .setCustomId('vazgec')
      .setLabel('Abbrechen')
      .setStyle(ButtonStyle.Secondary);
    const satir = new ActionRowBuilder().addComponents(vazgec, onayla);

    const yanit = await interaction.reply({
      content: 'Möchten Sie den Vorgang bestätigen?',
      components: [satir],
      withResponse: true,
    });

    const filtre = (i) => i.user.id === interaction.user.id;
    try {
      const tiklama = await yanit.resource.message.awaitMessageComponent({
        filter: filtre,
        time: 60_000,
      });
      const metin = tiklama.customId === 'onayla' ? 'Bestätigt.' : 'Abgebrochen.';
      await tiklama.update({ content: metin, components: [] });
    } catch {
      await interaction.editReply({
        content: 'Innerhalb von 1 Minute kam keine Antwort, der Vorgang wurde abgebrochen.',
        components: [],
      });
    }
  },
};
  • Mit withResponse: true erreichen Sie die gesendete Nachricht über yanit.resource.message; das in älteren Beispielen verwendete fetchReply: true ist als veraltet (deprecated) markiert.
  • filter ignoriert Klicks anderer Mitglieder; wer keine Antwort erhält, sieht einen Fehlerhinweis. Wenn Sie das nicht möchten, antworten Sie dieser Person wie in Schritt 3 gesondert.
  • update() antwortet, indem es die Nachricht mit dem Button bearbeitet; components: [] entfernt die Buttons.
  • Läuft die Zeit ab, wirft awaitMessageComponent einen Fehler, und der catch-Block aktualisiert die Nachricht.

3. Das Auswahlmenü mit einem Collector auslesen

StringSelectMenuBuilder ist das Menü, dessen Optionen Sie selbst festlegen (in den ersten v14-Versionen hieß es SelectMenuBuilder; dieser Name funktioniert noch, ist aber veraltet und erzeugt eine Warnung). Jede Option benötigt ein label (Beschriftung), das der Nutzer sieht, und einen value (Wert), der beim Bot ankommt; description ist optional. setMinValues und setMaxValues aktivieren die Mehrfachauswahl. commands/utility/oyun.js:

const {
  ActionRowBuilder, ComponentType, MessageFlags, SlashCommandBuilder,
  StringSelectMenuBuilder, StringSelectMenuOptionBuilder,
} = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('oyun')
    .setDescription('Wählen Sie die Spiele, die Sie spielen.'),
  async execute(interaction) {
    const menu = new StringSelectMenuBuilder()
      .setCustomId('oyun-secimi')
      .setPlaceholder('Wählen Sie bis zu 3 Spiele')
      .setMinValues(1)
      .setMaxValues(3)
      .addOptions(
        new StringSelectMenuOptionBuilder().setLabel('Minecraft').setValue('minecraft'),
        new StringSelectMenuOptionBuilder().setLabel('FiveM').setValue('fivem'),
        new StringSelectMenuOptionBuilder()
          .setLabel('Rust')
          .setValue('rust')
          .setDescription('Survival-Spiel'),
      );

    const yanit = await interaction.reply({
      content: 'Welche Spiele spielen Sie?',
      components: [new ActionRowBuilder().addComponents(menu)],
      withResponse: true,
    });

    const toplayici = yanit.resource.message.createMessageComponentCollector({
      componentType: ComponentType.StringSelect,
      time: 120_000,
    });

    toplayici.on('collect', async (i) => {
      if (i.user.id !== interaction.user.id) {
        await i.reply({ content: 'Dieses Menü gehört der Person, die den Befehl verwendet hat.', flags: MessageFlags.Ephemeral });
        return;
      }
      await i.update({ content: `Ihre Auswahl: ${i.values.join(', ')}` });
    });

    toplayici.on('end', async () => {
      await interaction.editReply({ components: [] });
    });
  },
};

Bei der Mehrfachauswahl wird die Interaktion nicht bei jedem Klick gesendet, sondern erst, wenn der Nutzer seine Auswahl beendet und außerhalb des Menüs klickt; alle gewählten Werte kommen im Array i.values an. Der Collector löst nach 2 Minuten das Ereignis end aus, und das Menü wird entfernt. Der Schlüssel (Token) der ursprünglichen Interaktion ist 15 Minuten gültig; danach funktioniert interaction.editReply nicht mehr. Halten Sie die Laufzeit des Collectors darunter und verwenden Sie für langlebige Menüs Schritt 4.

4. Ein dauerhaftes Rollenauswahl-Panel einrichten

Die Klicks auf ein Panel, das wochenlang im Kanal stehen soll, verarbeiten Sie in index.js im Ereignis interactionCreate anhand des Werts customId. Erstellen Sie zuerst im Projektstamm die Datei roller.js. Ersetzen Sie die IDs im Beispiel durch Ihre eigenen Rollen-IDs. Eine Rollen-ID können Sie kopieren, nachdem Sie unter „Benutzereinstellungen“ → „Erweitert“ den „Entwicklermodus“ (Developer Mode) aktiviert haben: in der Liste unter „Servereinstellungen“ → „Rollen“ über das Menü der Rolle. Die Menünamen können je nach Version der Oberfläche abweichen.

// roller.js - Rollen im Panel (höchstens 25)
module.exports = [
  { label: 'Ankündigungen', value: '111111111111111111' },
  { label: 'Veranstaltungen', value: '222222222222222222' },
  { label: 'Minecraft', value: '333333333333333333' },
];

Der Befehl, der das Panel sendet, ist commands/utility/rol-paneli.js. setDefaultMemberPermissions zeigt den Befehl standardmäßig nur Mitgliedern mit der Berechtigung „Rollen verwalten“ an:

const {
  ActionRowBuilder, PermissionFlagsBits, SlashCommandBuilder, StringSelectMenuBuilder,
} = require('discord.js');
const roller = require('../../roller.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('rol-paneli')
    .setDescription('Sendet das Rollenauswahl-Panel in diesen Kanal.')
    .setDefaultMemberPermissions(PermissionFlagsBits.ManageRoles),
  async execute(interaction) {
    const menu = new StringSelectMenuBuilder()
      .setCustomId('rol-paneli')
      .setPlaceholder('Wählen Sie die Rollen, die Sie erhalten oder abgeben möchten')
      .setMinValues(1)
      .setMaxValues(roller.length)
      .addOptions(...roller);

    await interaction.reply({
      content: 'Haben Sie die gewählte Rolle noch nicht, wird sie vergeben; haben Sie sie bereits, wird sie entfernt.',
      components: [new ActionRowBuilder().addComponents(menu)],
    });
  },
};

Fügen Sie nun am Anfang der Datei index.js die Zeilen für roller und am Anfang des Event-Listeners, der die Slash-Befehle verarbeitet, die Panel-Prüfung ein. Die Zeile require('discord.js') aus der Einrichtungsanleitung importiert die Namen Events und MessageFlags bereits:

const roller = require('./roller.js');
const izinli = roller.map((r) => r.value);

client.on(Events.InteractionCreate, async (interaction) => {
  if (interaction.isStringSelectMenu() && interaction.customId === 'rol-paneli') {
    await interaction.deferUpdate();
    const roles = interaction.member.roles;
    let eklenen = 0;
    let alinan = 0;
    try {
      for (const id of interaction.values.filter((v) => izinli.includes(v))) {
        if (roles.cache.has(id)) {
          await roles.remove(id);
          alinan++;
        } else {
          await roles.add(id);
          eklenen++;
        }
      }
      await interaction.followUp({
        content: `Vergebene Rollen: ${eklenen}, entfernte Rollen: ${alinan}.`,
        flags: MessageFlags.Ephemeral,
      });
    } catch (error) {
      console.error(error);
      await interaction.followUp({
        content: 'Die Rollen konnten nicht aktualisiert werden; prüfen Sie die Rollenberechtigung des Bots.',
        flags: MessageFlags.Ephemeral,
      });
    }
    return;
  }

  if (!interaction.isChatInputCommand()) return;
  // ... der bestehende Code für die Slash-Befehle bleibt unverändert
});

Da das Panel für alle gleich aussieht, zeigt das Menü nicht an, welche Rollen ein Mitglied bereits hat; deshalb arbeitet das Beispiel nach der Logik „gewählte Rolle vorhanden: entfernen, sonst: vergeben“. Die Liste izinli sorgt dafür, dass der Code nur die Rollen aus roller.js anfasst. Weil deferUpdate() die Interaktion sofort bestätigt, schlägt sie auch dann nicht fehl, wenn die Rollenvorgänge länger als 3 Sekunden dauern; außerdem setzt es den Zustand der Nachricht zurück, sodass die Auswahl im Menü gelöscht wird. Da editReply() in diesem Fall die Panel-Nachricht selbst bearbeiten würde, wird das Ergebnis mit followUp() als temporäre (ephemeral) Nachricht gemeldet, die nur die klickende Person sieht. Einen dauerhaften Button (z. B. zum Eröffnen eines Support-Tickets) verarbeiten Sie nach demselben Muster mit einer Prüfung über interaction.isButton() und customId.

5. Menüs zur Auswahl von Nutzern, Rollen und Kanälen verwenden

Den Menüs UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder und ChannelSelectMenuBuilder fügen Sie keine Optionen hinzu; Discord listet die Mitglieder, Rollen oder Kanäle des Servers selbst auf.

const {
  ChannelSelectMenuBuilder, ChannelType, UserSelectMenuBuilder,
} = require('discord.js');

const kisiMenu = new UserSelectMenuBuilder()
  .setCustomId('kisi-sec')
  .setMaxValues(5);

const kanalMenu = new ChannelSelectMenuBuilder()
  .setCustomId('kanal-sec')
  .setChannelTypes(ChannelType.GuildText);

setChannelTypes beschränkt die Liste auf Textkanäle. Unterscheiden Sie den Klick mit isUserSelectMenu(), isRoleSelectMenu(), isMentionableSelectMenu() oder isChannelSelectMenu(); im Array values kommen die gewählten IDs an. Das eignet sich für Einstellungsbefehle, etwa zur Auswahl eines Log-Kanals.

6. Befehle registrieren und testen

Registrieren Sie die neuen Befehlsdateien bei Discord und starten Sie den Bot:

npm run deploy
npm start

Probieren Sie auf dem Testserver die Befehle /onay, /oyun und /rol-paneli aus. Testen Sie den Filter, indem Sie mit einem zweiten Konto auf Buttons klicken, die jemand anderes geöffnet hat; starten Sie den Bot nach dem Test des Rollenpanels neu und prüfen Sie, ob das Panel weiterhin funktioniert.

Die Definitionen von Buttons und Menüs gehören zur Nachricht, nicht zur Befehlsregistrierung: Wenn Sie eine Beschriftung oder Option ändern, ist npm run deploy nicht nötig, ein Neustart des Bots genügt. Das alte Panel im Kanal zeigt die alten Komponenten; senden Sie das Panel erneut. Läuft der Bot auf dem VDS mit PM2 (Einrichtung in der Anleitung zum 24/7-Betrieb), führen Sie nach dem Aktualisieren der Dateien Folgendes aus:

pm2 restart discord-bot

Grenzen der Komponenten und Antwortmethoden

Die Werte stammen aus der Komponentenreferenz von Discord:

ElementGrenze
Aktionszeile (klassische Nachricht)Höchstens 5 pro Nachricht
Inhalt einer ZeileHöchstens 5 Buttons oder 1 Auswahlmenü
customId1–100 Zeichen; innerhalb derselben Nachricht eindeutig
Button-BeschriftungHöchstens 80 Zeichen
Option im AuswahlmenüHöchstens 25; label, value, description jeweils höchstens 100 Zeichen
placeholderHöchstens 150 Zeichen
setMinValues / setMaxValuesMindestwert 0–25, Höchstwert maximal 25; beide standardmäßig 1
Stil / MethodeWofür
ButtonStyle.Primary / SecondaryBlau-violette Hauptaktion / graue Nebenaktion (z. B. Abbrechen)
ButtonStyle.Success / DangerGrüne Bestätigung / rote destruktive Aktion (Löschen, Kicken)
ButtonStyle.LinkBenötigt setURL, kann keine customId haben; öffnet eine Adresse im Browser, beim Bot kommt keine Interaktion an
update()Antwortet, indem es die Nachricht mit der Komponente bearbeitet
deferUpdate()Bestätigt die Interaktion sofort; danach bearbeitet editReply() die Nachricht mit der Komponente, followUp() sendet eine neue Nachricht
reply() / deferReply()Eine neue Antwortnachricht; mit MessageFlags.Ephemeral sieht sie nur die klickende Person
followUp() / editReply()Zusätzliche Nachricht oder Bearbeitung nach der ersten Antwort

Häufige Fehler

  • Beim Klicken erscheint ein Fehlerhinweis (in der englischen Oberfläche „This interaction failed“): Es gibt keinen Code, der auf die Komponente hört (der Collector ist abgelaufen, der Bot wurde neu gestartet oder die customId im Code stimmt nicht mit der in der Nachricht überein), oder die Antwort hat länger als 3 Sekunden gedauert. Sehen Sie in der Konsole DiscordAPIError[10062]: Unknown interaction, waren Sie zu spät: Rufen Sie vor langen Vorgängen deferUpdate() oder deferReply() auf.
  • DiscordAPIError[40060]: Interaction has already been acknowledged: Auf dieselbe Interaktion wurde zweimal eine erste Antwort gegeben: Entweder verarbeiten sowohl der Collector als auch interactionCreate dieselbe customId, oder nach update() wurde reply() aufgerufen. Verwenden Sie nach der ersten Antwort followUp() oder editReply(); geben Sie dauerhaften und temporären Komponenten unterschiedliche Kennungen.
  • DiscordAPIError[50035]: Invalid Form Body: Discord hat die Komponentendefinition abgelehnt. Mehr als 5 Buttons in einer Zeile, Button und Menü in derselben Zeile, mehr als 25 Optionen, zwei Komponenten mit derselben Kennung, ein normaler Button ohne customId oder ein Link-Button mit customId lösen diesen Fehler aus.
  • DiscordAPIError[50013]: Missing Permissions beim Vergeben einer Rolle: Der Bot hat die Berechtigung „Rollen verwalten“ nicht, oder die zu vergebende Rolle liegt nicht unterhalb der höchsten Rolle des Bots. Ziehen Sie die Bot-Rolle in der Liste nach oben.
  • MessageButton is not a constructor: Der Code ist für discord.js v13 geschrieben. Die Entsprechungen in v14: MessageActionRow → ActionRowBuilder, MessageButton → ButtonBuilder, MessageSelectMenu → StringSelectMenuBuilder (der Name SelectMenuBuilder aus den ersten v14-Versionen und isSelectMenu() sind ebenfalls veraltet; verwenden Sie isStringSelectMenu()), 'PRIMARY' → ButtonStyle.Primary, 'BUTTON' → ComponentType.Button. Schreiben Sie statt des veralteten ephemeral: true nun flags: MessageFlags.Ephemeral.

Häufig gestellte Fragen

Was passiert mit den Buttons, wenn der Bot offline ist?

Die Buttons sehen anklickbar aus, doch da keine Antwort kommt, sieht der Nutzer einen Fehlerhinweis. Sobald der Bot wieder läuft, funktionieren die über interactionCreate verarbeiteten Panels wieder; Nachrichten, die an einen Collector gebunden sind, funktionieren nicht mehr. Entfernen Sie die Komponenten im Ereignis end des Collectors; wird der Bot vor Ablauf der Zeit beendet, läuft end nicht, und die verbliebenen alten Komponenten führen zu Fehlerhinweisen.

Kann ich beim Klick auf einen Button ein Formular öffnen?

Ja, mit showModal() können Sie ein Modal (Pop-up-Formular) anzeigen. Ein Modal ist eine erste Antwort; es öffnet sich nicht, wenn Sie in derselben Interaktion vorher deferUpdate(), deferReply() oder reply() aufgerufen haben.

Kann ich einen Button auf eine bestimmte Rolle beschränken?

Jeder, der die Nachricht sieht, kann klicken; die Beschränkung setzen Sie im Code um. Prüfen Sie die Rolle der klickenden Person mit interaction.member.roles.cache.has('rollen-id') und teilen Sie ihr bei fehlender Berechtigung dies mit einer temporären (ephemeral) Antwort mit; bleibt sie ohne Antwort, sieht sie einen Fehlerhinweis.

Was ist Components V2, und muss ich es verwenden?

Das ist das neue Nachrichtenlayout von Discord, das mit dem Flag IS_COMPONENTS_V2 kommt: Ist das Flag gesetzt, können content und Embeds nicht verwendet werden, der Inhalt wird aus Komponenten aufgebaut, und pro Nachricht sind 40 Komponenten erlaubt. Laut Discord werden die klassischen Komponenten nicht abgekündigt; die Logik von Buttons und Menüs ist in beiden Layouts gleich. Details finden Sie auf der Seite Display Components im discord.js-Guide, alle Klassen und Methoden in der discord.js-Dokumentation.

Verwandte Anleitungen

Weitere Bot-Anleitungen finden Sie auf der Seite Discord-Bot-Anleitungen, Serveroptionen auf der Seite Discord Bot VDS.

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.