NIEUW 📢 Black Friday: onze lanceeractie eindigt op 30 nov. Tot 70% korting op je eerste maand, voor elke game!Bekijk pakketten
Black FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 min

Een DSharpPlus-bot 24/7 hosten

Discord-bothostingBijgewerkt 6 nov 202613 min lezen

Om een DSharpPlus-bot 24/7 te hosten, draai je hem op een machine die aan blijft: een Linux-VPS met een systemd-service die hem opnieuw start als hij stopt, of een botabonnement bij PlayNHost Discord-bothosting (vanaf US$1.99 per maand), waar je je C#-project uploadt, .NET 10 kiest, het token plakt en op Start drukt. In onze test gebruikte een DSharpPlus 5.0.0-nightly-02614-bot ongeveer 69 MB geheugen op .NET 10. De README van DSharpPlus zegt dat je de nightly-builds moet gebruiken, en de documentatie noemt .NET 10 als enige .NET voor de 5.0-nightlies, dus deze pagina gebruikt er een. De stappen bij PlayNHost:

  1. 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 C# (.NET).
  2. 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 .NET Bot. te tonen; klik op die stap om het te controleren en dan op Doorgaan.
  3. Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en daarna op Ja, doorgaan.
  4. Vink bij Rechten alleen voor de bevoorrechte intents die je code vraagt Mijn code gebruikt dit aan (de bot hieronder heeft er geen nodig), klik op Toevoegen aan een Discord-server en daarna op Doorgaan.
  5. Klik bij Je code op Bestanden uploaden en upload Bot.csproj en Program.cs naar de hoofdmap, zonder de mappen bin en obj, of klik op Git koppelen.
  6. Kies op de pagina Bot, in het deel Code, onder Runtime de optie .NET 10 (die wordt direct opgeslagen) en laat Startbestand leeg.
  7. Klik op Bot starten en bekijk Console. De server bouwt eerst je project, daarna print je bot Logged in as ... en zegt de kaart Je bot is online in Discord.

Hoe je de bot en zijn token maakt, staat in Een Discord-bot maken en zijn token ophalen, en het .NET-bottype in het algemeen (beide uploadmanieren, buildfouten) in Een C# (.NET) Discord-bot hosten. Deze pagina gaat over DSharpPlus zelf: welke versie je gebruikt, wat het op een server nodig heeft en wat je moet weten voordat je het host.

Wat we hebben gemeten

BibliotheekVersieGeheugen zonder belastingStart tot antwoord van Discord, met de buildProgrammastart tot antwoord van Discord
DSharpPlus5.0.0-nightly-0261469 MB1,9 s0,5 s
Discord.Net3.20.276 MB1,6 s0,5 s
.NET 8 alleen, geen bibliotheekgeen24 MB1,3 s (build en start, geen aanroep)geen

Hoe: op onze eigen node, in een wegwerpcontainer ingericht als een botabonnement van 1 GB (DSharpPlus op het .NET 10-image, Discord.Net en de rij zonder bibliotheek op het .NET 8-image, en het startcommando van ons .NET-bottype, dat bij elke start dotnet publish uitvoert), probeerde elke bot in te loggen met een nep-token, dat Discord weigerde. Het geheugen is het resident geheugen 15 seconden na dat antwoord, de eerste tijdkolom loopt van het begin van de build tot het antwoord, de tweede vanaf de start van het programma, en elk cijfer is de mediaan van run 2 tot 4. De gemeten DSharpPlus-bot logde alleen in, met alleen DSharpPlus (zonder DSharpPlus.Commands); zijn eerste build, die ook DSharpPlus downloadde, duurde 7 seconden.

