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

Discord-Bot mit Discord.js v14 von Grund auf erstellen

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

In dieser Anleitung bauen Sie mit discord.js v14 von Anfang bis Ende einen Discord-Bot, der auf Slash-Befehle (/) reagiert: vom Anlegen der Anwendung im Developer Portal bis zum Einladungslink, von der Installation von Node.js bis zum Speichern des Tokens (des Anmeldeschlüssels des Bots) in einer .env-Datei und von der Registrierung der Befehle per REST bis zur Datei index.js. Am Ende haben Sie eine aufgeräumte Projektvorlage, die Sie mit einer Datei pro neuem Befehl erweitern können.

Bevor Sie beginnen

  • Ein Discord-Konto und ein Testserver: Auf dem Server, zu dem Sie den Bot einladen, benötigen Sie die Berechtigung „Server verwalten“ („Manage Server“). Legen Sie sich für Experimente einen leeren Server an.
  • Node.js LTS: Laut den Paketangaben auf npm benötigt discord.js 14 Node.js 18 oder neuer. Installieren Sie trotzdem die von nodejs.org empfohlene aktuelle LTS-Version (Long-Term Support); für die in dieser Anleitung verwendete Option „--env-file“ ist außerdem mindestens Node.js 20.6.0 erforderlich.
  • Ein Rechner, auf dem der Bot läuft: Für Entwicklung und Tests genügt Ihr eigener Computer; wird er jedoch ausgeschaltet oder wechselt er in den Ruhezustand, geht auch der Bot offline. Damit er dauerhaft online bleibt, verwenden Sie einen VDS. Die Discord Bot VDS-Pakete von HanHosting bieten 4 CPU, 2–4 GB RAM und 30–40 GB NVMe-Speicher; mit einem Linux-VDS verbinden Sie sich per SSH (22), mit einem Windows-VDS per RDP (3389).
  • Sie müssen keine Ports öffnen: Der Bot verbindet sich selbst per WebSocket mit dem Gateway-Server von Discord; für eingehende Verbindungen wird kein Port geöffnet.

1. Anwendung und Bot im Developer Portal erstellen

Melden Sie sich im Discord Developer Portal an:

  1. Klicken Sie auf die Schaltfläche New Application, geben Sie der Anwendung einen Namen und bestätigen Sie mit Create.
  2. Kopieren Sie auf der Seite General Information den Wert Application ID. Das ist die Kennung Ihrer Anwendung (CLIENT_ID).
  3. Wechseln Sie links zur Seite Bot. Hier legen Sie Namen und Avatar des Bots fest; der Schalter Public Bot bestimmt, ob auch andere den Bot zu ihren Servern hinzufügen können.
  4. Klicken Sie im Abschnitt Token auf Reset Token, bestätigen Sie und kopieren Sie den angezeigten Wert sofort. Der Token wird kein zweites Mal angezeigt; verlieren Sie ihn, setzen Sie ihn erneut zurück, und der alte Token wird ungültig.

Der Token ist das Passwort des Bots: Wer ihn besitzt, kann im Namen Ihres Bots Nachrichten senden, Kanäle löschen und Mitglieder entfernen. Schreiben Sie ihn nicht in Ihren Code und teilen Sie ihn weder in Screenshots noch in Support-Kanälen. Haben Sie einen kurzen Wert ohne Punkte kopiert, handelt es sich höchstwahrscheinlich um das Client Secret von der Seite OAuth2; damit kann sich der Bot nicht anmelden.

Auf derselben Seite befindet sich der Abschnitt Privileged Gateway Intents. Intents (Ereignisberechtigungen) legen fest, welche Ereignisse Discord an Ihren Bot sendet. Da das Beispiel in dieser Anleitung nur Slash-Befehle verwendet, benötigt es keine privilegierten Intents; soll Ihr Bot Nachrichteninhalte lesen oder die Mitgliederliste verfolgen, aktivieren Sie hier den entsprechenden Schalter. Bei nicht verifizierten Bots auf weniger als 100 Servern genügt es, den Schalter zu aktivieren; Bots auf 100 oder mehr Servern müssen verifiziert sein und für diese Intents eine gesonderte Freigabe erhalten.

2. Bot auf Ihren Testserver einladen

Laut der aktuellen Discord-Dokumentation erfolgt die Einladung über die Seite Installation:

  1. Achten Sie darauf, dass Guild Install im Abschnitt Installation Contexts aktiviert ist. Wenn Sie im Abschnitt Install Link die Option Discord Provided Link wählen, erscheint der Abschnitt Default Install Settings.
  2. Fügen Sie in diesem Abschnitt die Scopes applications.commands und bot für Guild Install hinzu. Markieren Sie in der Liste Permissions, die bei Auswahl von bot erscheint, die Berechtigungen, die der Bot tatsächlich benötigt. Der Beispiel-Bot braucht keine Administrator-Berechtigung; wenn Sie die Berechtigungen gering halten, begrenzen Sie den Schaden, falls der Token in falsche Hände gerät.
  3. Kopieren Sie die Adresse im Abschnitt Install Link, öffnen Sie sie im Browser, wählen Sie über Add to server Ihren Testserver aus und bestätigen Sie. Der Bot erscheint in der Mitgliederliste als offline; sobald Sie den Code ausführen, geht er online.

Alternativ können Sie im Bildschirm OAuth2 → URL Generator dieselben beiden Scopes auswählen und den erzeugten Link verwenden. Ein von Hand geschriebener Einladungslink sieht so aus; tragen Sie bei client_id Ihre eigene Application ID und bei permissions den Berechtigungswert ein:

https://discord.com/api/oauth2/authorize?client_id=123456789012345678&permissions=0&scope=bot%20applications.commands

Erhalten Sie den Fehler „Bot requires a code grant“, deaktivieren Sie in den Anwendungseinstellungen die Option Require OAuth2 Code Grant.

Ermitteln Sie zum Schluss die ID des Testservers: Aktivieren Sie in Discord in den Benutzereinstellungen im Abschnitt Erweitert (Advanced) den Schalter Entwicklermodus (Developer Mode), klicken Sie dann in der linken Liste mit der rechten Maustaste auf das Serversymbol und wählen Sie Server-ID kopieren (Copy Server ID); je nach Sprache der Oberfläche und Version kann der Menüname abweichen. Dieser Wert ist Ihre GUILD_ID.

3. Node.js-LTS-Version installieren

Windows (Ihr Computer oder ein Windows-VDS): Laden Sie von nodejs.org den mit LTS gekennzeichneten Windows Installer (.msi) herunter und installieren Sie ihn. Öffnen Sie ein neues PowerShell-Fenster und prüfen Sie die Versionen:

node -v
npm -v

Linux VDS (Ubuntu/Debian): Verbinden Sie sich per SSH mit dem Server und nutzen Sie die auf der Node.js-Downloadseite empfohlene Methode mit nvm (Node Version Manager). Das Paket nodejs aus dem eigenen Paket-Repository der Distribution kann hinter der von discord.js geforderten Version zurückliegen; mit nvm installieren Sie die aktuelle LTS-Version:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install --lts
node -v
npm -v

Wird der Befehl nvm nicht gefunden, schließen und öffnen Sie das Terminal erneut oder führen Sie source ~/.bashrc aus; die Ausgabe von command -v nvm sollte nvm lauten. nvm installiert Node.js nur für den Benutzer, der die Installation ausführt; führen Sie die Installation daher mit demselben Benutzer durch, unter dem der Bot später läuft.

4. Projekt anlegen und discord.js installieren

mkdir discord-bot
cd discord-bot
npm init -y
npm install discord.js

npm init -y erstellt eine package.json mit Standardwerten, und npm install discord.js lädt die Bibliothek in den Ordner node_modules herunter. Am Ende der Anleitung sieht Ihr Ordner so aus:

