Moderation Suite

Plugins: /plugins/moderation.py & /plugins/jail.py

If logging is enabled, !ban and !warn will be posted to the mod-log channel you set with the !set* commands.

• Config
• Utilities
• Warnings
• Ban System
• Jail Subsystem

Config

Command	Arguments	Permissions	Description
!setrole	roleID	Owner	Set role id's for jailed, submod, mod, op, admin and root.
!setchannel	channelID	Owner	Set channel/category id's for joinlog, modlog, logs, ticketlog, jaillog, mod_channel, ticket_category, jail_category and mod_category.
!elevation	on:off	Owner	This command enables/disables the !op command and op/root roles.

Utilities

Command	Arguments	Permissions	Description
!whois	[user:id]	Everyone	Pulls up a users data sheet. If no argument is provided, it'll self whois the author of the message.
!op		Mod, Admin	This command grants elevated perms (mod -> op & admin -> root). If elevation is enabled, this command must always be activated in chat to run some commands (ex: !ban). Clang will warn you about this if you're missing perms.
!purge	user:id, amount	Mod, Admin	Purges up to 100 messages from a user in the channel the command is run.
!slowmode	time:off	Submod, Mod, Admin	Alias: !slow - Accepts seconds, minutes, hours. Use 0 or off to disable.
!timeout	user:id, time:off	Submod, Mod, Admin	Alias: !mute - Times a user out for the specified amount of time and dm's them the reason.

Warnings

The warning system is meant as a general note taking and verbose warning system for staff. Clang has no implementation to automatically ban upon reaching a warning threshold, and there are no built in guidelines for how warnings should be used.

Command	Arguments	Permissions	Description
!warn	user:id, reason	Submod, Mod, Admin	Adds a note to the supplied users account and dm's them the warning. Skip the dm with !silentwarn.
!delwarn	user:id, id	Mod, Admin	Deletes a warning with the id provided.
!clear	user:id	Mod, Admin	Removes all warnings from a user.

Ban System

Command	Arguments	Permissions	Description
!ban	user:id, time, reason	Mod, Admin	Bans a user from the server in or out of the server (dependent on id). A ban reason is mandatory, and if no time is provided, ie !ban clang ban reason, it will default to permanent. A !ban will automatically add to the users warn history.
!purgeban	user:id, [reason]	Mod, Admin	Reason is optional. Runs discord's built in message deletion ban and deletes up to 7 days of messages.
!unban	user:id, reason	Mod, Admin	Unbans the user from the server. Does not dm or alert them in any way.

Jail Subsystem

The jail subsystem is a little janky and can be a little confusing. Its purpose is to create a private channel for a user (or multiple users) and lock them out of the rest of the server, hence the name jail. It's useful for forcing a private discussions where a ticket wouldn't be appropriate.

You do not need to supply a #channel in its command, but ommitting it will instead have Clang contextually rely on the channel the command is run in.

This plugin can be completely disabled by removing it from /plugins

Command	Arguments	Permissions	Description
!jail	<@user(s)...>, [#channel]	Mod, Admin	Can accept multiple users. Throws the user(s) in a private room to talk with staff and disables their access to every other channel.
!release	user:all, [#channel]	Mod, Admin	Releases one or all users from the current jail. Useful if you still want to make additional comments in the jail after all users are free to go.
!close	[#channel]	Mod, Admin	Releases all users and closes the current jail.