Note

These articles and the API documentation are built for the latest nightly version (v5.0)

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 branches of DSharpPlus targeting different .NET versions.

See the table below for supported .NET implementations:

DSharpPlus Branch	.NET	.NET Core	.NET Framework
Stable, v4.5.X	v8.0 - v9.0 ✔️	v3.1 ⚠️	v4.6.1 - v4.8.1 ⚠️
Nightly, v5.0	v9.0 ✔️	❌	❌
Future, v6.0	v10.0 ✔️	❌	❌

_{✔️ Recommended and supported  ●  ⚠️ Unsupported, might still work  ●  ❌ Unsupported, do not use}

Generally, you should be targeting the latest version of .NET.

.NET Core and .NET Framework are not directly targeted by DSharpPlus, but may work in some senarios because of the .NET Standard.

Using Unity, Mono, .NET Framework, or any other .NET implementation other than the ones listed with a ✔️ above are not supported by DSharpPlus, and you will be on your own regarding any arising issues.

If you are using a game engine with C# support (such as Unity), you should consider using the Discord GameSDK instead of DSharpPlus.

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: