Info

StoatSharp is a bot lib used to connect to Stoat chat app.

This lib supports both bots and user accounts.

Core Features

• Stability: The lib is designed to handle errors and exceptions with logging and nice error messages to help you build a public bot.
• Easy to Use: StoatSharp has similar design principals to discord.net with easy to use objects and properties.
• Connection: The WebSocket is error proof and will keep the connection alive even during an outage or unstable network!
• Efficient: You can run a private 1 server bot using 30mb of ram (with command handling, commands and cache) or a public bot in 450+ servers with 210mb of ram that can run on any $3 hosting service with 1GB ram!
• Cache: The lib will cache reuseable data for an easy to use and fast experience, especially with events.
• Requests: You can send custom requests using Client.Rest.SendRequest that uses disposable streams and buffers for memory efficiency.
• Documented: Most of the code is documented with xml code comments or you can see the docs here https://docs.fluxpoint.dev/Stoatsharp
• Command Handler: StoatSharp has a built-in command handler that can parse commands with a prefix and you can create command modules to run code.

Support

Join the StoatSharp server for support and meet other C# developers!

https://stt.gg/N33Rf6DE

Documentation

The library is documented in code and also has a docs site that you can browser with guides!

https://docs.fluxpoint.dev/Stoatsharp

Install

You can download the lib in visual studio/code using this Nuget Package

Once it's installed you can use this basic example.

static void Main(string[] args)
{
    Start().GetAwaiter().GetResult();
}

public static StoatClient Client;
public static async Task Start()
{
    Client = new StoatClient(ClientMode.WebSocket);
    await Client.LoginAsync(Token, AccountType.Bot);
    await Client.StartAsync();
    await Task.Delay(-1);
}

Commands

This lib also includes and easy to use command system for setting up commands and using data. Big thanks to Discord.net for the internal command handler system, this was modified to work with Stoat and the classes.

Here is an example on how to setup commands.

class Program
{
    static void Main(string[] args)
    public static StoatClient Client;
    {
        Start().GetAwaiter().GetResult();
    }

    public static async Task Start()
    {
        Client = new StoatClient("Bot Token", ClientMode.WebSocket);
        await Client.StartAsync();
        CommandHandler Commands = new CommandHandler(Client);
        Commands.Service.AddModulesAsync(Assembly.GetEntryAssembly(), null);
        await Task.Delay(-1);
    }
}

public class CommandHandler
{
    public CommandHandler(StoatClient client)
    {
        Client = client;
        client.OnMessageRecieved += Client_OnMessageRecieved;
    }
	
    public StoatClient Client;
    public CommandService Service = new CommandService();
    private void Client_OnMessageRecieved(Message msg)
        {
            UserMessage Message = msg as UserMessage;
            if (Message == null || Message.Author.IsBot)
                return;
            int argPos = 0;
            if (!(Message.HasCharPrefix('!', ref argPos) || Message.HasMentionPrefix(Client.CurrentUser, ref argPos)))
                return;
            CommandContext context = new CommandContext(Client, Message);
            Service.ExecuteAsync(context, argPos, null);
        }
}

Create a command

public class CmdTest : ModuleBase
{
    [Command("hi")]
    public async Task Hi()
    {
        await ReplyAsync("Hi " + Context.User.Username);
    }

    [Command("say")]
    public async Task Say([Remainder] string text)
    {
        await ReplyAsync(text);
    }
}