ST3-Moderator

ST3-Moderator is a discord bot programmed by @ST3VI3 RICHI3#5015. The bot is created with a focus on moderation.

Brief history

The current version of the bot is not the first write. ST3-Moderator had a previous life in which it ran 24/7. The previous bot died due to hard drive faliure. This bot, hopefully, will not fail in the same way.

Description

The bot aims to ease discord server moderation. This will be achived by not only alowing customisation (some customisation is exclusive self-hosted versions) but providing utilities such as spam protection (Not currently implemented), timed user mutes, etc.

The bot can be added here.
You can also join the bot testing server.

Current bot features:

Admin

1. User management

   • Kick
     Kicks a given user.
     Args: "User": discord.member (@mention / ID will work.), "reason".

   • Ban
     Bans a given user.
     Args: "User": discord.member (@mention / ID will work.), "reason".

   • Role
     Adds / removes a given role from a user.
     Args: "func" Can be two values: "add" "remove", "User": discord.member (@mention / ID will work.), role: discord.Role (@role / role ID will work.).

   • Whois
     Provides information on a given user.
     Args: "User": discord.member (@mention / ID will work.).

   • mute
     Mutes a given user.
     Args: "User": discord.member (@mention / ID will work.).

   • unmute
     Unmutes a given user.
     Args: "User": discord.member (@mention / ID will work.).

   • setmute
     Sets the ID of the role to give a user upon mute.
     Args: "Role": discord.role (@mention / ID will work.).

   • confmute
     Sets a property in "guilds.json".
     Args: "option", "value".
     Options: "LTAP" (Leave To Avoid Punishment {true / false}).

   • SetAutorole
     Sets a role to be automatically asigned when a new member joins.
     Args: "Role": discord.role (@mention / ID will work.).

2. Channel Utilities

   • C_Announce
     mentions everyone in a channel.
     Args: "message".

   • Purge
     Purges a given ammount of messages (command message automatically included).
     Args: "Ammount".

Dev

1. Testing

   • Test
     Tests if the bot is responsive, disabled by default (run Cog_Load Commands.$Disabled.Test to load this command.).

2. Configuration

   • Config
     Configures a property within a given JSON file.
     Args: "module", "property", "value", "file" (Optional). A list can be provided at each stage, pass "*" if module only.

3. Cogs

   • Cog_Load
     Loads all cogs or loads a given cog.
     Args: "*Cog" - Cog is the cog to load, referenced via "Commands.{Cog}" (EG: "Commands.Help"). "*" may be past to load all cogs.

   • Cog_Reload
     Reloads all cogs or reloads a given cog.
     Args: "*Cog" - Cog is the cog to load, referenced via "Commands.{Cog}" (EG: "Commands.Help"). "*" may be past to reload all cogs.

   • Cog_Unload
     Unloads all cogs or unloads a given cog.
     Args: "*Cog" - Cog is the cog to load, referenced via "Commands.{Cog}" (EG: "Commands.Help"). "*" may be past to Unload all cogs.

4. Remote Control

   • Update
     Updates the bot via this git repository
     Args: None.

   • Restart
     Restarts the bot
     Args: None.

   • Shutdown
     Causes the script to exit
     Args: None.