disqord's Introduction

Disqord

An asynchronous Discord API wrapper for .NET that aims to make Discord bot development simple and enjoyable without needless boilerplate.

Designed around Microsoft's dependency injection abstractions
Integrates seamlessly with the Generic Host
Replaceable components, stateless REST, customizable caching, and more

Installation

Stable builds are available on NuGet.
Nightly Disqord builds can be pulled as NuGet packages from the MyGet feed: https://www.myget.org/F/disqord/api/v3/index.json.

Documentation

The Disqord documentation is available on GitHub Pages.

Examples

Explore examples of the library in the /examples folder, all of which are licensed under the MIT license.

Minimal Example

Typing ?ping or @YourBot ping in a channel will make the bot respond with Pong!.

using Disqord.Bot.Commands.Text;
using Disqord.Bot.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using Qmmands;
using Qmmands.Text;

await new HostBuilder()
    .ConfigureAppConfiguration(configuration =>
    {
        // We will use the environment variable DISQORD_TOKEN for the bot token.
        configuration.AddEnvironmentVariables("DISQORD_");
    })
    .ConfigureLogging(logging =>
    {
        logging.AddSimpleConsole();
    })
    .ConfigureDiscordBot((context, bot) =>
    {
        bot.Token = context.Configuration["TOKEN"];
        bot.Prefixes = new[] { "?" };
    })
    .RunConsoleAsync();

public class ExampleModule : DiscordTextModuleBase
{
    [TextCommand("ping")]
    public IResult Ping()
    {
        return Response("Pong!");
    }
}

Recommend Projects