Discord.Net.Labs 2.4.4

Suggested Alternatives

Discord.Net

There is a newer version of this package available.
See the version list below for details. 
dotnet add package Discord.Net.Labs --version 2.4.4
NuGet\Install-Package Discord.Net.Labs -Version 2.4.4
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.4.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Discord.Net.Labs --version 2.4.4
#r "nuget: Discord.Net.Labs, 2.4.4"
#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.4.4

// Install Discord.Net.Labs as a Cake Tool
#tool nuget:?package=Discord.Net.Labs&version=2.4.4

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!

Listening for interactions

// Subscribe to the InteractionCreated event
client.InteractionCreated += Client_InteractionCreated;

...
private async Task Client_InteractionCreated(SocketInteraction arg)
{
  switch (arg.Type) // We want to check the type of this interaction
  {
    //Slash commands
    case InteractionType.ApplicationCommand:
      await MySlashCommandHandler(arg);
      break;
    //Button clicks/selection dropdowns
    case InteractionType.MessageComponent:
      await MyMessageComponentHandler(arg);
      break;
    //Unused
    case InteractionType.Ping:
      break;
    //Unknown/Unsupported
    default:
      Console.WriteLine("Unsupported interaction type: " + arg.Type);
      break;
  }
}

Handling button clicks and selection dropdowns

private async Task MyMessageComponentHandler(SocketInteraction arg)
{
    // Parse the arg
    var parsedArg = (SocketMessageComponent) arg;
    // Get the custom ID 
    var customId = parsedArg.Data.CustomId;
    // Get the user
    var user = (SocketGuildUser) arg.User;
    // Get the guild
    var guild = user.Guild;
    
    // Respond with the update message response type. This edits the original message if you have set AlwaysAcknowledgeInteractions to false.
    // You can also use "ephemeral" so that only the original user of the interaction sees the message
    await parsedArg.RespondAsync($"Clicked {parsedArg.Data.CustomId}!", type: InteractionResponseType.UpdateMessage, ephemeral: true);
    
    // You can also followup with a second message
    await parsedArg.FollowupAsync($"Clicked {parsedArg.Data.CustomId}!", type: InteractionResponseType.ChannelMessageWithSource, ephemeral: true);
    
    //If you are using selection dropdowns, you can get the selected label and values using these:
    var selectedLabel = ((SelectMenu) parsedArg.Message.Components.First().Components.First()).Options.FirstOrDefault(x => x.Value == parsedArg.Data.Values.FirstOrDefault())?.Label;
    var selectedValue = parsedArg.Data.Values.First();
}

Note: The example above assumes that the selection dropdown is expecting only 1 returned value, if you configured your dropdown for multiple values, you'll need to modify the code slightly.

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!", customId: "id_1", ButtonStyle.Primary, row: 0);
await Context.Channel.SendMessageAsync("Test buttons!", component: builder.Build());

Sending messages with selection dropdowns

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

var builder = new ComponentBuilder()
  .WithSelectMenu(new SelectMenuBuilder()
  .WithCustomId("id_2")
  .WithLabel("Select menu!")
  .WithPlaceholder("This is a placeholder")
  .WithOptions(new List<SelectMenuOptionBuilder>()
  {
    new SelectMenuOptionBuilder()
      .WithLabel("Option A")
      .WithEmote(Emote.Parse("<:evanpog:810017136814194698>"))
      .WithDescription("Evan pog champ")
      .WithValue("value1"),
    new SelectMenuOptionBuilder()
      .WithLabel("Option B")
      .WithDescription("Option B is poggers")
      .WithValue("value2")
  }));
await Context.Channel.SendMessageAsync("Test selection!", component: builder.Build());

Note: You can only have 5 buttons per row and 5 rows per message. If a row contains a selection dropdown it cannot contain any buttons.

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,755 12/24/2021
3.6.0 536 12/24/2021
3.5.0 1,453 12/15/2021
3.4.9 3,046 12/6/2021
3.4.8 5,165 12/4/2021
3.4.7 2,781 11/28/2021
3.4.6 656 11/27/2021
3.4.5 510 11/27/2021
3.4.4 553 11/27/2021
3.4.3 547 11/27/2021
3.4.2 2,301 11/26/2021
3.4.1 1,812 11/26/2021
3.4.0 1,879 11/26/2021
3.3.3 764 11/23/2021
3.3.2 1,034 11/21/2021
3.3.1 1,183 11/21/2021
3.3.0 1,443 11/19/2021
3.2.0 1,680 11/9/2021
3.1.7 3,305 10/20/2021
3.1.6 1,314 10/15/2021
3.1.5 649 10/15/2021
3.1.4 842 10/13/2021
3.1.3 1,044 10/12/2021
3.1.2 650 10/12/2021
3.1.1 3,093 9/23/2021
3.1.0 770 9/21/2021
3.0.4 1,138 9/15/2021
3.0.3 3,226 9/13/2021
3.0.2 3,423 8/25/2021
3.0.2-pre 733 8/8/2021
3.0.1 551 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