discord-bot/
├── commands/
│   └── utility/
│       ├── ping.js
│       └── hello.js
├── node_modules/
├── .env
├── .gitignore
├── deploy-commands.js
├── index.js
├── package-lock.json
└── package.json

Jeder Befehl ist eine eigene Datei unter commands; wenn Sie einen neuen Befehl hinzufügen, müssen Sie index.js nicht anfassen. Ändern Sie den Abschnitt scripts in package.json wie folgt:

"scripts": {
  "start": "node --env-file=.env index.js",
  "deploy": "node --env-file=.env deploy-commands.js"
}

5. Token in der .env-Datei ablegen

Erstellen Sie im Projektordner eine Datei namens .env und tragen Sie die drei Werte ohne Anführungszeichen ein:

DISCORD_TOKEN=your-bot-token
CLIENT_ID=your-application-id
GUILD_ID=your-test-server-id
VariableWo Sie den Wert findenVerwendet in
DISCORD_TOKENDeveloper Portal → Bot → Reset Tokenindex.js, deploy-commands.js
CLIENT_IDDeveloper Portal → General Information → Application IDdeploy-commands.js
GUILD_IDDiscord → Entwicklermodus → Server-ID kopierendeploy-commands.js (nur Server-Befehle)

Der discord.js-Guide empfiehlt, die Datei .env mit dem integrierten Flag --env-file von Node.js zu laden; ein zusätzliches Paket ist nicht nötig. Im Code werden die Werte als process.env.DISCORD_TOKEN gelesen. Ist derselbe Name auch in den Umgebungsvariablen des Systems definiert, hat der Systemwert Vorrang; wird die Datei nicht gefunden, bricht Node.js mit einem Fehler ab und startet nicht.

Damit der Token nicht versehentlich in einem Git-Repository landet, erstellen Sie im Stammverzeichnis des Projekts eine Datei .gitignore:

node_modules
.env

Führen Sie unter Linux chmod 600 .env aus, damit nur Ihr eigener Benutzer die Datei lesen kann. Unter Windows speichert der Editor (Notepad) die Datei unter Umständen als .env.txt; wählen Sie beim Speichern als Dateityp „Alle Dateien“ („All files“) und prüfen Sie den Namen in PowerShell mit dir.

6. Die ersten Slash-Befehle schreiben

Erstellen Sie den Ordner commands/utility. Jede Befehlsdatei exportiert zwei Dinge: die Definition, die bei Discord registriert wird (data), und die Funktion, die bei Verwendung des Befehls ausgeführt wird (execute).

commands/utility/ping.js:

const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('ping')
    .setDescription('Checks that the bot is running.'),
  async execute(interaction) {
    await interaction.reply('Pong!');
  },
};

Der zweite Befehl nimmt eine optionale Benutzer-Option entgegen; bleibt sie leer, begrüßt er die Person, die den Befehl eingegeben hat. commands/utility/hello.js:

const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('hello')
    .setDescription('Greets a user.')
    .addUserOption((option) =>
      option.setName('user').setDescription('The user to greet'),
    ),
  async execute(interaction) {
    const target = interaction.options.getUser('user') ?? interaction.user;
    await interaction.reply(`Hello ${target.username}!`);
  },
};

Befehls- und Optionsnamen müssen 1–32 Zeichen lang, kleingeschrieben und ohne Leerzeichen sein; außer Buchstaben (einschließlich Umlauten wie ä, ö und ü) und Ziffern sind als Sonderzeichen nur - und _ erlaubt. Eine Beschreibung ist Pflicht und muss 1–100 Zeichen lang sein.

7. Befehle bei Discord registrieren (REST)

Um die Befehle bei Discord zu registrieren, erstellen Sie im Stammverzeichnis des Projekts die Datei deploy-commands.js. Das Skript sammelt alle Definitionen aus dem Ordner commands und sendet sie per PUT-Anfrage an die REST-API:

const { REST, Routes } = require('discord.js');
const fs = require('node:fs');
const path = require('node:path');

