Discord.Net is distributed through the NuGet package manager, and we
recommend installing Discord.Net with NuGet.
Alternatively, you may compile from source and install 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 the .NET Standard, we recommend you
creating applications using .NET Core. When using .NET Framework,
you should target .NET Framework 4.6.1
or higher.
Release builds of Discord.Net 1.0 will be published to the
official NuGet feed.
Development builds of Discord.Net 1.0, as well as addons (TODO) are
published to our development MyGet feed.
Direct feed link: 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.[!code-xmlSample .csproj]
In order to compile Discord.Net, acquire the following:
The .NET Core and Docker (Preview) workload is required during Visual
Studio installation.
For applications targeting a runtime environment corresponding with
.NET Standard 1.1 or 1.2, the built-in WebSocket and UDP provider will
not work. Install and configure third-party provider packages for
applications utilizing a WebSocket or an RPC connection to Discord.
[!NOTE]
Discord.Net.Providers.UDPClient
is only required if your bot will
be utilizing voice chat.
Set the WebSocketProvider
and optionally the UdpSocketProvider
properties in the DiscordSocketConfig and pass the config 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 solution is located.
Paste the following snippets into this configuration file, adding any
additional feeds as necessary.
[!code-xmlNuGet Configuration]