Para hospedar um bot DSharpPlus 24/7, você o executa em uma máquina que fica sempre ligada: um VPS Linux com um serviço systemd que o inicia de novo quando ele para, ou um plano de bot na hospedagem de bots Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu projeto em C#, escolhe .NET 10, cola o token e clica em Start. No nosso teste, um bot com DSharpPlus 5.0.0-nightly-02614 usou cerca de 69 MB de memória no .NET 10. O README do DSharpPlus diz para você usar suas builds nightly, e a documentação lista o .NET 10 como o único .NET para os nightly 5.0, então esta página usa uma. Os passos na PlayNHost:
- Na página de hospedagem de bots Discord, clique em Criar servidor em um plano. Na janela do pedido, responda Para qual plataforma é o seu bot? com Discord e escolha C# (.NET).
- Abra seu servidor no painel. O cartão Configurar seu bot na Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve dizer Este bot roda .NET Bot.; clique nesse passo para conferir e depois em Continuar.
- Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
- Em Permissões, marque Meu código usa isto somente para os intents privilegiados que seu código pede (o bot abaixo não precisa de nenhum), clique em Adicionar a um servidor do Discord e depois em Continuar.
- Em Seu código, clique em Enviar arquivos e envie
Bot.csprojeProgram.cspara a pasta principal, sem as pastasbineobj, ou clique em Conectar o Git. - Na página Bot, painel Código, escolha .NET 10 em Runtime (ele é salvo assim que você escolhe) e deixe Arquivo de entrada vazio.
- Clique em Iniciar bot e acompanhe o Console. O servidor primeiro compila seu projeto, depois seu bot imprime
Logged in as ...e o cartão mostra Seu bot está online no Discord.
Como criar o bot e o token dele é explicado em Como criar um bot do Discord e obter o token, e o tipo de bot .NET em geral (as duas formas de envio, erros de compilação) em Como hospedar um bot do Discord em C# (.NET). Esta página trata do DSharpPlus em si: qual versão usar, do que ele precisa em um servidor e o que saber antes de hospedá-lo.
O que medimos
| Biblioteca | Versão | Memória sem carga | Do início à resposta do Discord, com a compilação | Da execução do programa à resposta do Discord |
|---|---|---|---|---|
| DSharpPlus | 5.0.0-nightly-02614 | 69 MB | 1,9 s | 0,5 s |
| Discord.Net | 3.20.2 | 76 MB | 1,6 s | 0,5 s |
| .NET 8 sozinho, sem biblioteca | nenhuma | 24 MB | 1,3 s (compilação e início, sem chamada) | nenhuma |
Como: no nosso próprio nó, em um contêiner descartável configurado como um plano de bot de 1 GB (DSharpPlus na imagem do .NET 10, Discord.Net e a linha sem biblioteca na imagem do .NET 8, e o comando de início do nosso tipo de bot .NET, que executa dotnet publish a cada início), cada bot tentou entrar com um token falso, que o Discord recusou; a memória é a memória residente 15 segundos depois dessa resposta, a primeira coluna de tempo vai do começo da compilação até a resposta, a segunda da execução do programa, e cada valor é a mediana das execuções 2 a 4. O bot DSharpPlus medido apenas fez login, só com o DSharpPlus (sem DSharpPlus.Commands); sua primeira compilação, que também baixou o DSharpPlus, levou 7 segundos.
Esses são valores mínimos: sem servidores, sem membros em cache, ainda sem uma sessão de gateway aberta. Seu próprio código, o pacote de comandos e o número de servidores em que seu bot está se somam a eles. Para pular a compilação a cada início, você pode enviar os arquivos que publicou no seu computador em vez do projeto (veja o guia de C# linkado acima). Compare os números com os planos da hospedagem de bots Discord e escolha conforme o que seu bot faz.
Um bot DSharpPlus mínimo
Ele registra um comando de barra /ping, responde com Pong!, lê o token de DISCORD_TOKEN (o nome que o painel dá a ele) e imprime uma linha de pronto. Não precisa de nenhum intent privilegiado. Dois arquivos na pasta 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!");
}
A cada início, o servidor executa dotnet publish em Bot.csproj e inicia Bot.dll. O console mostra [PlayNHost] Building your bot (the first build downloads packages and can take a minute), depois [PlayNHost] Starting your bot, depois as linhas de log do próprio DSharpPlus e Logged in as ..., a linha que muda o indicador em Visão geral para Online no Discord. Convide o bot com Adicionar a um servidor do Discord antes de testar /ping: Como convidar seu bot do Discord para um servidor.
Se o token estiver errado
No nosso teste, com um token falso, ConnectAsync() do DSharpPlus falhou com este erro:
UnauthorizedException: Unauthorized: Unauthorized
Antes disso, o DSharpPlus registra um aviso: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. O bot acima captura essa UnauthorizedException e imprime Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. no lugar, e então para com o código de saída 1. Para corrigir, abra o Discord Developer Portal, seu aplicativo, Bot, e clique em Reset Token; o Discord mostra o novo token uma única vez. Na nossa página Bot, painel Discord, clique em Substituir token, cole-o, clique em Salvar token e depois em Reiniciar agora. Quando o Discord recusa a verificação do token salvo, o painel mostra O Discord não aceitou.
O que saber sobre o DSharpPlus em um servidor
- Qual versão: no NuGet, a versão estável mais recente do DSharpPlus é a 4.5.3 (24 ago 2026), e os nightly 5.0 aparecem como pré-lançamentos (o mais recente, 5.0.0-nightly-02614, de 1 nov 2026). O README diz que, em regra, você deve usar os nightly, a documentação cobre apenas eles, e a documentação diz que não há suporte para a 4.5. Também existe no NuGet um pacote com o número simples
5.0.0, mas ele não está listado, é de maio de 2023 e não tem a API desta página: não escrevaVersion="5.0.0". - .NET 10 para os nightly: o 5.0.0-nightly-02614 é compilado apenas para .NET 10, e a documentação do DSharpPlus lista o .NET 10 como o único .NET para os nightly 5.0, então defina
net10.0no seu projeto e .NET 10 em Runtime. Com .NET 8 (recommended) escolhido, a compilação para comNETSDK1045. O DSharpPlus 4.5.3 tem como alvo o .NET Standard 2.0, e a documentação lista o .NET 8 a 10 como suportados para a 4.5; ele tem a API mais antiga (new DiscordClient(new DiscordConfiguration { ... })). - Fixe o nightly, sem curinga. Escreva o número exato do nightly, como acima. Pelas regras documentadas do NuGet, uma versão flutuante pega a maior correspondência, versões estáveis incluídas, e ignora se um pacote está listado, então
5.0.0-nightly-*seria resolvido para aquele5.0.0antigo não listado, que conta como maior que qualquer nightly. O servidor restaura e compila seu projeto a cada início, então um número exato também impede que ele mude sem você perceber. Para atualizar, mude o número emBot.csproje reinicie. - Comandos: o framework de comandos é o pacote separado
DSharpPlus.Commands, que cuida de comandos de barra e de texto.DSharpPlus.SlashCommandsestá obsoleto eDSharpPlus.CommandsNextdeve seguir o mesmo caminho, então tutoriais antigos que os usam precisam de mudanças. Mantenha todos os pacotes do DSharpPlus no mesmo número de nightly. - Intents:
SlashCommandProcessor.RequiredIntentsé sóGuilds, que não é privilegiado. O processador de comandos de texto, ativado por padrão, reage ao prefixo!e a menções ao bot; em servidores, o Discord envia a um bot o texto das mensagens que não o mencionam somente com o intent privilegiado Message Content. O bot acima desliga os processadores padrão e adiciona só o de comandos de barra. Se você adicionar Message Content, ative-o também no Developer Portal e marque Meu código usa isto para ele, ou o Discord fecha a conexão. Veja Corrigir "Used disallowed intents" no seu bot do Discord. - A lista de comandos do Discord acompanha o seu código. A cada início, sem
DebugGuildId, o DSharpPlus.Commands lê do Discord os comandos globais do seu aplicativo, cria os novos, edita os alterados e exclui os que seu código não tem mais, exceto um ponto de entrada Activity. Um comando que você apaga do código desaparece do Discord no próximo início, e o mesmo vale para um comando global que outro programa registrou para o mesmo aplicativo. - Logs: o logger padrão do DSharpPlus escreve no console a partir do nível Information. Quando o Discord aceita o token, o Console mostra a linha de inicialização,
DSharpPlus; version ...; com um token recusado, ele registra apenas a linha[Warn]acima.builder.SetLogLevel(...)muda o nível. - Falhas: quando o bot sai, como o bot acima faz com um token recusado, o painel o inicia de novo na hora, compilando-o antes. Se ele parar de novo dentro de um minuto, fica parado e o Console diz o motivo.
Hospede você mesmo em um VPS Linux
Em um VPS, compile o bot no seu próprio computador e execute no servidor só o resultado. Publique-o com o SDK do .NET 10:
dotnet publish Bot.csproj -c Release -o publish
No Ubuntu 24.04, o runtime do .NET 10 está nos pacotes do próprio Ubuntu:
sudo apt update
sudo apt install dotnet-runtime-10.0
dotnet --list-runtimes
Crie um usuário para o bot e copie a pasta publish para o servidor (por exemplo com scp -r), depois para a pasta dele:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp -r publish/. /opt/mybot/
sudo chown -R mybot: /opt/mybot
Mantenha o token fora do seu código, em um arquivo que só o root pode ler:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Crie /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
Inicie-o agora e a cada boot, depois acompanhe a saída:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always inicia o bot de novo 5 segundos depois de ele sair ou falhar, mas não depois de você pará-lo com systemctl stop. Para atualizar, publique de novo, copie os novos arquivos sobre os antigos e execute sudo systemctl restart mybot. No Debian, o .NET não está nos pacotes da própria distribuição; as instruções de instalação da Microsoft cobrem isso.
Hospedar por conta própria ou usar um plano de bot
Em um VPS que você mesmo gerencia, cabe a você:
- Atualizações e segurança do sistema operacional, e upgrades do runtime do .NET.
- Publicar e copiar cada nova build, o arquivo de serviço, o arquivo do token e suas permissões.
- Ler
journalctlpara descobrir por que o bot parou. - Backups de tudo o que seu bot armazena.
Em troca, um VPS executa qualquer coisa que você instalar nele, e nada é compilado lá.
Em um plano de bot da PlayNHost, o painel faz isso por você:
- .NET 6, 8, 9 ou 10 em um seletor, e a compilação: envie o projeto e clique em Start.
- O token, verificado com o Discord antes de ser salvo, armazenado criptografado e entregue ao seu código como
DISCORD_TOKEN. - Um link de convite com as permissões que você escolher, e um cartão Intents privilegiados que verifica quais estão ativados no seu Developer Portal.
- Iniciar o bot de novo depois de uma falha, e um banner acima do Console quando o bot fica sem memória.
- Envio de arquivos, deploys com Git e backups pelo painel.
Perguntas frequentes
Devo usar o DSharpPlus 4.5.3 ou um nightly 5.0?
Para um bot novo, um nightly 5.0: a equipe do DSharpPlus diz isso no README, e a documentação e o suporte cobrem apenas a 5.0. Um bot 4.5 existente continua rodando nos nossos planos como está, com Runtime na versão do .NET que o projeto dele usa como alvo; passar para a 5.0 significa mudar código, porque a 5.0 cria o cliente com DiscordClientBuilder em vez de new DiscordClient(new DiscordConfiguration { ... }), e seus comandos vêm de DSharpPlus.Commands em vez dos pacotes de comandos antigos.
A compilação falha com NETSDK1045. E agora?
Seu projeto tem como alvo um .NET mais novo que o Runtime que você escolheu. Um nightly 5.0 precisa de net10.0 e .NET 10: defina isso no painel Código, clique em Salvar e inicie o bot de novo.
Por que cada início demora mais do que o bot precisa?
Porque o servidor executa dotnet publish antes de cada início, então uma alteração que você envia é sempre compilada. No nosso teste, isso deixou o início em 1,9 segundo contra 0,5 segundo do programa sozinho. Para pular a compilação, publique no seu computador e envie os arquivos da pasta publish em vez do projeto.
DSharpPlus ou Discord.Net na PlayNHost?
Os dois rodam no mesmo tipo de bot .NET. A tabela acima traz a memória que medimos para cada um. O Discord.Net tem versões estáveis (3.20.2 de 8 out 2026) que compilam no .NET 8, o runtime recomendado; o DSharpPlus pede que você acompanhe os nightly no .NET 10. Escolha a API de que você mais gosta. Passos para o Discord.Net: Como hospedar um bot do Discord em C# (.NET).
Pronto para manter seu bot DSharpPlus no ar o dia todo? Veja os planos da hospedagem de bots Discord.