const { DISCORD_TOKEN, CLIENT_ID, GUILD_ID } = process.env;

const commands = [];
const foldersPath = path.join(__dirname, 'commands');

for (const folder of fs.readdirSync(foldersPath)) {
  const commandsPath = path.join(foldersPath, folder);
  const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));
  for (const file of commandFiles) {
    const command = require(path.join(commandsPath, file));
    if ('data' in command && 'execute' in command) {
      commands.push(command.data.toJSON());
    } else {
      console.log(`[WARNING] ${file}: missing data or execute.`);
    }
  }
}

const rest = new REST().setToken(DISCORD_TOKEN);

(async () => {
  try {
    console.log(`Registering ${commands.length} commands...`);
    const data = await rest.put(
      Routes.applicationGuildCommands(CLIENT_ID, GUILD_ID),
      { body: commands },
    );
    console.log(`Registered ${data.length} commands.`);
  } catch (error) {
    console.error(error);
  }
})();

Führen Sie das Skript aus:

npm run deploy

War dies erfolgreich, erscheinen /ping und /hello, sobald Sie im Testserver / eingeben. Die PUT-Anfrage ersetzt die Befehlsliste auf diesem Server vollständig durch die gesendete Liste; ein Befehl, dessen Datei Sie gelöscht haben, verschwindet bei der nächsten Registrierung. Führen Sie das Skript nur erneut aus, wenn sich eine Befehlsdefinition (Name, Beschreibung, Optionen) ändert; haben Sie den Code innerhalb von execute geändert, genügt ein Neustart des Bots.

Wenn die Befehle fertig sind, verwenden Sie Routes.applicationCommands(CLIENT_ID) statt Routes.applicationGuildCommands(CLIENT_ID, GUILD_ID), um sie auf allen Servern verfügbar zu machen:

EigenschaftServer-Befehl (Guild)Globaler Befehl
RouteRoutes.applicationGuildCommands(CLIENT_ID, GUILD_ID)Routes.applicationCommands(CLIENT_ID)
Wo er erscheintNur auf dem Server GUILD_IDAuf allen Servern, denen die Anwendung hinzugefügt wurde, sowie in den DMs (Direktnachrichten) von Benutzern, die einen Server mit dem Bot teilen
AktualisierungSofortDie Anfrage einer Person, die noch die alte Version verwenden will, wird abgelehnt, und der Befehl wird in ihrem Client aktualisiert
EinsatzEntwicklung und TestsVeröffentlichungsreife Befehle

Registrieren Sie denselben Befehl sowohl auf dem Server als auch global, erscheint er im Testserver doppelt. Verwenden Sie während der Entwicklung eine separate Testanwendung oder leeren Sie die Server-Befehle mit einer leeren Liste ({ body: [] }).

8. Bot mit index.js starten

index.js lädt die Befehlsdateien, verbindet sich mit Discord und leitet jeden eingehenden Befehl an die passende Datei weiter:

const fs = require('node:fs');
const path = require('node:path');
const { Client, Collection, Events, GatewayIntentBits, MessageFlags } = require('discord.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

// Load the command files
client.commands = new Collection();
const foldersPath = path.join(__dirname, 'commands');

for (const folder of fs.readdirSync(foldersPath)) {
  const commandsPath = path.join(foldersPath, folder);
  const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));
  for (const file of commandFiles) {
    const command = require(path.join(commandsPath, file));
    if ('data' in command && 'execute' in command) {
      client.commands.set(command.data.name, command);
    } else {
      console.log(`[WARNING] ${file}: missing data or execute.`);
    }
  }
}

// Runs once when the bot is ready
client.once(Events.ClientReady, (readyClient) => {
  console.log(`Ready! Logged in as ${readyClient.user.tag}.`);
});

// Handle slash commands
client.on(Events.InteractionCreate, async (interaction) => {
  if (!interaction.isChatInputCommand()) return;

  const command = interaction.client.commands.get(interaction.commandName);
  if (!command) {
    console.error(`No command named ${interaction.commandName} was found.`);
    return;
  }

  try {
    await command.execute(interaction);
  } catch (error) {
    console.error(error);
    const response = { content: 'There was an error while running this command.', flags: MessageFlags.Ephemeral };
    if (interaction.replied || interaction.deferred) {
      await interaction.followUp(response);
    } else {
      await interaction.reply(response);
    }
  }
});

client.login(process.env.DISCORD_TOKEN);

Starten Sie den Bot:

npm start

Innerhalb weniger Sekunden sollte im Terminal die Bereitschaftsmeldung aus dem obigen Code erscheinen; der Bot geht auf dem Server online und beantwortet den Befehl /ping mit „Pong!“. Zum Beenden drücken Sie im Terminal Strg+C. Drei Punkte, die Sie zum Code wissen sollten:

  • GatewayIntentBits.Guilds füllt die Caches für Server, Kanäle und Rollen; es ist erforderlich, damit discord.js wie erwartet funktioniert, und reicht für Slash-Befehle allein aus.
  • Discord erwartet die erste Antwort auf eine Interaktion innerhalb von 3 Sekunden. Rufen Sie bei länger dauernden Aufgaben wie einer Datenbankabfrage oder einem externen API-Aufruf zuerst await interaction.deferReply() auf und senden Sie das Ergebnis dann mit interaction.editReply(); in diesem Fall haben Sie 15 Minuten Zeit.
  • Eine mit MessageFlags.Ephemeral gesendete Antwort sieht nur die Person, die den Befehl verwendet hat; das ist praktisch, um Fehlermeldungen aus dem Kanal herauszuhalten.

9. Bot 24/7 auf einem VDS betreiben

Ein mit npm start gestarteter Prozess ist an das Terminal gebunden: Schließen Sie die SSH-Sitzung oder das PowerShell-Fenster oder startet der Server neu, stoppt auch der Bot. Für einen unterbrechungsfreien Betrieb übergeben Sie den Prozess an einen Prozessmanager wie PM2 oder an einen systemd-Dienst; diese Werkzeuge starten den Bot nach einem Absturz neu und beim Hochfahren des Servers automatisch. Die Einrichtung Schritt für Schritt finden Sie in der Anleitung Discord-Bot 24/7 auf einem VDS online halten. Kopieren Sie beim Umzug des Projekts auf den Server nicht den Ordner node_modules; führen Sie auf dem Server npm install aus (die Abhängigkeiten werden aus package-lock.json wiederhergestellt) und legen Sie die Datei .env dort neu an.

Auswahl der Intents und Übersicht der Einstellungen

IntentPrivilegiert?Was es liefertIn diesem Beispiel
GuildsNeinInformationen zu Servern, Kanälen und Rollen; ausreichend für Slash-BefehleErforderlich
GuildMessagesNeinNachrichtenereignisse in Serverkanälen (messageCreate)Nicht nötig
MessageContentJaLesen von Nachrichtentext, Anhängen und Embeds (Nachrichtenboxen mit Rich Content); für Präfix-Bots (!command)Nicht nötig
GuildMembersJaEreignisse beim Beitreten und Verlassen von Mitgliedern, MitgliederlisteNicht nötig
GuildPresencesJaOnline-Status und AktivitätsinformationenNicht nötig

Der in älteren Beispielen verbreitete Ansatz „Ping in einen Kanal schreiben und Pong! zurückbekommen“ erfordert die Intents GuildMessages und MessageContent gemeinsam; außerdem muss im Developer Portal der Schalter Message Content aktiviert sein. Ohne diese Berechtigung sieht der Bot den Nachrichtentext als leer – außer bei eigenen Nachrichten, Nachrichten, in denen er erwähnt wird, und DMs.

Häufige Fehler

  • „An invalid token was provided.“ client.login() hat einen ungültigen Wert erhalten. Haben Sie den Bot mit node index.js gestartet, also ohne --env-file, ist process.env.DISCORD_TOKEN leer; verwenden Sie npm start. Derselbe Fehler tritt auf, wenn Sie statt des Tokens das Client Secret kopiert oder die Datei .env nach dem Zurücksetzen des Tokens nicht aktualisiert haben.
  • Ein Fehler, der mit [DisallowedIntents] beginnt: Sie haben im Code MessageContent, GuildMembers oder GuildPresences angefordert, aber der entsprechende Schalter auf der Bot-Seite im Developer Portal ist deaktiviert. Aktivieren Sie den Schalter oder entfernen Sie den Intent aus dem Code.
  • Bei Eingabe von / erscheinen keine Befehle: Möglicherweise wurde npm run deploy nicht ausgeführt, GUILD_ID gehört zu einem anderen Server, oder beim Einladen des Bots wurde der Scope applications.commands nicht ausgewählt. Prüfen Sie die Anzahl der Befehle in der Ausgabe des Registrierungsskripts.
  • DiscordAPIError[50001]: Missing Access bei der Registrierung: Meist wurde die Anwendung nicht zum Server GUILD_ID hinzugefügt, oder die IDs wurden vertauscht. Wiederholen Sie die Einladung und stellen Sie sicher, dass CLIENT_ID die Application ID und GUILD_ID die Server-ID ist.
  • Der Befehl reagiert nicht, oder in der Konsole erscheint Unknown interaction (10062): Läuft der Bot in diesem Moment nicht, meldet Discord, dass der Befehl nicht reagiert hat; läuft der Bot, hat die erste Antwort aber länger als 3 Sekunden gedauert, erscheint dieser Fehler in der Konsole. Verwenden Sie für lange Aufgaben deferReply(). Betreiben Sie den Bot nicht gleichzeitig an zwei Orten mit demselben Token (zum Beispiel auf Ihrem Computer und auf dem VDS); beide Prozesse versuchen sonst, denselben Befehl zu beantworten.
  • .env wird nicht gefunden oder --env-file wird nicht erkannt: Führen Sie den Befehl im Projektordner aus und prüfen Sie unter Windows, dass der Dateiname nicht .env.txt lautet. In Node.js-Versionen vor 20.6.0 gibt es --env-file nicht; prüfen Sie Ihre Version mit node -v und wechseln Sie auf die LTS-Version.

Häufig gestellte Fragen

Wie viel RAM braucht ein einfacher Bot?

Ein Bot, der auf einigen Servern Slash-Befehle ausführt, kommt mit wenigen Ressourcen aus; der Bedarf steigt mit der Anzahl der Server und Mitglieder, den zwischengespeicherten Daten und Zusätzen wie einer Datenbank oder Musik. Starten Sie den Bot und beobachten Sie seinen RAM-Verbrauch in den Live-Nutzungsdiagrammen im Kundenbereich. Die Discord-Bot-VDS-Pakete bieten 2–4 GB RAM.

Was sollte ich tun, wenn mein Token in falsche Hände gerät?

Klicken Sie im Developer Portal auf der Bot-Seite sofort auf Reset Token. Der alte Token wird ungültig; tragen Sie den neuen Wert in die Datei .env ein und starten Sie den Bot neu. Haben Sie den Token in ein Git-Repository gepusht, reicht es nicht, ihn aus der Repository-Historie zu löschen; Sie müssen ihn unbedingt zurücksetzen.

Funktionieren alte Codebeispiele aus dem Internet in v14?

Die meisten funktionieren nicht unverändert. In v14 wird GatewayIntentBits.Guilds statt Intents.FLAGS.GUILDS, EmbedBuilder statt MessageEmbed und ButtonBuilder statt MessageButton verwendet; auch String-Konstanten wie 'STRING' wurden zu Enum-Werten wie ApplicationCommandOptionType.String. Sehen Sie diese alten Namen im Code, ist der Code für v13 geschrieben. Die vollständige Liste der Klassen und Methoden finden Sie 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.