HelperLib 1.2.0

HelperLib

HelperLib is a small utility library with helpers commonly used when building Discord bots with Discord.NET (targeting .NET 9). It provides convenience wrappers and utilities to simplify common tasks, such as parsing mentions, sending embeds/images, interacting with guild entities, and handling basic reliability for the Discord client.

Features

• IonicHelper — Common static helpers for working with a running DiscordSocketClient (guild/channel/role lookups, guild user enumeration, role checks, cancellation token management, and simple reconnect handling).
• Services.ReliabilityService — Encapsulates a reconnect/reset strategy for DiscordSocketClient with configurable timeout behavior.
• Util.MentionUtils — Create and parse Discord mentions for users, channels, and roles.
• Util.Extensions — Extension helpers for sending Embed/EmbedBuilder and sending images from URLs.
• Preconditions.RequireRoleAttribute — Command precondition attribute for Discord.Commands that restrict usage to a given role ID.
• Models.GuildUsersResult — Lightweight result type for guild user enumeration.

Quick start

1. Add the project or compiled DLL to your bot solution (project reference or NuGet if you publish it).
2. Create and start a DiscordSocketClient using IonicHelper or use ReliabilityService to attach reconnect behavior.

Example (simple start using IonicHelper):

var token = "YOUR_BOT_TOKEN";
var helper = new IonicHelper(token, defaultGuildId: 123456789012345678);
await helper.RunAsync(new DiscordSocketConfig(), message => { Console.WriteLine(message); return Task.CompletedTask; });

Example usages:

• Parse a user mention:

if (MentionUtils.TryParseUser("<@!123456>", out var userId)) { /* use userId */ }

• Send an embed using extension methods:

await textChannel.SendEmbedAsync(new EmbedBuilder().WithTitle("Hello").Build());

• Require a role on a command:

[RequireRole(123456789012345678)]
public async Task MyCommand() { ... }

Notes

• This library is intended as a convenience layer over Discord.NET and expects a DiscordSocketClient to be available at runtime when using IonicHelper static helpers.
• The reconnect logic is intentionally simple: on repeated failures, the process will exit (FailFast/Environment.Exit) so that orchestration systems can restart the bot.

Contributing

PRs and bug reports are welcome. Keep changes focused and add tests or usage examples when possible.

License

MIT