Discord.InteractivityAddon 1.2.2

Discord.InteractivityAddon

This is an addon for the Discord API Wrapper Discord.Net which adds a lot of useful interactivity features.

Credits

• The package has been created with the support of TwentyFourMinutes. Check out his UtilityAddon which provides some great features for your bot 😃
• The criterion system is inspired by foxbot's Discord.Addons.Interactive package.

Features

• Waiting for a specific message or reaction using a powerful criteria system
• Applying a custom action to every message / reaction which passes your criteria
• Send and delete messages & files with delays
• A powerful Paginator
• Selection from a custom list of objects
• Confirmation of an action

Usage

To use the features you need to add an InteractivityService to your service provider.

var provider = new ServiceCollection()
                .AddSingleton(Client)
                .AddSingleton(CommandService)
                .AddSingleton(new InteractivityService(Client, TimeSpan.FromMinutes(3)))

This addon does not include a custom ModuleBase to be able to support every command framework.

Example Selection Command

[Command("select")]
public async Task ExampleSelectionAsync()
{
    var builder = new SelectionBuilder<string>()
                    .WithSettings(allowCancel: true)
                    .WithUsers(Context.User)
                    .WithValues(new[] { "Hi", "How", "Hey", "Huh?!" })
                    .WithAppearance(SelectionAppearance.Default
                    .WithSettings(deleteSelectionAfterCapturedResult: true));
                            
    var result = await _interactivity.GetUserSelectionAsync(builder.Build(), Context.Channel, TimeSpan.FromSeconds(50));

    if (result.IsSuccess == true) {
        await Context.Channel.SendMessageAsync(result.Value);
    }
}

Example Paginator Command

[Command("paginator")]
public async Task ExamplePaginatorAsync()
{
    var pages = new List<Embed>() {
        new EmbedBuilder().WithTitle("I").Build(),
        new EmbedBuilder().WithTitle("am").Build(),
        new EmbedBuilder().WithTitle("cool").Build(),
        new EmbedBuilder().WithTitle(":sunglasses: ").Build(),
    };

    var paginator = new PaginatorBuilder()
        .WithEmbeds(pages.ToArray())
        .WithUsers(Context.User)
        .WithPaginatorFooter(PaginatorFooter.PageNumber | PaginatorFooter.Users)
        .Build();

    await _interactivity.SendPaginatorAsync(paginator, Context.Channel, TimeSpan.FromMinutes(2));
}