Discord.Addons.Hosting 5.2.0

.NET 6.0
dotnet add package Discord.Addons.Hosting --version 5.2.0
NuGet\Install-Package Discord.Addons.Hosting -Version 5.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Discord.Addons.Hosting" Version="5.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Discord.Addons.Hosting --version 5.2.0
#r "nuget: Discord.Addons.Hosting, 5.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Discord.Addons.Hosting as a Cake Addin
#addin nuget:?package=Discord.Addons.Hosting&version=5.2.0

// Install Discord.Addons.Hosting as a Cake Tool
#tool nuget:?package=Discord.Addons.Hosting&version=5.2.0


.NET Core Build NuGet Nuget

Discord.NET hosting with Microsoft.Extensions.Hosting. This package provides extensions to a .NET Generic Host (IHostBuilder) that will run a Discord.NET socket/sharded client as an IHostedService, featuring:

✅ Simplified, best practice bot creation with a reduction in boilerplate.

✅ Instant wire-up of Logging and Dependency Injection support.

✅ Extensions to easily run startup & background tasks involving the Discord Client.

✅ Easy integration with other generic host consumers, such as ASP.NET Core.

.NET 6.0+ is required.

// CreateDefaultBuilder configures a lot of stuff for us automatically
// See: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/host/generic-host
var host = Host.CreateDefaultBuilder()   
    .ConfigureDiscordHost((context, config) =>
        config.SocketConfig = new DiscordSocketConfig
            LogLevel = LogSeverity.Verbose,
            AlwaysDownloadUsers = true,
            MessageCacheSize = 200

        config.Token = context.Configuration["token"];
    // Optionally wire up the command service
    .UseCommandService((context, config) =>
        config.DefaultRunMode = RunMode.Async;
        config.CaseSensitiveCommands = false;
    // Optionally wire up the interactions service
    .UseInteractionService((context, config) =>
        config.LogLevel = LogSeverity.Info;
        config.UseCompiledLambda = true;
    .ConfigureServices((context, services) =>
        //Add any other services here
await host.RunAsync();

Getting Started

  1. Create a .NET 6 Worker Service using Visual Studio or via the dotnet cli (dotnet new worker -o MyWorkerService)
  2. Add Discord.Addons.Hosting to your project.
  3. Set your bot token via the dotnet secrets manager: dotnet user-secrets set "token" "your-token-here"
  4. Add your bot prefix to appsettings.json
  5. Configure your Discord client with ConfigureDiscordHost.
  6. Enable the CommandService and/or the InteractionService with UseCommandService and UseInteractionService
  7. Create and start your application using a HostBuilder as shown above and in the examples linked below.


Fully working examples are available here

Sharded Client

To use the sharded client instead of the socket client, simply replace ConfigureDiscordHost with ConfigureDiscordShardedHost:

.ConfigureDiscordShardedHost((context, config) =>
    config.SocketConfig = new DiscordSocketConfig
    	// Manually set the required shards, or leave empty for the recommended count
	TotalShards = 4

    config.Token = context.Configuration["token"];


Microsoft's default logging has an unfortunate default output format, so I highly recommend using Serilog instead of the standard Microsoft logging.

Serilog should be added to the host with Serilog.Extensions.Hosting.

See the Serilog example for usage.

Discord Client Services

This section assumes some prior knowledge of Dependency Injection within the .NET ecosystem. Take a read of this if you have no idea what any of this means.

During bot development, it's highly like you'll require the ability to execute code immediately after startup, such as setting the bot's status, reaching out to a web server, registering an event, or kicking off the continuous execution of code in the background. Given we're using the generic host and have its IHostedService & BackgroundService capabilities in our toolbelt, this is easily achievable in a clean and concise way.

This package ships with the DiscordClientService and DiscordShardedClientService base classes for the socket client and sharded client respectively. For convenience, both of them expose the Client and Logger. Simply inherit from the given type, implement the required constructor, place your execution requirements within ExecuteAsync and register the service with your service collection via services.AddHostedService.

public class CommandHandler : DiscordClientService
    private readonly IServiceProvider _provider;
    private readonly CommandService _commandService;
    private readonly IConfiguration _config;

    public CommandHandler(DiscordSocketClient client, ILogger<CommandHandler> logger,  IServiceProvider provider, CommandService commandService, IConfiguration config) : base(client, logger)
        _provider = provider;
        _commandService = commandService;
        _config = config;
    // This'll be executed during startup.
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
        Client.MessageReceived += HandleMessage;
        _commandService.CommandExecuted += CommandExecutedAsync;
        await _commandService.AddModulesAsync(Assembly.GetEntryAssembly(), _provider);
 .ConfigureServices((context, services) =>

The WaitForReadyAsync extension method is also available for both client types to await execution of your service until the client has reached a Ready state:

public class BotStatusService : DiscordClientService
   public BotStatusService(DiscordSocketClient client, ILogger<DiscordClientService> logger) : base(client, logger)

   protected override async Task ExecuteAsync(CancellationToken stoppingToken)
   	// Wait for the client to be ready before setting the status
       await Client.WaitForReadyAsync(stoppingToken);
       Logger.LogInformation("Client is ready!");

       await Client.SetActivityAsync(new Game("Set my status!"));
Additional notes:
  • Services that do not require access to the Discord Client should use an implementation of BackgroundService.

  • Services with complex startup & shutdown activities should implement IHostedService directly.


When shutdown is requested, the host will wait a maximum of 5 seconds for services to stop before timing out.

If you're finding that this isn't enough time, you can modify the shutdown timeout via the ShutdownTimeout host setting.


This package uses Microsoft.Extensions.Options internally, so both the DiscordHostConfiguration and CommandServiceConfig can be configured within the services registration instead of within the HostBuilder extensions if it better suits your scenario.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Discord.Addons.Hosting:

Package Downloads

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.2.0 3,098 11/6/2022
5.1.0 4,944 1/30/2022
5.1.0-labs 160 1/30/2022
5.0.0 1,129 12/19/2021
4.0.3-labs 238 11/16/2021
4.0.2 3,777 6/19/2021
4.0.2-labs 480 8/3/2021
4.0.1 715 6/14/2021
3.1.1 3,437 11/20/2020
3.1.0 840 11/15/2020
3.0.0 2,628 6/14/2020
2.1.0 1,162 11/14/2019
2.0.0 793 10/10/2019
1.3.0 963 2/10/2019
1.2.1 912 1/6/2019
1.1.2 938 11/25/2018
1.1.1 950 11/16/2018
1.1.0 904 11/10/2018
1.0.2 963 10/15/2018
1.0.1 1,031 10/14/2018