Table of Contents

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

Because DSharpPlus targets .NET Standard 2.0, there are many implementations that may function with DSharpPlus. However, there are only a few versions we will explicitly provide support for.

Implementation Support Notes
.NET ✔️ EoL versions Core 3.1 and 5.0 should work; LTS version 6.0 and STS version 7.0 are supported.
.NET Framework ⚠️ Versions 4.6.1 through 4.8 should work fine. However, we do not directly support .NET Framework. We recommend that you use the latest or LTS version of .NET Core.
Mono ❌️ Has numerous flaws which can break things without warning. If you need a cross platform runtime, use .NET.
Unity ❌️ Game engines with C# support will never be supported by DSharpPlus. You should consider using the official Discord GameSDK instead.

If you use an unsupported implementation and encounter issues, you'll be on your own.

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:
DSharpPlus Guild

#dotnet_dsharpplus on Discord API:
Discord API / #dotnet_dsharpplus