Inhalt
Python-Version wählen
Unter Bot › Bot-Einstellungen wählst du Python 3.11, 3.12, 3.13 oder 3.14. Nimm die Version, mit der dein Bot auf deinem PC läuft. Die Pakete installiert pip im Ordner .local deines Servers. Nach dem Wechsel startest du den Bot neu.

Was beim Start passiert
Bei jedem Start arbeitet der Server diese Schritte der Reihe nach ab:
- Ist ein Git-Repository verbunden und Automatisch aktualisieren auf 1 gesetzt, holt er zuerst den neuesten Stand mit git pull.
- Pakete aus dem Feld Zusätzliche Pakete (zum Beispiel aiohttp python-dotenv) installiert pip.
- Gibt es die Requirements-Datei, installiert pip alle Pakete daraus.
- Fehlt die Startdatei, bleibt der Server an und meldet „Startdatei … nicht gefunden“. Sonst startet
python -udie Datei.
requirements.txt anlegen
- In die requirements.txt schreibst du pro Zeile ein Paket, der Beispiel-Bot enthält die Zeile
discord.py>=2.4. - Den Dateinamen änderst du im Feld Requirements-Datei der Bot-Einstellungen, zum Beispiel für eine Datei in einem Unterordner.
- Lade keinen Ordner .venv oder venv hoch. Die Pakete entstehen auf dem Server aus deiner requirements.txt.
discord.py, py-cord oder nextcord
Alle drei Bibliotheken laufen auf dem Server, solange ihre Pakete in der requirements.txt stehen. Sie teilen sich den Paketnamen discord und stören sich gegenseitig, deshalb gehört immer nur eine von ihnen in die Datei.
- Der Beispiel-Bot nutzt discord.py mit
app_commandsfür Slash-Befehle. - Nach einem Wechsel der Bibliothek passt du auch die Importe in deinem Code an.
Startdatei und Konsole
Die Startdatei (Standard: main.py) trägst du in den Bot-Einstellungen ein, zum Beispiel bot.py oder src/main.py. Der Server startet Python mit der Option -u, also ungepuffert: Jede Ausgabe von print erscheint sofort in der Konsole.
Der Token in Python
Lies den Token mit os.environ["DISCORD_TOKEN"] und trage ihn im Feld Discord-Bot-Token ein, siehe Bot-Token eintragen. Die Umgebungsvariable ist auch ohne python-dotenv und ohne .env-Datei gesetzt.
Der Beispiel-Bot mit discord.py
Nach der Bestellung liegt ein Beispiel-Bot bereit (main.py und requirements.txt). Er nutzt discord.Intents.default(), registriert über tree.sync() den Befehl /ping und antwortet mit der Latenz.
In der Konsole siehst du „Bot ist online als …“. Fehlt der Token, meldet der Beispiel-Bot „Kein Bot-Token gesetzt“ und bleibt aktiv, bis du ihn einträgst. Fängt discord.py einen LoginFailure ab, steht in der Konsole „Anmeldung bei Discord fehlgeschlagen“ mit der Meldung der Bibliothek.
Typische Meldungen bei Python
- ModuleNotFoundError: No module named 'xyz': Das Paket fehlt in der requirements.txt oder steht dort unter einem anderen Namen als im Import.
- Improper token has been passed: Der Token ist falsch oder wurde im Developer Portal zurückgesetzt.
- PrivilegedIntentsRequired: Dein Code fordert einen Intent an, der im Developer Portal nicht eingeschaltet ist.
- Startdatei … nicht gefunden: Dateiname oder Ordner in den Bot-Einstellungen passen nicht zu dem, was unter Dateien liegt.
Fertige Vorlage auf GitHub
Als Ausgangspunkt gibt es eine freie Vorlage für Python (discord.py): discord-bot-starter-python. Sie enthält Slash-Befehle, Beispielbefehle, ein Dockerfile und eine ausführliche Anleitung auf Deutsch (MIT-Lizenz). Du kannst sie auch ohne VentroHosting nutzen.
Häufige Fragen
Mein Bot meldet „ModuleNotFoundError“. Was tun?
Das Paket fehlt in der requirements.txt. Trage es dort ein oder in den Bot-Einstellungen bei „Zusätzliche Pakete“ und starte neu.
Warum erscheinen meine print-Ausgaben sofort in der Konsole?
Der Server startet Python mit der Option -u, also ohne Pufferung. Du brauchst kein flush=True.
Darf die requirements.txt anders heißen?
Ja. Den Namen trägst du in den Bot-Einstellungen im Feld „Requirements-Datei“ ein, auch mit Ordner.
Unsere Empfehlung: Bot Plus
1 GB RAM für 2,99 € pro 30 Tage, ohne Abo. Nach der Bezahlung wird der Server automatisch eingerichtet.