/DSharpPlus

A .NET Standard library for making bots using the Discord API.

Primary LanguageC#MIT LicenseMIT

Logo of DSharpPlus

DSharpPlus

An unofficial .NET wrapper for the Discord API, based off DiscordSharp, but rewritten to fit the API standards.

Nightly Build Status Discord Server NuGet NuGet Latest Nightly/Prerelease

Installing

You can install the library from following sources:

  1. All Nightly versions are available on Nuget as a pre-release. These are cutting-edge versions automatically built from the latest commit in the master branch in this repository, and as such always contains the latest changes. If you want to use the latest features on Discord, you should use the nightlies.

    Despite the nature of pre-release software, all changes to the library are held under a level of scrutiny; for this library, unstable does not mean bad quality, rather it means that the API can be subject to change without prior notice (to ease rapid iteration) and that consumers of the library should always remain on the latest version available (to immediately get the latest fixes and improvements). You will usually want to use this version.

  2. The latest stable release is always available on NuGet. Stable versions are released less often, but are guaranteed to not receive any breaking API changes without a major version bump.

    Critical bugfixes in the nightly releases will usually be backported to the latest major stable release, but only after they have passed our soak tests. Additionally, some smaller fixes may be infrastructurally impossible or very difficult to backport without "breaking everything", and as such they will remain only in the nightly release until the next major release. You should evaluate whether or not this version suits your specific needs.

  3. The library can be directly referenced from your csproj file. Cloning the repository and referencing the library is as easy as:

    git clone https://github.com/DSharpPlus/DSharpPlus.git DSharpPlus-Repo
    

    Edit MyProject.csproj and add the following line:

    <ProjectReference Include="../DSharpPlus-Repo/DSharpPlus/DSharpPlus.csproj" />

    This belongs in the ItemGroup tag with the rest of your dependencies. The library should not be in the same directory or subdirectory as your project. This method should only be used if you're making local changes to the library.

Documentation

The documentation for the latest stable version is available at dsharpplus.github.io.

Resources

The following resources apply only for the latest stable version of the library.

Tutorials

Example bots

I want to throw my money at you

If you want to give us some money as a thank you gesture, you can do so using one of these links:

Questions?

Come talk to us here:

DSharpPlus Chat

Alternatively, you could also join us in the Discord API chat at #dotnet_dsharpplus.

Discord API Chat