Search Results for

    Show / Hide Table of Contents

    Discord.Net Installation

    Discord.Net is distributed through the NuGet package manager; the most recommended way for you to install this library. Alternatively, you may also compile this library yourself should you so desire.

    Supported Platforms

    Discord.Net targets .NET 6.0 and .NET 5.0, but is also available on older versions, like .NET Standard and .NET Core; this still means that creating applications using the latest version of .NET (6.0) is most recommended. If you are bound by Windows-specific APIs or other limitations, you may also consider targeting .NET Framework 4.6.1 or higher.

    Warning

    Using this library with Mono is not supported until further notice. It is known to have issues with the library's WebSockets implementation and may crash the application upon startup.

    Installing with NuGet

    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. See @Guides.GettingStarted.Installation.Nightlies to learn more.

    • Using Visual Studio
    • Using JetBrains Rider
    • Using Visual Studio Code
    • Using dotnet CLI
    1. Create a new solution for your bot
    2. In the Solution Explorer, find the "Dependencies" element under your bot's project
    3. Right click on "Dependencies", and select "Manage NuGet packages"

      Step 3

    4. In the "Browse" tab, search for Discord.Net

    5. Install the Discord.Net package

      Step 5

    1. Create a new solution for your bot
    2. Open the NuGet window (Tools > NuGet > Manage NuGet packages for Solution)

      Step 2

    3. In the "Packages" tab, search for Discord.Net

      Step 3

    4. Install by adding the package to your project

      Step 4

    1. Create a new project for your bot
    2. Add Discord.Net to your *.csproj
    <Project Sdk="Microsoft.NET.Sdk">
    
      <!--
      The following may differ depending on the latest version of 
      .NET Core or Discord.Net.
      -->
    
      <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>netcoreapp2.1</TargetFramework>
      </PropertyGroup>
    
      <ItemGroup>
        <PackageReference Include="Discord.Net" Version="2.0.0" />
      </ItemGroup>
    
    </Project>
    
    1. Launch a terminal of your choice
    2. Navigate to where your *.csproj is located
    3. Enter dotnet add package Discord.Net

    Compiling from Source

    In order to compile Discord.Net, you will need the following:

    Using Visual Studio

    • Visual Studio 2019 or later.
    • .NET 5 SDK

    The .NET 5 workload is required during Visual Studio installation.

    Using Command Line

    • .NET 5 SDK

    Additional Information

    Installing on Unsupported WebSocket Platform

    When running any Discord.Net-powered bot on an older operating system (e.g. Windows 7) that does not natively support WebSocket, you may encounter a PlatformNotSupportedException upon connecting.

    You may resolve this by either targeting .NET Core 2.1 or higher, or by installing one or more custom packages as listed below.

    • Targeting .NET Core 2.1
    • Custom Packages
    1. Download the latest [.NET Core SDK].
    2. Create or move your existing project to use .NET Core.
    3. Modify your <TargetFramework> tag to at least netcoreapp2.1, or by adding the --framework netcoreapp2.1 switch when building.
    1. Install or compile the following packages:

      • Discord.Net.Providers.WS4Net
      • Discord.Net.Providers.UDPClient (Optional)
        • This is only required if your bot will be utilizing voice chat.
    2. 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.
      
    using Discord.Providers.WS4Net;
    using Discord.Providers.UDPClient;
    using Discord.WebSocket;
    // ...
    var client = new DiscordSocketClient(new DiscordSocketConfig 
    {
    	WebSocketProvider = WS4NetProvider.Instance,
    	UdpSocketProvider = UDPClientProvider.Instance,
    });
    

    This page was last modified at 12/19/2021 03:41:58 -04:00 (UTC).

    Commit Message
    Author:    Quin Lynch
    Commit:    6c7502da685a95d5c855665b99af0f6de4d0eec1
    
    Update to Labs 3.5.0 (#1971)
    
    * Merge https://github.com/Discord-Net-Labs/Discord.Net-Labs into patch/labs3.5.0
    
    * Add missing periods

    Theme

    • Improve this Doc
    In This Article
    Back to top Discord.Net (c) 2015-2022 3.6.0