Dit zijn ondergrenzen: nog geen servers, geen gecachete leden, nog geen open gatewaysessie. Je eigen code, het commandopakket en het aantal servers waar je bot in zit komen erbovenop. Om de build bij elke start over te slaan, kun je in plaats van het project de bestanden uploaden die je op je eigen computer hebt gepubliceerd (zie de C#-gids hierboven). Vergelijk de cijfers met de abonnementen bij Discord-bothosting en kies op basis van wat je bot doet.

Een minimale DSharpPlus-bot

Hij registreert een slashcommando /ping, antwoordt erop met Pong!, leest het token uit DISCORD_TOKEN (de naam die het paneel eraan geeft) en print een gereedregel. Hij heeft geen bevoorrechte intent nodig. Twee bestanden in de hoofdmap:

Bot.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="DSharpPlus" Version="5.0.0-nightly-02614" />
    <PackageReference Include="DSharpPlus.Commands" Version="5.0.0-nightly-02614" />
  </ItemGroup>
</Project>

Program.cs

using System.ComponentModel;
using DSharpPlus;
using DSharpPlus.Commands;
using DSharpPlus.Commands.Processors.SlashCommands;
using DSharpPlus.Exceptions;

string? token = Environment.GetEnvironmentVariable("DISCORD_TOKEN");
if (string.IsNullOrWhiteSpace(token))
{
    Console.WriteLine("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
    return 1;
}

// Slash commands only need the Guilds intent, which is not privileged.
DiscordClientBuilder builder = DiscordClientBuilder.CreateDefault(token, SlashCommandProcessor.RequiredIntents);

builder.ConfigureEventHandlers(events => events.HandleSessionCreated((sender, e) =>
{
    Console.WriteLine($"Logged in as {sender.CurrentUser.Username}");
    return Task.CompletedTask;
}));

builder.UseCommands((services, commands) =>
{
    commands.AddCommands(typeof(PingCommand));
    commands.AddProcessor(new SlashCommandProcessor());
}, new CommandsConfiguration { RegisterDefaultCommandProcessors = false });

DiscordClient client = builder.Build();
try
{
    await client.ConnectAsync();
}
catch (UnauthorizedException)
{
    Console.WriteLine("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
    return 1;
}

await Task.Delay(Timeout.Infinite);
return 0;

public class PingCommand
{
    [Command("ping"), Description("Replies with Pong!")]
    public static ValueTask ExecuteAsync(CommandContext context) => context.RespondAsync("Pong!");
}

Bij elke start voert de server dotnet publish uit op Bot.csproj en start Bot.dll. De console toont [PlayNHost] Building your bot (the first build downloads packages and can take a minute), dan [PlayNHost] Starting your bot, dan de eigen logregels van DSharpPlus en Logged in as ..., de regel die het label bij Overzicht op Online in Discord zet. Nodig de bot uit met Toevoegen aan een Discord-server voordat je /ping probeert: Je Discord-bot uitnodigen op een server.

Als het token fout is

In onze test mislukte ConnectAsync() van DSharpPlus met een nep-token met deze fout:

UnauthorizedException: Unauthorized: Unauthorized

Daarvoor logt DSharpPlus een waarschuwing: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. De bot hierboven vangt die UnauthorizedException af en print in plaats daarvan Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., en stopt daarna met exitcode 1. Om het op te lossen open je het Discord Developer Portal, je applicatie, Bot, en klik je op Reset Token; Discord toont het nieuwe token maar één keer. Klik op onze pagina Bot, in het deel Discord, op Token vervangen, plak het, klik op Token opslaan en daarna op Nu herstarten. Als Discord de controle van het opgeslagen token weigert, toont het deel Discord heeft het niet geaccepteerd.

Wat je moet weten over DSharpPlus op een server

  • Welke versie: op NuGet is de nieuwste stabiele DSharpPlus 4.5.3 (24 aug 2026), en de 5.0-nightlies staan als prereleases vermeld (de nieuwste, 5.0.0-nightly-02614, van 1 nov 2026). De README zegt dat je in de regel de nightlies moet gebruiken, de documentatie behandelt alleen die, en volgens de documentatie wordt voor 4.5 geen ondersteuning gegeven. Er bestaat op NuGet ook een pakket met simpelweg het nummer 5.0.0, maar dat staat niet in de lijst, dateert van mei 2023 en heeft de API van deze pagina niet: schrijf geen Version="5.0.0".
  • .NET 10 voor de nightlies: 5.0.0-nightly-02614 is alleen voor .NET 10 gebouwd, en de documentatie van DSharpPlus noemt .NET 10 als enige .NET voor de 5.0-nightlies, dus zet net10.0 in je project en .NET 10 als Runtime. Met .NET 8 (recommended) gekozen stopt de build met NETSDK1045. DSharpPlus 4.5.3 richt zich op .NET Standard 2.0, en de documentatie noemt .NET 8 tot 10 als ondersteund voor 4.5; het heeft de oudere API (new DiscordClient(new DiscordConfiguration { ... })).
  • Pin de nightly, geen jokertekens. Schrijf het exacte nightly-nummer, zoals hierboven. Volgens de gedocumenteerde regels van NuGet neemt een zwevende versie de hoogste overeenkomst, stabiele versies inbegrepen, en negeert die of een pakket in de lijst staat, dus 5.0.0-nightly-* zou worden omgezet naar dat oude, niet-vermelde 5.0.0, dat telt als hoger dan elke nightly. De server herstelt en bouwt je project bij elke start, dus een exact nummer voorkomt ook dat het onder je handen verandert. Om bij te werken wijzig je het nummer in Bot.csproj en herstart je.
  • Commando's: het commandoframework is het aparte pakket DSharpPlus.Commands, dat slash- en tekstcommando's afhandelt. DSharpPlus.SlashCommands is verouderd en DSharpPlus.CommandsNext volgt naar verwachting, dus oudere tutorials die ze gebruiken vragen om aanpassingen. Houd alle DSharpPlus-pakketten op hetzelfde nightly-nummer.
  • Intents: SlashCommandProcessor.RequiredIntents is alleen Guilds, wat niet bevoorrecht is. De tekstcommandoprocessor, standaard aan, reageert op het voorvoegsel ! en op vermeldingen van de bot; op servers stuurt Discord een bot de tekst van berichten die hem niet vermelden alleen met de bevoorrechte Message Content-intent. De bot hierboven zet de standaardprocessors uit en voegt alleen de slashprocessor toe. Als je Message Content toevoegt, zet die dan ook aan in het Developer Portal en vink er Mijn code gebruikt dit voor aan, anders sluit Discord de verbinding. Zie "Used disallowed intents" oplossen op je Discord-bot.
  • De commandolijst van Discord volgt je code. Bij elke start, zonder DebugGuildId, leest DSharpPlus.Commands de globale commando's van je applicatie uit Discord, maakt de nieuwe aan, wijzigt de veranderde en verwijdert de commando's die je code niet meer heeft, behalve een Activity-ingangspunt. Een commando dat je uit je code verwijdert, verdwijnt bij de volgende start uit Discord, en hetzelfde geldt voor een globaal commando dat een ander programma voor dezelfde applicatie heeft geregistreerd.
  • Logs: de standaardlogger van DSharpPlus schrijft naar de console vanaf niveau Information. Zodra Discord het token accepteert, toont Console de startregel, DSharpPlus; version ...; bij een geweigerd token logt hij alleen de regel [Warn] hierboven. builder.SetLogLevel(...) wijzigt het niveau.
  • Crashes: als de bot stopt, zoals de bot hierboven bij een geweigerd token doet, start het paneel hem meteen opnieuw, en bouwt hem eerst opnieuw. Stopt hij daarna binnen een minuut weer, dan blijft hij gestopt en zegt Console waarom.

Zelf hosten op een Linux-VPS

Bouw de bot op een VPS op je eigen computer en draai op de server alleen het resultaat. Publiceer hem met de .NET 10 SDK:

dotnet publish Bot.csproj -c Release -o publish

Op Ubuntu 24.04 zit de .NET 10-runtime in de eigen pakketten van Ubuntu:

sudo apt update
sudo apt install dotnet-runtime-10.0
dotnet --list-runtimes

Maak een gebruiker voor de bot en kopieer de map publish naar de server (bijvoorbeeld met scp -r), en daarna naar zijn map:

sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp -r publish/. /opt/mybot/
sudo chown -R mybot: /opt/mybot

Houd het token buiten je code, in een bestand dat alleen root kan lezen:

sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env

Maak /etc/systemd/system/mybot.service aan:

[Unit]
Description=DSharpPlus bot
Wants=network-online.target
After=network-online.target

[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/dotnet /opt/mybot/Bot.dll
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Start hem nu en bij elke boot, en volg daarna zijn uitvoer:

sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f

Restart=always start de bot 5 seconden nadat hij stopt of crasht opnieuw, maar niet nadat je hem met systemctl stop stopt. Om bij te werken publiceer je opnieuw, kopieer je de nieuwe bestanden over de oude en voer je sudo systemctl restart mybot uit. Op Debian zit .NET niet in de eigen pakketten van de distributie; de installatie-instructies van Microsoft behandelen dat.

Zelf hosten of een botabonnement

Op een VPS die je zelf beheert, zorg je voor:

  • Updates en beveiliging van het besturingssysteem, en upgrades van de .NET-runtime.
  • Het publiceren en kopiëren van elke nieuwe build, het servicebestand, het tokenbestand en de rechten ervan.
  • Het lezen van journalctl om te achterhalen waarom de bot is gestopt.
  • Back-ups van alles wat je bot opslaat.

In ruil daarvoor draait een VPS alles wat je erop installeert, en wordt er niets gebouwd.

Bij een PlayNHost-botabonnement doet het paneel dit voor je:

  • .NET 6, 8, 9 of 10 uit een keuzelijst, en de build: upload het project en druk op Start.
  • Het token, voor het opslaan gecontroleerd bij Discord, versleuteld opgeslagen en aan je code gegeven als DISCORD_TOKEN.
  • Een uitnodigingslink met de rechten die je kiest, en een kaart Bevoorrechte intents die controleert welke in je Developer Portal aanstaan.
  • De bot opnieuw starten na een crash, en een banner boven Console wanneer de bot zonder geheugen komt te zitten.
  • Upload, Git-deploys en back-ups vanuit het paneel.

Veelgestelde vragen

Moet ik DSharpPlus 4.5.3 of een 5.0-nightly gebruiken?

Voor een nieuwe bot een 5.0-nightly: het DSharpPlus-team zegt dat in de README, en de documentatie en ondersteuning gelden alleen voor 5.0. Een bestaande 4.5-bot draait op onze abonnementen nog steeds zoals hij is, met Runtime op de .NET-versie waarop zijn project zich richt; overstappen naar 5.0 betekent code aanpassen, want 5.0 bouwt de client met DiscordClientBuilder in plaats van new DiscordClient(new DiscordConfiguration { ... }), en de commando's komen uit DSharpPlus.Commands in plaats van uit de oude commandopakketten.

De build mislukt met NETSDK1045. Wat nu?

Je project richt zich op een nieuwer .NET dan de Runtime die je koos. Een 5.0-nightly heeft net10.0 en .NET 10 nodig: stel het in bij het deel Code, klik op Opslaan en start de bot opnieuw.

Waarom duurt elke start langer dan de bot zelf nodig heeft?

Omdat de server vóór elke start dotnet publish uitvoert, zodat een wijziging die je uploadt altijd wordt gebouwd. In onze test maakte dat de start 1,9 seconden tegenover 0,5 seconden voor het programma alleen. Om de build over te slaan publiceer je op je computer en upload je de bestanden uit de map publish in plaats van het project.

DSharpPlus of Discord.Net bij PlayNHost?

Beide draaien op hetzelfde .NET-bottype. De tabel hierboven geeft het geheugen dat we voor elk maten. Discord.Net heeft stabiele releases (3.20.2 van 8 okt 2026) die op .NET 8 bouwen, de aanbevolen runtime; DSharpPlus vraagt je zijn nightlies op .NET 10 te volgen. Kies de API die je het liefst hebt. Stappen voor Discord.Net: Een C# (.NET) Discord-bot hosten.

Klaar om je DSharpPlus-bot dag en nacht te laten draaien? Bekijk de abonnementen bij Discord-bothosting.

Draait je bot al ergens anders? Verhuis hem naar ons

ONZE NIEUWSTE BLOGS