Important

This documentation is built from the newest nightly (prerelease) DSharpPlus version.

Knowledge Prerequisites

Before attempting to write a Discord bot, you should be familiar with the concepts of Object Oriented Programing, the C# programming language, and Task-based Asynchronous Pattern.

If you're brand new to C#, or programming in general, this library may prove difficult for you to use. Fortunately, there are resources that can help you get started with the language!

An excellent tutorial series to go through would be C# Fundamentals for Absolute Beginners by Bob Tabor. His videos go through all the basics, from setting up your development environment up to some of the more advanced concepts. If you're not sure what to do first, Bob's tutorial series should be your starting point!

Supported .NET Implementations

There are multiple different development and maintenance branches of DSharpPlus targeting different .NET versions and supported on different .NET versions.

IF you are using Unity, Mono or the .NET Framework, no support will be provided, and your project might break at any given moment. .NET Framework 4.6.1 through 4.8.1 should work, but we will not provide support or fixes for any issues arising there. Additionally, if you are using a game engine with C# support (such as Unity), you should consider using the Discord GameSDK instead of DSharpPlus.

If you use unsupported software, you are on your own with any arising issues.

Latest Stable 4.5.0

Version 4.5.0 should work on .NET and .NET Core versions after 3.1 and is supported from version 8.0 upwards.

Nightly 5.0

5.0 nightly builds target .NET 9.0, and will target the latest stable .NET version going forward.

6.0 early work

6.0 work targets the latest available bleeding edge of .NET, and will target the latest stable .NET version once there is a semblance of completion and stability on the v6 branch.

Getting Started

If you're writing a Discord bot for the first time, you'll want to start with creating a bot account. Otherwise, if you have a bot account already, start off with the writing your first bot article.

Once you're up and running, feel free to browse through the API Documentation!

Support and Questions

You can get in contact with us on Discord through one of the following guilds:

DSharpPlus Guild:

#dotnet_dsharpplus on Discord API: