Pour héberger un bot DSharpPlus 24/7, vous le faites tourner sur une machine toujours allumée : un VPS Linux avec un service systemd qui le relance quand il s'arrête, ou une offre bot sur l'hébergement de bots Discord PlayNHost (à partir de 1,99 $US par mois), où vous envoyez votre projet C#, choisissez .NET 10, collez le token et appuyez sur Start. Lors de notre test, un bot DSharpPlus 5.0.0-nightly-02614 a utilisé environ 69 Mo de mémoire sur .NET 10. Le README de DSharpPlus recommande d'utiliser ses versions nightly, et sa documentation indique .NET 10 comme seul .NET pour les nightly 5.0, cette page en utilise donc une. Les étapes sur PlayNHost :
- Sur la page d'hébergement de bots Discord, cliquez sur Créer un serveur pour une offre. Dans la fenêtre de commande, répondez à Pour quelle plateforme est votre bot ? par Discord et choisissez C# (.NET).
- Ouvrez votre serveur dans le panel. La carte Configurer votre bot de l'Aperçu s'ouvre sur Connexion à Discord. Sa première étape, Ce qui tourne, doit indiquer Ce bot fait tourner .NET Bot. ; cliquez sur cette étape pour la vérifier, puis sur Continuer.
- À l'étape Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connecter, puis sur Oui, continuer.
- À l'étape Permissions, cochez Mon code l’utilise uniquement pour les intents privilégiés que demande votre code (le bot ci-dessous n'en a besoin d'aucun), cliquez sur Ajouter à un serveur Discord, puis sur Continuer.
- À l'étape Votre code, cliquez sur Téléverser des fichiers et envoyez
Bot.csprojetProgram.csdans le dossier principal, sans les dossiersbinetobj, ou cliquez sur Connecter Git. - Sur la page Bot, volet Code, choisissez .NET 10 sous Runtime (il est enregistré dès que vous le choisissez) et laissez Fichier d’entrée vide.
- Cliquez sur Démarrer le bot et surveillez Console. Le serveur compile d'abord votre projet, puis votre bot affiche
Logged in as ...et la carte indique Votre bot est en ligne sur Discord.
La création du bot et de son token est expliquée dans Comment créer un bot Discord et obtenir son token, et le type de bot .NET en général (les deux façons d'envoyer les fichiers, les erreurs de compilation) dans Comment héberger un bot Discord C# (.NET). Cette page porte sur DSharpPlus lui-même : quelle version utiliser, ce qu'il lui faut sur un serveur et ce qu'il faut savoir avant de l'héberger.
Ce que nous avons mesuré
| Bibliothèque | Version | Mémoire sans charge | Du démarrage à la réponse de Discord, avec la compilation | Du lancement du programme à la réponse de Discord |
|---|---|---|---|---|
| DSharpPlus | 5.0.0-nightly-02614 | 69 Mo | 1,9 s | 0,5 s |
| Discord.Net | 3.20.2 | 76 Mo | 1,6 s | 0,5 s |
| .NET 8 seul, sans bibliothèque | aucune | 24 Mo | 1,3 s (compilation et démarrage, sans appel) | aucune |
Comment : sur notre propre nœud, dans un conteneur jetable configuré comme une offre bot de 1 Go (DSharpPlus sur l'image .NET 10, Discord.Net et la ligne sans bibliothèque sur l'image .NET 8, avec la commande de démarrage de notre type de bot .NET, qui exécute dotnet publish à chaque démarrage), chaque bot a tenté de se connecter avec un faux token, que Discord a refusé ; la mémoire est la mémoire résidente 15 secondes après cette réponse, la première colonne de temps va du début de la compilation à la réponse, la seconde du lancement du programme, et chaque chiffre est la médiane des exécutions 2 à 4. Le bot DSharpPlus mesuré s'est seulement connecté, avec DSharpPlus seul (sans DSharpPlus.Commands) ; sa première compilation, qui a aussi téléchargé DSharpPlus, a pris 7 secondes.
Ce sont des planchers : pas de serveurs, pas de membres en cache, pas encore de session gateway ouverte. Votre propre code, le paquet de commandes et le nombre de serveurs où se trouve votre bot s'y ajoutent. Pour éviter la compilation à chaque démarrage, vous pouvez envoyer les fichiers que vous avez publiés sur votre ordinateur au lieu du projet (voir le guide C# lié plus haut). Comparez ces chiffres avec les offres de l'hébergement de bots Discord et choisissez selon ce que fait votre bot.
Un bot DSharpPlus minimal
Il enregistre une commande slash /ping, y répond par Pong!, lit le token dans DISCORD_TOKEN (le nom que lui donne le panel) et affiche une ligne de démarrage. Il n'a besoin d'aucun intent privilégié. Deux fichiers dans le dossier principal :
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!");
}
À chaque démarrage, le serveur exécute dotnet publish sur Bot.csproj et lance Bot.dll. La console affiche [PlayNHost] Building your bot (the first build downloads packages and can take a minute), puis [PlayNHost] Starting your bot, puis les lignes de journal propres à DSharpPlus et Logged in as ..., la ligne qui fait passer la pastille de Aperçu à En ligne sur Discord. Invitez le bot avec Ajouter à un serveur Discord avant d'essayer /ping : Comment inviter votre bot Discord sur un serveur.
Si le token est incorrect
Lors de notre test, avec un faux token, ConnectAsync() de DSharpPlus a échoué avec cette erreur :
UnauthorizedException: Unauthorized: Unauthorized
Auparavant, DSharpPlus journalise un avertissement : [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. Le bot ci-dessus intercepte cette UnauthorizedException et affiche à la place Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., puis s'arrête avec le code de sortie 1. Pour corriger, ouvrez le Discord Developer Portal, votre application, Bot, et cliquez sur Reset Token ; Discord affiche le nouveau token une seule fois. Sur notre page Bot, volet Discord, cliquez sur Remplacer le token, collez-le, cliquez sur Enregistrer le token, puis sur Redémarrer maintenant. Quand Discord refuse la vérification du token enregistré, le volet affiche Discord ne l’a pas accepté.
Ce qu'il faut savoir sur DSharpPlus sur un serveur
- Quelle version : sur NuGet, la dernière version stable de DSharpPlus est la 4.5.3 (24 août 2026), et les nightly 5.0 sont listés comme préversions (la plus récente, 5.0.0-nightly-02614, du 1 novembre 2026). Le README dit qu'il faut en règle générale utiliser les nightly, sa documentation ne couvre qu'eux, et la documentation indique qu'aucun support n'est assuré pour la 4.5. Un paquet numéroté simplement
5.0.0existe aussi sur NuGet, mais il n'est pas listé, date de mai 2023 et n'a pas l'API de cette page : n'écrivez pasVersion="5.0.0". - .NET 10 pour les nightly : 5.0.0-nightly-02614 n'est compilé que pour .NET 10, et la documentation de DSharpPlus indique .NET 10 comme seul .NET pour les nightly 5.0 ; indiquez donc
net10.0dans votre projet et .NET 10 comme Runtime. Avec .NET 8 (recommended) choisi, la compilation s'arrête avecNETSDK1045. DSharpPlus 4.5.3 cible .NET Standard 2.0, et la documentation indique .NET 8 à 10 comme pris en charge pour la 4.5 ; il a l'ancienne API (new DiscordClient(new DiscordConfiguration { ... })). - Épinglez le nightly, sans joker. Écrivez le numéro exact du nightly, comme ci-dessus. D'après les règles documentées de NuGet, une version flottante prend la correspondance la plus élevée, versions stables comprises, et ignore si un paquet est listé ;
5.0.0-nightly-*se résoudrait donc vers ce vieux5.0.0non listé, qui compte comme supérieur à tous les nightly. Le serveur restaure et compile votre projet à chaque démarrage, un numéro exact évite donc aussi qu'il change sous vos pieds. Pour mettre à jour, changez le numéro dansBot.csprojet redémarrez. - Commandes : le framework de commandes est le paquet séparé
DSharpPlus.Commands, qui gère les commandes slash et textuelles.DSharpPlus.SlashCommandsest obsolète etDSharpPlus.CommandsNextdoit suivre, les anciens tutoriels qui les utilisent demandent donc des modifications. Gardez tous les paquets DSharpPlus sur le même numéro de nightly. - Intents :
SlashCommandProcessor.RequiredIntentsvaut seulementGuilds, qui n'est pas privilégié. Le processeur de commandes textuelles, activé par défaut, réagit au préfixe!et aux mentions du bot ; sur les serveurs, Discord n'envoie à un bot le texte des messages qui ne le mentionnent pas qu'avec l'intent privilégié Message Content. Le bot ci-dessus désactive les processeurs par défaut et n'ajoute que celui des commandes slash. Si vous ajoutez Message Content, activez-le aussi dans le Developer Portal et cochez Mon code l’utilise pour lui, sinon Discord ferme la connexion. Voir Corriger « Used disallowed intents » sur votre bot Discord. - La liste de commandes de Discord suit votre code. À chaque démarrage, sans
DebugGuildId, DSharpPlus.Commands lit les commandes globales de votre application sur Discord, crée les nouvelles, modifie celles qui ont changé et supprime celles que votre code n'a plus, sauf un point d'entrée Activity. Une commande que vous supprimez de votre code disparaît de Discord au démarrage suivant, de même qu'une commande globale qu'un autre programme a enregistrée pour la même application. - Journaux : le logger par défaut de DSharpPlus écrit dans la console à partir du niveau Information. Une fois que Discord accepte le token, Console affiche sa ligne de démarrage,
DSharpPlus; version ...; avec un token refusé, il ne journalise que la ligne[Warn]ci-dessus.builder.SetLogLevel(...)change le niveau. - Plantages : quand le bot se termine, comme le bot ci-dessus avec un token refusé, le panel le relance aussitôt, en le recompilant d'abord. S'il s'arrête à nouveau dans la minute qui suit, il reste arrêté et Console en donne la raison.
L'héberger vous-même sur un VPS Linux
Sur un VPS, compilez le bot sur votre propre ordinateur et ne faites tourner que le résultat sur le serveur. Publiez-le avec le SDK .NET 10 :
dotnet publish Bot.csproj -c Release -o publish
Sur Ubuntu 24.04, le runtime .NET 10 se trouve dans les paquets propres d'Ubuntu :
sudo apt update
sudo apt install dotnet-runtime-10.0
dotnet --list-runtimes
Créez un utilisateur pour le bot et copiez le dossier publish sur le serveur (par exemple avec scp -r), puis dans son dossier :
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp -r publish/. /opt/mybot/
sudo chown -R mybot: /opt/mybot
Gardez le token hors de votre code, dans un fichier que seul root peut lire :
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Créez /etc/systemd/system/mybot.service :
[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
Lancez-le maintenant et à chaque démarrage, puis suivez sa sortie :
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always relance le bot 5 secondes après qu'il s'est arrêté ou a planté, mais pas quand vous l'arrêtez avec systemctl stop. Pour mettre à jour, publiez à nouveau, copiez les nouveaux fichiers sur les anciens et exécutez sudo systemctl restart mybot. Sur Debian, .NET ne figure pas dans les paquets propres de la distribution ; les instructions d'installation de Microsoft couvrent ce cas.
Auto-hébergement ou offre bot
Sur un VPS que vous gérez vous-même, il vous revient :
- Des mises à jour et de la sécurité du système d'exploitation, et des mises à niveau du runtime .NET.
- De publier et copier chaque nouvelle version, le fichier de service, le fichier du token et ses permissions.
- De lire
journalctlpour comprendre pourquoi le bot s'est arrêté. - Des sauvegardes de tout ce que votre bot stocke.
En contrepartie, un VPS exécute tout ce que vous y installez, et rien n'y est compilé.
Avec une offre bot PlayNHost, le panel s'en charge pour vous :
- .NET 6, 8, 9 ou 10 depuis un sélecteur, et la compilation : envoyez le projet et appuyez sur Start.
- Le token, vérifié auprès de Discord avant d'être enregistré, stocké chiffré et transmis à votre code sous le nom
DISCORD_TOKEN. - Un lien d'invitation avec les permissions que vous choisissez, et une carte Intents privilégiés qui vérifie lesquels sont activés dans votre Developer Portal.
- Le redémarrage du bot après un plantage, et une bannière au-dessus de Console quand le bot manque de mémoire.
- Envoi de fichiers, déploiements Git et sauvegardes depuis le panel.
Questions fréquentes
Dois-je utiliser DSharpPlus 4.5.3 ou un nightly 5.0 ?
Pour un nouveau bot, un nightly 5.0 : l'équipe DSharpPlus le dit dans le README, et sa documentation et son support ne couvrent que la 5.0. Un bot 4.5 existant fonctionne toujours tel quel sur nos offres, avec Runtime réglé sur la version de .NET que cible son projet ; passer à la 5.0 demande de modifier le code, car la 5.0 crée le client avec DiscordClientBuilder au lieu de new DiscordClient(new DiscordConfiguration { ... }), et ses commandes viennent de DSharpPlus.Commands au lieu des anciens paquets de commandes.
La compilation échoue avec NETSDK1045. Que faire ?
Votre projet cible un .NET plus récent que le Runtime choisi. Un nightly 5.0 demande net10.0 et .NET 10 : réglez-le dans le volet Code, cliquez sur Enregistrer et relancez le bot.
Pourquoi chaque démarrage prend-il plus de temps que ce dont le bot a besoin ?
Parce que le serveur exécute dotnet publish avant chaque démarrage, si bien qu'une modification que vous envoyez est toujours compilée. Lors de notre test, cela a donné un démarrage de 1,9 seconde contre 0,5 seconde pour le programme seul. Pour éviter la compilation, publiez sur votre ordinateur et envoyez les fichiers du dossier publish au lieu du projet.
DSharpPlus ou Discord.Net sur PlayNHost ?
Les deux fonctionnent avec le même type de bot .NET. Le tableau ci-dessus donne la mémoire que nous avons mesurée pour chacun. Discord.Net a des versions stables (3.20.2 du 8 octobre 2026) qui compilent sur .NET 8, le runtime recommandé ; DSharpPlus vous demande de suivre ses nightly sur .NET 10. Choisissez l'API que vous préférez. Étapes pour Discord.Net : Comment héberger un bot Discord C# (.NET).
Prêt à faire tourner votre bot DSharpPlus jour et nuit ? Découvrez les offres de l'hébergement de bots Discord.



