Discord.Net.Labs 2.3.8-dev

Suggested Alternatives

Discord.Net

This is a prerelease version of Discord.Net.Labs.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Discord.Net.Labs --version 2.3.8-dev
NuGet\Install-Package Discord.Net.Labs -Version 2.3.8-dev
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Discord.Net.Labs" Version="2.3.8-dev" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Discord.Net.Labs --version 2.3.8-dev
#r "nuget: Discord.Net.Labs, 2.3.8-dev"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Discord.Net.Labs as a Cake Addin
#addin nuget:?package=Discord.Net.Labs&version=2.3.8-dev&prerelease

// Install Discord.Net.Labs as a Cake Tool
#tool nuget:?package=Discord.Net.Labs&version=2.3.8-dev&prerelease

Discord.Net Labs

NuGet

Join our Discord server for support using labs

This repo is a custom fork of Discord.Net that introduces the newest features of discord for testing and experimenting. Nothing here is guaranteed to work but you are more than welcome to submit bugs in the issues tabs

Known issues

Labs will not work with Playwo's InteractivityAddon. The reason is that his package depends on the base discord.net lib, you can get around this by cloning his repo and building it with discord.net labs instead of discord.net.

How to use

Setting up labs in your project is really simple, here's how to do it:

  1. Remove Discord.Net from your project
  2. Add Discord.Net Labs nuget to your project
  3. Enjoy!

Branches

Dev

The main branch we pull off of to introduce new features into, the dev branch is the same as Discord.Nets dev branch

Interactions

This branch is for anything todo with Discord Interactions, such as Slash commands and Message Components. This branch is stable enough to use but does not contain all the features of interactions.

SlashCommandService

This branch is on pause and does not work currently, Once everything is stable with the Interaction branch we will continue working on a slash command service for it.

web/SlashCommandService

webmilio's spin on the SlashCommandService branch, again the state of this is unknown.

Message Components

So, you want to use Message components? Well you're in luck! Below is a quick overview of how to use them

Listening for button presses
// Subscribe to the InteractionCreated event
client.InteractionCreated += Client_InteractionCreated;

...
private async Task Client_InteractionCreated(SocketInteraction arg)
{
  // If the type of the interaction is a message component
  if(arg.Type == Discord.InteractionType.MessageComponent)
  {
    // parse the args 
    var parsedArg = (SocketMessageComponent)arg;
    // respond with the update message response type. This edits the original message if you have set AlwaysAcknowledgeInteractions to false.
    await parsedArg.RespondAsync($"Clicked {parsedArg.Data.CustomId}!", type: InteractionResponseType.UpdateMessage);
  }
}
Sending messages with buttons

Theres a new field in all SendMessageAsync functions that takes in a MessageComponent, you can use it like so:

var builder = new ComponentBuilder().WithButton("Hello!", ButtonStyle.Primary, customId: "id_1");
await Context.Channel.SendMessageAsync("Test buttons!", component: builder.Build());

Slash commands

Slash command example how to's can be found here. If you want to read some code using slash commands, you can do that here

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Discord.Net.Labs:

Package Downloads
Discord.KillersLibrary.Labs

This package is an Addon for Discord.Net It provides embedding pages and multi buttons for your Discord Bot. Moreover it includes support for any command framework and slash commands.

Xssp.Discord.Util The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides various utilities to simplify the use of the Discord.NET API.

DNetLabRat

Button lib for Discord.Net-Labs

Discord.Killer

This package is an Addon for Discord.Net. It provides enbeding pages for your Discord Bot. Moreover it includes support for any command framework.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.6.1 22,719 12/24/2021
3.6.0 535 12/24/2021
3.5.0 1,452 12/15/2021
3.4.9 3,037 12/6/2021
3.4.8 5,164 12/4/2021
3.4.7 2,780 11/28/2021
3.4.6 655 11/27/2021
3.4.5 509 11/27/2021
3.4.4 552 11/27/2021
3.4.3 546 11/27/2021
3.4.2 2,300 11/26/2021
3.4.1 1,811 11/26/2021
3.4.0 1,878 11/26/2021
3.3.3 763 11/23/2021
3.3.2 1,033 11/21/2021
3.3.1 1,182 11/21/2021
3.3.0 1,442 11/19/2021
3.2.0 1,679 11/9/2021
3.1.7 3,283 10/20/2021
3.1.6 1,313 10/15/2021
3.1.5 648 10/15/2021
3.1.4 841 10/13/2021
3.1.3 1,043 10/12/2021
3.1.2 649 10/12/2021
3.1.1 3,092 9/23/2021
3.1.0 769 9/21/2021
3.0.4 1,137 9/15/2021
3.0.3 3,224 9/13/2021
3.0.2 3,422 8/25/2021
3.0.2-pre 733 8/8/2021
3.0.1 550 8/25/2021
3.0.1-pre 376 8/5/2021
3.0.0 664 8/24/2021
3.0.0-pre 239 8/5/2021
2.4.9 1,596 7/17/2021
2.4.8 667 7/15/2021
2.4.7 833 7/11/2021
2.4.6 726 7/11/2021
2.4.5 633 7/7/2021
2.4.4 651 7/6/2021
2.4.3 620 7/5/2021
2.4.2 634 7/4/2021
2.4.1 662 7/3/2021
2.4.0 646 7/3/2021
2.3.8-dev 337 7/2/2021
2.3.7 1,168 5/30/2021
2.3.6 711 5/30/2021
2.3.5 678 5/30/2021
2.3.4 643 5/29/2021
2.3.3 615 5/28/2021
2.3.2 587 5/28/2021
2.3.1 645 5/27/2021