Discord.Net is distributed through the NuGet package manager, so it is
recommended for you to install the library that way.
Alternatively, you may compile from the source and install the library
yourself.
Currently, Discord.Net targets .NET Standard 1.3 and offers support
for .NET Standard 1.1. If your application will be targeting .NET
Standard 1.1, please see the additional steps.
Since Discord.Net is built on top of .NET Standard, it is also
recommended to create applications using .NET Core, although it is not
required. When using .NET Framework, it is suggested to target
.NET Framework 4.6.1
or higher.
[!WARNING]
Using this library with Mono is not recommended until further
notice. It is known to have issues with the library's WebSockets
implementation and may crash the application upon startup.
Release builds of Discord.Net will be published to the
official NuGet feed.
Development builds of Discord.Net, as well as add-ons, will be
published to our MyGet feed.
https://www.myget.org/F/discord-net/api/v3/index.json
Not sure how to add a direct feed? See how with Visual Studio or
without Visual Studio.
[!TIP]
Don't forget to change your package source if you're installing from
the developer feed.
Also make sure to check "Enable Prereleases" if installing a dev
build!
Discord.Net
.Discord.Net
package.[!TIP]
Make sure to check the "Prerelease" box if installing a dev build!
Discord.Net
.[!TIP]
Don't forget to add the package source to a NuGet.Config file if
you're installing from the developer feed.
Discord.Net
to your .csproj.[!codeSample .csproj]
[!TIP]
Don't forget to add the package source to a NuGet.Config file if
you're installing from the developer feed.
dotnet add package Discord.Net
.In order to compile Discord.Net, you will need the following:
The .NET Core and Docker (Preview) workload is required during Visual
Studio installation.
For applications targeting a runtime corresponding with .NET Standard
1.1 or 1.2, the built-in WebSocket and UDP provider will not work. For
applications which utilize a WebSocket connection to Discord, such as
WebSocket or RPC, third-party provider packages will need to be
installed and configured.
[!NOTE]
Discord.Net.Providers.UDPClient
is only required if your
bot will be utilizing voice chat.
First, install the following packages through NuGet, or compile them
yourself, if you prefer:
Next, you will need to configure your DiscordSocketClient to use
these custom providers over the default ones.
To do this, set the WebSocketProvider
and the optional
UdpSocketProvider
properties on the DiscordSocketConfig that you
are passing into your client.
[!code-csharpNET Standard 1.1 Example]
If you plan on deploying your bot or developing outside of Visual
Studio, you will need to create a local NuGet configuration file for
your project.
To do this, create a file named NuGet.Config
alongside the root of
your application, where the project is located.
Paste the following snippets into this configuration file, adding any
additional feeds if necessary.
[!codeNuGet Configuration]