Om een Pycord-bot 24/7 te hosten, draai je hem op een machine die aan blijft in plaats van op je pc: een Linux-VPS met een systemd-service als je zelf host, of een botabonnement bij PlayNHost Discord-bothosting (vanaf US$1.99 per maand), waar je je code uploadt, het token plakt en op Starten drukt. In onze test gebruikte een Pycord 2.8.1-bot ongeveer 51 MB geheugen en bereikte hij Discord ongeveer 1,1 seconde na het starten. Pycord installeer je als py-cord, maar je importeert het als discord, dezelfde naam als discord.py, dus vermeld er maar één van de twee. De stappen bij PlayNHost:
- Klik op de pagina Discord-bothosting bij een abonnement op Server aanmaken. Beantwoord in het bestelvenster Voor welk platform is je bot? met Discord en kies Python.
- Open je server in het paneel. De kaart Je bot instellen op het Overzicht opent bij Verbinden met Discord. De eerste stap, Wat er draait, hoort Deze bot draait Python Bot. te tonen; klik op die stap om het te controleren en dan op Doorgaan.
- Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en dan op Ja, doorgaan.
- Vink bij Rechten Mijn code gebruikt dit alleen aan voor de bevoorrechte intents die je code vraagt (de bot hieronder heeft er geen nodig), klik op Toevoegen aan een Discord-server en dan op Doorgaan.
- Klik bij Je code op Bestanden uploaden en upload
bot.pyen eenrequirements.txtwaarinpy-cordstaat, of klik op Git koppelen. - Als je hoofdbestand niet
bot.pyheet, stel je het Startbestand in op de pagina Bot, deelvenster Code, en klik je op Opslaan. - Klik op Bot starten en bekijk de Console. Zodra je bot
Logged in as ...afdrukt, zegt de kaart Je bot is online in Discord.
De algemene Python-stappen (runtime, pakketten, consoleregels) staan in Een Python Discord-bot hosten. Deze pagina behandelt wat er bij Pycord anders is.
Wat we hebben gemeten
We hebben elke Python-Discordbibliotheek op onze eigen servers laten draaien, in dezelfde Python 3.12-opzet die een botabonnement gebruikt, met een geheugenlimiet van 1 GB:
| Bibliotheek | Versie | Geheugen in rust | Van start tot antwoord van 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 alleen | 3.12 | 9 MB |
Hoe: het kleinste programma dat de bibliotheek laadt en inlogt met een nep-token, geïnstalleerd zoals onze servers het installeren. Het geheugen is wat het proces vasthield 15 seconden nadat Discord het token had geweigerd, en de starttijd loopt van het starten tot dat antwoord, dus er zit één reis naar Discord in. Elk cijfer is de mediaan van drie runs na een opwarmrun. Het is de ondergrens: een bot die verbonden is, servers is binnengegaan en leden in de cache heeft, gebruikt meer, afhankelijk van de bot.
Wat het betekent voor het abonnement: een minimale Pycord-bot neemt ongeveer een tiende van het STARTER-abonnement van 0.5 GB in beslag. Kies het abonnement op basis van wat je eigen bot in het geheugen houdt, niet op basis van de bibliotheek.
Een minimale Pycord-bot
Hij antwoordt op /ping met een slash-command en drukt een klaar-regel af. Hij leest het token uit DISCORD_TOKEN, de naam die het paneel aan je code geeft.
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 is de eigen klasse van Pycord voor slash-commands. Hij registreert /ping bij elke verbinding zelf bij Discord, omdat auto_sync_commands standaard aan staat, dus je hoeft geen syncstap te schrijven. De regel Logged in as zet de chip op het Overzicht op Online in Discord.
Als het token fout is
Als Discord het token weigert, geeft Pycord deze fout (de tekst die onze testbot afdrukte):
LoginFailure: Improper token has been passed.
Met bot.run() eindigt een traceback met discord.errors.LoginFailure: Improper token has been passed. en stopt de bot. Het paneel leest die regel: de chip toont Tokenprobleem en een banner meldt Discord heeft je bottoken niet geaccepteerd. Haal een nieuw token op in het Discord Developer Portal: je applicatie, Bot, Reset Token (het wordt maar één keer getoond). Klik in de banner op Token vervangen, dan in het deelvenster Discord op Token vervangen, plak het en start de bot opnieuw. Zie Een Discord-bot maken en zijn token ophalen.
Wat een host over Pycord moet weten
- Installatienaam en importnaam verschillen. Je installeert
py-corden schrijftimport discord. discord.py installeert een module met dezelfde naam,discord, dus de twee kunnen niet naast elkaar bestaan. De eigen gids van Pycord zegt dat je discord.py eerst moet verwijderen, en waarschuwt dat het verwijderen van discord.py na het installeren van py-cord problemen kan geven. - Een server van discord.py naar Pycord verplaatsen. Onze servers installeren pakketten in een map
.localen verwijderen nooit een pakket dat je uitrequirements.txthaalt, dus discord.py zou naast Pycord blijven staan. Verwijder in Files de map.localen het bestand.pnh/packages.stateen druk dan op Starten: alles inrequirements.txtwordt opnieuw geïnstalleerd, zonder discord.py. - Python-versie. Pycord 2.8.1 ondersteunt Python 3.10 tot 3.14. De Runtime in het deelvenster Code biedt precies deze aan, met 3.12 als standaard, dus elke keuze werkt.
- Intents.
discord.Bot()gebruikt de standaard-intents, waar geen bevoorrechte bij zit, en slash-commands hebben er geen nodig. Prefixcommando's zoals!pinghebbenintents.message_content = Truein je code nodig en Message Content Intent ingeschakeld in het Developer Portal. Als je code erom vraagt terwijl het in het Portal uit staat, weigert Discord de login. Zie "Used disallowed intents" oplossen op je Discord-bot. - Houd on_connect vrij. De automatische registratie draait in de eigen
on_connectvan de bot. Als je zelfon_connectdefinieert, zegt de documentatie van Pycord dat je daarinawait bot.sync_commands()moet aanroepen, anders worden je commando's niet meer bijgewerkt. Zet opstartcode inon_ready, zoals hierboven. - Logging staat uit tenzij je het aanzet. De
run()van Pycord stelt geen logging in, dus Python toont alleen de waarschuwingen en fouten van de bibliotheek, niet de infoberichten zoals de login. Druk je eigen klaar-regel af, zoals hierboven, of roeplogging.basicConfig(level=logging.INFO)aan om te zien wat de bibliotheek doet. - Voice. Schrijf voor spraakkanalen
py-cord[voice]inrequirements.txtin plaats vanpy-cord.
Zelf hosten op een Linux-VPS
Installeer op Debian of Ubuntu Python, maak een gebruiker en een map voor de bot aan en installeer Pycord in een virtuele omgeving:
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
Zet het token in een bestand dat alleen root kan lezen. Maak /etc/pycord-bot.env aan met sudo nano /etc/pycord-bot.env, schrijf één regel, DISCORD_TOKEN= gevolgd door je token, sla het op en voer sudo chmod 600 /etc/pycord-bot.env uit.
Maak dan /etc/systemd/system/pycord-bot.service aan:
[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
Start hem nu en bij elke systeemstart, en volg dan zijn uitvoer:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 zorgt ervoor dat print() direct in het journal komt in plaats van pas als een buffer vol is. Om de bot bij te werken kopieer je de nieuwe bestanden, voer je de regel met pip install opnieuw uit en daarna sudo systemctl restart pycord-bot.
Zelf hosten of een botabonnement
| Je eigen VPS | Een PlayNHost-botabonnement | |
|---|---|---|
| Python | De versie die je distributie meelevert; je installeert en update hem zelf | Kies 3.10 tot 3.14 onder Runtime |
| Pakketten | Je voert na elke wijziging pip install uit | Geïnstalleerd bij een start nadat requirements.txt of de Python-versie is gewijzigd, en bij de eerste start een dag na de laatste installatie |
| Herstarts | Je systemd-unit | Opnieuw gestart na een crash; gestopt gelaten met de reden als hij binnen een minuut opnieuw crasht |
| Het token | Een bestand dat je zelf beveiligt | Versleuteld opgeslagen, bij het plakken bij Discord gecontroleerd, aan je code doorgegeven als DISCORD_TOKEN |
| Fouten | Je leest het journal | De consolebanner noemt de oorzaak, zoals een fout token of een ontbrekende intent |
| Systeemupdates, firewall, SSH | Doe je zelf | Niet jouw taak |
Veelgestelde vragen
Kan ik Pycord en discord.py in dezelfde bot gebruiken?
Nee. Beide installeren de module discord, dus de een overschrijft de ander. Houd alleen py-cord in requirements.txt. Als de server eerder discord.py draaide, verwijder dan .local en .pnh/packages.state in Files zodat de pakketten weer schoon worden geïnstalleerd.
Waarom verschijnt /ping niet in mijn server?
Controleer of de bot is toegevoegd met Toevoegen aan een Discord-server en of de console de regel Logged in as toont: Pycord registreert het commando bij het verbinden. Geef tijdens het testen debug_guilds=[your_server_id] mee aan discord.Bot(): de commando's worden dan alleen in die server aangemaakt, en volgens de documentatie van Discord worden servercommando's direct bijgewerkt.
Is Pycord hetzelfde als discord.py?
Nee. Pycord begon als fork van discord.py en behoudt veel van de API, zoals discord.Client en discord.ext.commands, maar de slash-commands verschillen: @bot.slash_command en ctx.respond() in Pycord, app_commands en een sync-aanroep in discord.py. Code voor de een werkt niet altijd op de ander.
Past een Pycord-bot in het kleinste abonnement?
Ja. Met ongeveer 51 MB in onze test gebruikt een minimale Pycord-bot ongeveer een tiende van het STARTER-abonnement van 0.5 GB. Stap over als je bot het zelf nodig heeft: grote servers waarvan hij de leden in de cache houdt, bestanden of afbeeldingen die hij verwerkt, of gegevens die hij in het geheugen bewaart.
Klaar om de jouwe te draaien? Kies een abonnement bij Discord-bothosting en upload je Pycord-bot.



