Guilded 0.7.5

Guilded.NET

Guilded.NET is a free and open-source unofficial API wrapper for Guilded written on .NET platform. It allows creating bots, webhooks and interacting any other way with Guilded API.

• To get started with Guilded.NET, check out documentation page.
• To see all Guilded.NET API references, check out reference page.

Installing

To add Guilded.NET to your existing project:

dotnet add package Guilded

To create a new Guilded.NET project:

dotnet new -i Guilded.Templates
dotnet new guilded.bot

Example

Here's an example of a minimal bot with a "ping" command in C# 10:

// Program.cs
using System.Reactive.Linq;
using Guilded;

string auth   = "your_bots_auth_token",
       prefix = "!";

using var client = new GuildedBotClient(auth);

client.Prepared
      .Subscribe(me =>
          Console.WriteLine("The bot is prepared!\nLogged in as \"{0}\" with the ID \"{1}\"", me.Name, me.Id)
      );

// Wait for !ping messages
client.MessageCreated
    .Where(msgCreated => msgCreated.Content == prefix + "ping")
    .Subscribe(async msgCreated =>
        await msgCreated.ReplyAsync("Pong!")
    );

await client.ConnectAsync();

// Don't close the program when the bot connects
await Task.Delay(-1);

(Implicit usings option is enabled)

Goals

Our goal is to provide a library that is consistent and fast, while also maintaining friendliness towards the bot developers. API library that does not bite bot developer's hand allows bot developers to focus more on their code, have fun in what they are doing and have easier time creating their bots. Consistency helps code be more predictable, easier to rewrite and waste less time. As such, these 3 points are our main goals while maintaining Guilded.NET.

Other information

Links

• Website
• NuGet
• FuGet

Maintainers

• IdkGoodName - leading maintainer

Libraries

• NewtonSoft.Json - Used as a library to (de)serialize Guilded.NET models.
• RestSharp - Used for REST clients
• Websocket.Client - Used for WebSocket clients
• DefaultDocumentation - Generates documentation/references from .NET XML documentation

See also

• Guilded.NET Discussions Group
• Programming Space