Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/DSharpPlus/DSharpPlus

A .NET library for making bots using the Discord API.
https://github.com/DSharpPlus/DSharpPlus

api bot csharp discord discord-api discord-bot discordsharp discordsharpplus dotnet dotnet-core dsharpplus hacktoberfest plus

Last synced: 27 days ago
JSON representation

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

Lists

README

        

![Logo of DSharpPlus](https://github.com/DSharpPlus/DSharpPlus/raw/master/logo/dsharp+_smaller.png)

# DSharpPlus

An unofficial .NET wrapper for the Discord API, based off [DiscordSharp](https://github.com/suicvne/DiscordSharp), but rewritten to fit the API standards.

[![Nightly Build Status](https://github.com/DSharpPlus/DSharpPlus/actions/workflows/publish_nightly_master.yml/badge.svg?branch=master)](https://github.com/DSharpPlus/DSharpPlus/actions/workflows/publish_nightly_master.yml)
[![Discord Server](https://img.shields.io/discord/379378609942560770.svg?label=Discord&color=506de2)](https://discord.gg/dsharpplus)
[![NuGet](https://img.shields.io/nuget/v/DSharpPlus.svg?label=NuGet)](https://nuget.org/packages/DSharpPlus)
[![NuGet Latest Nightly/Prerelease](https://img.shields.io/nuget/vpre/DSharpPlus?color=505050&label=NuGet%20Latest%20Nightly%2FPrerelease)](https://nuget.org/packages/DSharpPlus)

# Installing

You can install the library from following sources:

1. All Nightly versions are available on [Nuget](https://www.nuget.org/packages/DSharpPlus/) 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](https://nuget.org/packages/DSharpPlus). 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:

```xml

```

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](https://dsharpplus.github.io/DSharpPlus).

## Resources

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

### Tutorials

* [Making your first bot in C#](https://dsharpplus.github.io/DSharpPlus/articles/basics/bot_account.html).

### Example bots

* [Example by OoLunar](https://github.com/DSharpPlus/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:

* Naamloos
* [Ko-Fi](https://ko-fi.com/naamloos)
* Emzi0767
* [Ko-Fi](https://ko-fi.com/emzi0767)
* [PayPal](https://paypal.me/Emzi0767/5USD)
* [Patreon](https://patreon.com/emzi0767)

# Questions?

Come talk to us here:

[![DSharpPlus Chat](https://discord.com/api/guilds/379378609942560770/embed.png?style=banner1)](https://discord.gg/dsharpplus)

Alternatively, you could also join us in the [Discord API chat](https://discord.gg/discord-api) at **#dotnet_dsharpplus**.

[![Discord API Chat](https://discord.com/api/guilds/81384788765712384/embed.png?style=banner1)](https://discord.gg/discord-api)