Creating a Discord bot with C#/.Net Core and DSharpPlus (2023)

#csharp #netcore #dsharpplus #discordbot

dotnet add package DSharpPlusdotnet add package DSharpPlus.CommandsNextdotnet add package DSharpPlus.Interactivity

dotnet add package Microsoft.Extensions.Configurationdotnet add package Microsoft.Extensions.Configuration.Binderdotnet add package Microsoft.Extensions.Configuration.Json

using System;using System.Linq;using System.IO;using System.Threading;using System.Threading.Tasks;using DSharpPlus;using DSharpPlus.CommandsNext;using DSharpPlus.Interactivity;using Microsoft.Extensions.Configuration;internal class Program{ /* This is the cancellation token we'll use to end the bot if needed(used for most async stuff). */ private CancellationTokenSource _cts { get; set; } /* We'll load the app config into this when we create it a little later. */ private IConfigurationRoot _config; /* These are the discord library's main classes */ private DiscordClient _discord; private CommandsNextModule _commands; private InteractivityModule _interactivity; /* Use the async main to create an instance of the class and await it(async main is only available in C# 7.1 onwards). */ static async Task Main(string[] args) => await new Program().InitBot(args); async Task InitBot(string[] args) { try { Console.WriteLine("[info] Welcome to my bot!"); _cts = new CancellationTokenSource(); // Load the config file(we'll create this shortly) Console.WriteLine("[info] Loading config file.."); _config = new ConfigurationBuilder() .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("config.json", optional: false, reloadOnChange: true) .Build(); // Create the DSharpPlus client Console.WriteLine("[info] Creating discord client.."); _discord = new DiscordClient(new DiscordConfiguration { Token = _config.GetValue<string>("discord:token"), TokenType = TokenType.Bot }); // Create the interactivity module(I'll show you how to use this later on) _interactivity = _discord.UseInteractivity(new InteractivityConfiguration() { PaginationBehaviour = TimeoutBehaviour.Delete, // What to do when a pagination request times out PaginationTimeout = TimeSpan.FromSeconds(30), // How long to wait before timing out Timeout = TimeSpan.FromSeconds(30) // Default time to wait for interactive commands like waiting for a message or a reaction }); // Build dependancies and then create the commands module. var deps = BuildDeps(); _commands = _discord.UseCommandsNext(new CommandsNextConfiguration { StringPrefix = _config.GetValue<string>("discord:CommandPrefix"), // Load the command prefix(what comes before the command, eg "!" or "/") from our config file Dependencies = deps // Pass the dependancies }); // TODO: Add command loading! RunAsync(args).Wait(); } catch(Exception ex) { // This will catch any exceptions that occur during the operation/setup of your bot. // Feel free to replace this with what ever logging solution you'd like to use. // I may do a guide later on the basic logger I implemented in my most recent bot. Console.Error.WriteLine(ex.ToString()); } } async Task RunAsync(string[] args) { // Connect to discord's service Console.WriteLine("Connecting.."); await _discord.ConnectAsync(); Console.WriteLine("Connected!"); // Keep the bot running until the cancellation token requests we stop while (!_cts.IsCancellationRequested) await Task.Delay(TimeSpan.FromMinutes(1)); } /* DSharpPlus has dependancy injection for commands, this builds a list of dependancies. We can then access these in our command modules. */ private DependencyCollection BuildDeps() { using var deps = new DependencyCollectionBuilder(); deps.AddInstance(_interactivity) // Add interactivity .AddInstance(_cts) // Add the cancellation token .AddInstance(_config) // Add our config .AddInstance(_discord); // Add the discord client return deps.Build(); }}

{ "discord": { "token": "BOT TOKEN HERE", "appId": "CLIENT ID HERE", "appSecret": "CLIENT SECRET HERE", "CommandPrefix": "/" }}

<ItemGroup> <None Update="config.json" CopyToOutputDirectory="PreserveNewest" /></ItemGroup>

public interface IModule {}

using DSharpPlus.CommandsNext;using DSharpPlus.CommandsNext.Attributes;using DSharpPlus.Entities;using DSharpPlus.Interactivity;using System;using System.Threading.Tasks;/* Create our class and extend from IModule */public class BasicCommandsModule : IModule{ /* Commands in DSharpPlus.CommandsNext are identified by supplying a Command attribute to a method in any class you've loaded into it. */ /* The description is just a string supplied when you use the help command included in CommandsNext. */ [Command("alive")] [Description("Simple command to test if the bot is running!")] public async Task Alive(CommandContext ctx) { /* Trigger the Typing... in discord */ await ctx.TriggerTypingAsync(); /* Send the message "I'm Alive!" to the channel the message was recieved from */ await ctx.RespondAsync("I'm alive!"); }}

Console.WriteLine("[info] Loading command modules..");var type = typeof(IModule); // Get the type of our interfacevar types = AppDomain.CurrentDomain.GetAssemblies() // Get the assemblies associated with our project .SelectMany(s => s.GetTypes()) // Get all the types .Where(p => type.IsAssignableFrom(p) && !p.IsInterface); // Filter to find any type that can be assigned to an IModulevar typeList = types as Type[] ?? types.ToArray(); // Convert to an arrayforeach (var t in typeList) _commands.RegisterCommands(t); // Loop through the list and register each command module with CommandsNextConsole.WriteLine($"[info] Loaded {typeList.Count()} modules.");

[Command("interact")][Description("Simple command to test interaction!")]public async Task Interact(CommandContext ctx){ /* Trigger the Typing... in discord */ await ctx.TriggerTypingAsync(); /* Send the message "I'm Alive!" to the channel the message was recieved from */ await ctx.RespondAsync("How are you today?"); var intr = ctx.Client.GetInteractivityModule(); // Grab the interactivity module var reminderContent = await intr.WaitForMessageAsync( c => c.Author.Id == ctx.Message.Author.Id, // Make sure the response is from the same person who sent the command TimeSpan.FromSeconds(60) // Wait 60 seconds for a response instead of the default 30 we set earlier! ); // You can also check for a specific message by doing something like // c => c.Content == "something" // Null if the user didn't respond before the timeout if(reminderContent == null) { await ctx.RespondAsync("Sorry, I didn't get a response!"); return; } // Homework: have this change depending on if they say "good" or "bad", etc. await ctx.RespondAsync("Thank you for telling me how you are!");}

If you want to accept arguments from commands, you can add parameters after the CommandContext(EG:

Interact(CommandContext ctx, int age, [remainder]string fullName);