Um einen Pycord-Bot 24/7 zu hosten, lässt du ihn auf einem Rechner laufen, der immer an bleibt, statt auf deinem PC: auf einem Linux-VPS mit einem systemd-Dienst, wenn du selbst hostest, oder auf einem Bot-Tarif bei PlayNHost Discord-Bot-Hosting (ab 1,99 US$ im Monat), wo du deinen Code hochlädst, den Token einfügst und auf Start drückst. In unserem Test belegte ein Pycord-2.8.1-Bot etwa 51 MB Speicher und erreichte Discord etwa 1,1 Sekunden nach dem Start. Pycord wird als py-cord installiert, aber als discord importiert, also unter demselben Namen wie discord.py. Trage deshalb nur eine der beiden Bibliotheken ein. Die Schritte bei PlayNHost:
- Klicke auf der Seite Discord-Bot-Hosting bei einem Tarif auf Server erstellen. Beantworte im Bestellfenster die Frage Wofür ist dein Bot? mit Discord und wähle Python.
- Öffne deinen Server im Panel. Die Karte Deinen Bot einrichten auf der Übersicht öffnet sich bei Mit Discord verbinden. Der erste Schritt, Was läuft, sollte Dieser Bot führt Python Bot aus. anzeigen; klicke auf diesen Schritt, um das zu prüfen, dann auf Weiter.
- Füge bei Mit Discord verbinden deinen Token unter Füge deinen Bot-Token ein ein, klicke auf Verbinden und dann auf Ja, weiter.
- Setze bei Berechtigungen nur dann ein Häkchen bei Mein Code nutzt das, wenn dein Code privilegierte Intents anfordert (der Bot unten braucht keine), klicke auf Zu einem Discord-Server hinzufügen und dann auf Weiter.
- Klicke bei Dein Code auf Dateien hochladen und lade
bot.pysowie einerequirements.txthoch, in derpy-cordsteht, oder klicke auf Git verbinden. - Wenn deine Hauptdatei nicht
bot.pyheißt, lege die Startdatei auf der Seite Bot im Bereich Code fest und klicke auf Speichern. - Klicke auf Bot starten und beobachte die Console. Sobald dein Bot
Logged in as ...ausgibt, zeigt die Karte Dein Bot ist online in Discord.
Die allgemeinen Python-Schritte (Laufzeitumgebung, Pakete, Konsolenzeilen) stehen in So hostest du einen Python-Discord-Bot. Diese Seite behandelt, was bei Pycord anders ist.
Was wir gemessen haben
Wir haben jede Python-Discord-Bibliothek auf unseren eigenen Servern laufen lassen, im selben Python-3.12-Setup, das ein Bot-Tarif nutzt, mit einem Speicherlimit von 1 GB:
| Bibliothek | Version | Speicher ohne Last | Start bis zur Antwort von Discord |
|---|---|---|---|
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 s |
| hikari | 2.7.0 | 61 MB | 1.3 s |
| Python allein | 3.12 | 9 MB |
So haben wir gemessen: das kleinstmögliche Programm, das die Bibliothek lädt und sich mit einem falschen Token anmeldet, installiert so, wie unsere Server es installieren. Der Speicher ist das, was der Prozess 15 Sekunden nach der Ablehnung des Tokens durch Discord belegte, und die Startzeit läuft vom Start bis zu dieser Antwort, enthält also einen Weg zu Discord. Jeder Wert ist der Median aus drei Läufen nach einem Aufwärmlauf. Das ist die Untergrenze: Ein Bot, der verbunden ist, Servern beigetreten ist und Mitglieder zwischengespeichert hat, braucht mehr, je nach Bot unterschiedlich viel.
Was das für den Tarif bedeutet: Ein minimaler Pycord-Bot belegt etwa ein Zehntel des STARTER-Tarifs mit 0.5 GB. Wähle den Tarif nach dem, was dein eigener Bot im Speicher hält, nicht nach der Bibliothek.
Ein minimaler Pycord-Bot
Er antwortet mit einem Slash-Command auf /ping und gibt eine Bereit-Zeile aus. Den Token liest er aus DISCORD_TOKEN, dem Namen, den das Panel deinem Code gibt.
requirements.txt
py-cord>=2.8,<3
bot.py
import os
import discord
bot = discord.Bot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
await ctx.respond("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
discord.Bot ist die eigene Klasse von Pycord für Slash-Commands. Sie registriert /ping bei jeder Verbindung von selbst bei Discord, weil auto_sync_commands standardmäßig aktiv ist, du musst also keinen Sync-Schritt schreiben. Die Zeile Logged in as schaltet den Chip auf der Übersicht auf Online in Discord.
Wenn der Token falsch ist
Wenn Discord den Token ablehnt, löst Pycord diesen Fehler aus (der Text, den unser Testbot ausgegeben hat):
LoginFailure: Improper token has been passed.
Bei bot.run() endet ein Traceback mit discord.errors.LoginFailure: Improper token has been passed. und der Bot hält an. Das Panel liest diese Zeile: Der Chip zeigt Token-Problem und ein Banner meldet Discord hat deinen Bot-Token nicht akzeptiert. Hole dir im Discord Developer Portal einen neuen Token: deine Anwendung, Bot, Reset Token (er wird nur einmal angezeigt). Klicke im Banner auf Token ersetzen, dann im Bereich Discord auf Token ersetzen, füge ihn ein und starte den Bot erneut. Siehe So erstellst du einen Discord-Bot und holst seinen Token.
Was ein Host über Pycord wissen muss
- Installationsname und Importname unterscheiden sich. Du installierst
py-cordund schreibstimport discord. discord.py installiert ein Modul mit demselben Namen,discord, die beiden können also nicht nebeneinander existieren. Die Anleitung von Pycord sagt, dass du discord.py zuerst deinstallieren sollst, und warnt, dass es Probleme geben kann, wenn du discord.py nach der Installation von py-cord deinstallierst. - Einen Server von discord.py auf Pycord umstellen. Unsere Server installieren Pakete in einen Ordner
.localund entfernen nie eines, das du aus derrequirements.txtnimmst, daher bliebe discord.py neben Pycord bestehen. Lösche unter Files den Ordner.localund die Datei.pnh/packages.stateund drücke dann auf Starten: Alles in derrequirements.txtwird neu installiert, ohne discord.py. - Python-Version. Pycord 2.8.1 unterstützt Python 3.10 bis 3.14. Die Laufzeitumgebung im Bereich Code bietet genau diese an, mit 3.12 als Standard, jede Wahl funktioniert also.
- Intents.
discord.Bot()nutzt die Standard-Intents, die keinen privilegierten enthalten, und Slash-Commands brauchen keinen. Präfix-Befehle wie!pingbrauchenintents.message_content = Truein deinem Code und einen eingeschalteten Message Content Intent im Developer Portal. Wenn dein Code ihn anfordert, während er im Portal aus ist, lehnt Discord die Anmeldung ab. Siehe „Used disallowed intents“ bei deinem Discord-Bot beheben. - Lass on_connect frei. Die automatische Registrierung läuft im bot-eigenen
on_connect. Wenn duon_connectselbst definierst, sagt die Dokumentation von Pycord, dass du darinawait bot.sync_commands()aufrufen sollst, sonst werden deine Befehle nicht mehr aktualisiert. Lege Startcode inon_readyab, wie oben. - Logging ist aus, solange du es nicht einschaltest.
run()von Pycord richtet kein Logging ein, daher zeigt Python nur die Warnungen und Fehler der Bibliothek, nicht ihre Info-Zeilen wie die Anmeldung. Gib deine eigene Bereit-Zeile aus, wie oben, oder rufelogging.basicConfig(level=logging.INFO)auf, um zu sehen, was die Bibliothek tut. - Voice. Für Sprachkanäle schreibst du
py-cord[voice]in dierequirements.txtstattpy-cord.
Selbst hosten auf einem Linux-VPS
Installiere unter Debian oder Ubuntu Python, lege einen Benutzer und einen Ordner für den Bot an und installiere Pycord in einer virtuellen Umgebung:
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt
Lege den Token in eine Datei, die nur root lesen kann. Erstelle /etc/pycord-bot.env mit sudo nano /etc/pycord-bot.env, schreibe eine Zeile, DISCORD_TOKEN= gefolgt von deinem Token, speichere sie und führe sudo chmod 600 /etc/pycord-bot.env aus.
Erstelle dann /etc/systemd/system/pycord-bot.service:
[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-bot/venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Starte ihn jetzt und bei jedem Systemstart und verfolge dann seine Ausgabe:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 sorgt dafür, dass print() sofort im Journal ankommt und nicht erst, wenn ein Puffer voll ist. Um den Bot zu aktualisieren, kopiere die neuen Dateien, führe die Zeile mit pip install erneut aus und dann sudo systemctl restart pycord-bot.
Selbst hosten oder Bot-Tarif
| Dein eigener VPS | Ein PlayNHost-Bot-Tarif | |
|---|---|---|
| Python | Die Version, die deine Distribution mitbringt; du installierst und aktualisierst sie | Wähle 3.10 bis 3.14 unter Laufzeitumgebung |
| Pakete | Du führst nach jeder Änderung pip install aus | Werden bei einem Start installiert, nachdem sich requirements.txt oder die Python-Version geändert hat, und beim ersten Start einen Tag nach der letzten Installation |
| Neustarts | Deine systemd-Unit | Wird nach einem Absturz erneut gestartet; bleibt mit Angabe des Grundes gestoppt, wenn er innerhalb einer Minute erneut abstürzt |
| Der Token | Eine Datei, die du selbst schützt | Verschlüsselt gespeichert, beim Einfügen mit Discord geprüft und als DISCORD_TOKEN an deinen Code übergeben |
| Fehler | Du liest das Journal | Das Konsolenbanner nennt die Ursache, etwa einen falschen Token oder einen fehlenden Intent |
| Systemupdates, Firewall, SSH | Musst du selbst erledigen | Nicht deine Aufgabe |
Häufige Fragen
Kann ich Pycord und discord.py im selben Bot haben?
Nein. Beide installieren das Modul discord, also überschreibt eines das andere. Lass nur py-cord in der requirements.txt. Wenn auf dem Server vorher discord.py lief, lösche .local und .pnh/packages.state unter Files, damit die Pakete sauber neu installiert werden.
Warum erscheint /ping nicht auf meinem Server?
Prüfe, ob der Bot über Zu einem Discord-Server hinzufügen hinzugefügt wurde und ob die Konsole die Zeile Logged in as zeigt: Pycord registriert den Befehl bei der Verbindung. Übergib beim Testen debug_guilds=[your_server_id] an discord.Bot(): Die Befehle werden dann nur auf diesem Server angelegt, und laut der Dokumentation von Discord werden Server-Befehle sofort aktualisiert.
Ist Pycord dasselbe wie discord.py?
Nein. Pycord begann als Fork von discord.py und behält vieles von dessen API, etwa discord.Client und discord.ext.commands, aber die Slash-Commands unterscheiden sich: @bot.slash_command und ctx.respond() in Pycord, app_commands und ein Sync-Aufruf in discord.py. Code für die eine Bibliothek läuft nicht immer mit der anderen.
Passt ein Pycord-Bot in den kleinsten Tarif?
Ja. Mit etwa 51 MB in unserem Test belegt ein minimaler Pycord-Bot etwa ein Zehntel des STARTER-Tarifs mit 0.5 GB. Steige um, wenn dein Bot es selbst braucht: große Server, deren Mitglieder er zwischenspeichert, Dateien oder Bilder, die er verarbeitet, oder Daten, die er im Speicher hält.
Bereit, deinen zu starten? Wähle einen Tarif bei Discord-Bot-Hosting und lade deinen Pycord-Bot hoch.



