Say hi to Vivi! The kind but smug siren.
Hi, my name is Vivi - a siren as pretty as can be - and I'm your server's new moderation bot! With automatic server logging, private notifications to users, and customizable levels of punishment, I easily outclass any other moderation bot in functionality, usability, stability, and adorability.
And Discord's default moderation tools? Psssh, I ate Wumpus on the way over here.
Vivi is a moderation bot (inspired by Luca from the DBL server!) made to help servers efficiently and easily moderate themselves!
Benefits include:
Moderation Logs
Vivi automatically logs any moderator actions made to a designated text channel, separate to Discord's internal moderation tools.
This easily accessible and searchable record allows your server staff to:
-Easily browse previous moderator actions
-Add/Edit reasons for actions with case numbers automatically applied to each moderator action
-See when mutes on users have expired
Server Logs
Vivi will automatically log and record any message made on a publicly accessible channel in your Discord, which includes:
-Message creation
-Message editing
-Message deletion
Easy Bot Customization
Vivi can be customized to your server's specific needs, all with simple configure commands that those with guild manage permissions.
These changes include:
-Bot prefix for commands
-Warn expiration time in days
-Maximum warns allowed before a user is automatically banned by the bot
-Custom ban messages
-Server log channel
-Moderation log channel
-Whitelisted channels (will not be logged by Vivi)
Your servers default configuration
Vivi comes with default settings (seen to the right) which can be changed by any user that has MANAGE_GUILD permissions, to ensure that only trusted individuals are allowed access into Vivi's high level permissions. Vivi is easily configured with command lines to change her log channels, maximum warns allowed before automatic banning, ban message, and guild prefix.
Config settings are easily setup through command lines and can be changed at any time.
The basics
Vivi will automatically log any messages sent, edited, and deleted on non-whitelisted channels (Vivi will also attempt to cache any images or videos attached to messages). Each log will provide the user's Discord tag, the time and date of posting, which text channel the message was posted in, and provides a hyperlink to easily jump to the logged message.
Users can be warned, muted, kicked, or banned by either a mention or User ID (available through enabling Discord's Developer Mode).
When mod action is made against a user, that user will receive a DM (if they allow DMs) of the action and the provided reason. If this reason is updated by a moderator the user will also be updated via DM.
Warn histories for specific users can be checked with a mention/User ID. A ✅ emote states that a warn is still active and a ❌ emote states that a warn has expired. Expired warns do not count towards the server's configured maximum warns allowed, but will remain listed (unless removed).
Users can be warned, muted, kicked, or banned by either a mention or User ID (available through enabling Discord's Developer Mode).
When mod action is made against a user, that user will receive a DM (if they allow DMs) of the action and the provided reason. If this reason is updated by a moderator the user will also be updated via DM.
Warn histories for specific users can be checked with a mention/User ID. A ✅ emote states that a warn is still active and a ❌ emote states that a warn has expired. Expired warns do not count towards the server's configured maximum warns allowed, but will remain listed (unless removed).
Warns will remain on record even if the user is no longer a member of the server. Because Vivi doesn't forget.
Checking a users warnings will show the time they were warned, the warn ID on the left indicated by the # sign and the mod that issued the warn.
Checking a users warnings will show the time they were warned, the warn ID on the left indicated by the # sign and the mod that issued the warn.
Do you want to welcome your users with a sweet calming banner? Use one of two default designs!
Mod log system and how to use it
Warnings, mod logs and changing reasons
Vivi's greatest power lies within her ability to automatically log any moderator actions made with her. The moderator log lists what action was taken, the time and date of the action, the user affected, the moderator that issued it, and an associated "Case ID" which is used to either edit the reasons of an action or remove it. This allows your server moderators to record evidence of server misdeeds for easy viewing by both other moderators and the affected user.
All mods logs(cases) will show the type in the top left of the embed. The user that is being acted on and the moderator that carried out that action.
For example, say a user evades Vivi's banned word filter, to which you warn them for. What if you need to provide proof?
Inside your mod logs channel you can easily edit any reason for an existing action through its Case ID (the number indicated by the # sign in the moderator logs). It's recommended to use to free image hosting site to easily show evidence to both other moderators and affected users.
If someone is continuing to be a nuisance on your server even after you warn them, slap a mute down and shut them up real quick! My mute system applies a server role to users that - after setting up your mute permissions - will not only keep people from messaging in channels, but also removes their access to the channels entirely!
It’s just like a temporary ban! No more reaction spamming from muted users!
The default mute time is an hour, but mod commands will let you specify the time in minutes, hours, or days. Users will be notified of their mute, the reason, and the duration. My moderation logs also records when mutes expire for easy reference.
