Drolez bot

This bot does management stuff, that Web API can't do.
You can manage roles with subfolders
This bot contains WebSockets server with SSL support for .NET core
Web dashboard using this bot: https://drolez.studio/ (shows only logged in user for now)

Written in C# for .NET core 2.2
Bot tested on Debian GNU/Linux 9

To run it after publishing go to the folder where you published it (Drolez.dll should be inside that folder) and run:
(You need to have dotnet installed)

dotnet Drolez.dll

To connect to bot over websockets use (you don't need :port if you have different forwarding):

wss://bot.adress:port

Command/Event return JSON format:

{"Data":{},"action":""}

Websocket Commands:

Example of error return:

{"Data":"Error message","action":"error"}

Example of roles-list return:

{"Data":[{},{},,,,],"action":"rolesList"}

auth/<token>/<TimeToLive(seconds)>
Returns: Loged in user data on success
Desc: On fail kicks client

roles-list/<guildId>
Returns: list of roles in a json format
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

roles-list/<guildId>/<userId>
Returns: list of roles for specified user in a json format
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

guilds/<userId>
Returns: list of guilds for specified user in a json format
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

role/<guildId>/<userId>
Returns: Role for specified user in guild in a json format
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

role-set/<guildId>/<roleJSON>
Result: if role ID is 0, command will create a new role, otherwise it modifies existing one
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

role-remove/<guildId>/<roleId>
Result: Removes existing role
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

role-set-path/<guildId>/<roleId>/<path>
Result: Changes directory path to the role (path eg.: /path/to/role/folder)
Desc: On fail either returns "ERR:Empty!" or "ERR:Unknown!"

ping
Returns: pong

Websocket Events:

Event JSON format:
Data can contain Role, Guild, User object
Action contains event name (see below).

{"Data":{"Identifier":"0","Avatar":"",},"action":"userLeft"}

List of events that get send to connected clients:
guildJoined, guildLeft, roleCreated, roleDeleted, roleUpdated, userLeft

Extensibility

You can easilly add more commands to this bot.
By implementing ICommand interface and adding CommandInfo attribute to it.
Than just place it in the Commands folder, rebuild it and run!
Commands in Drolez.Commands namespace will load automatically on start-up.

namespace Drolez.Commands
{
    using System.Net.WebSockets;
    using DW = Discord.WebSocket;

    /// <summary>
    /// string in the CommandInfo is the command name
    /// </summary>
    [CommandInfo("my-amazing-command")]
    public class MyAmazingCommand : ICommand
    {
        /// <summary>
        /// Run my amazing example command
        /// </summary>
        /// <param name="socket">Web socket</param>
        /// <param name="user">Discord user who invoked this command</param>
        /// <param name="parameters">Command parameters</param>
        /// <returns>True on success</returns>
        public bool Run(WebSocket socket, DW.SocketUser user, string[] parameters)
        {
            // First parameter is what client will see in Action parameter, second is and object (Data)
            socket.Send("myAmazingCommand", "Hello");
            return true;
        }
    }
}

Config file

Configuration file shoulde be named settings.xml and placed in the same folder as bot
File content:

<?xml version="1.0"?>
<settings>
	<Token>bot token</Token>
	<CertificatePath>/absolute/path/to/certificate.pfx</CertificatePath>
	<CertificatePassword>myCertificatePassword</CertificatePassword>
	<DBServer>my.amazing.db</DBServer>
	<DBName>myDB</DBName>
	<DBUser>me</DBUser>
	<DBPassword>myPassword</DBPassword>
</settings>

Database table

Bot will look for a table named RoleFolders, that contains 3 columns:

bigint - "Id" - unsigned - default(0)
text - "Folder"
bigint - "Guildid" - unsigned - default(0)