Discord.Net.Labs.Core 2.4.5

Discord.Net Labs

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 normal package of Playwo's InteractivityAddon. The reason is that his package depends on the base discord.net lib. You can instead use the InteractivityAddon.Labs package which implements some of the features added in Discord.Net-Labs.

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