<div class="main" style="padding:30px 30px">
  <div style="width:100%;text-align:center">
    <h1>Say hi to Vivi! The kind but smug siren.</h1>
  </div>

<hr>
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.
<hr>

  <p>Vivi is a moderation bot (inspired by Luca from the DBL server!) made to help servers efficiently and easily moderate themselves!</p>

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)
```
  <br>
  <div style="width:100%;text-align:center">
    <h1>Your servers default configuration</h1>
  </div>
  <hr style="border: 1px solid grey;background-color:grey;width:100%">

  <div style="display:flex;padding-top:30px;">
	  <div style="widtH:70%">
      <div style="width: 95%">
        <strong>
          Vivi comes with default settings (seen to the right) which can be changed by any user that has <span style="color:red">MANAGE_GUILD</span> 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.
        </strong>
      </div>
      <div style="display:flex;padding-top:120px;width:95%">
        <img style="border-radius:10px;height:150px;" src="https://media.discordapp.net/attachments/773580650255089675/774421495702356038/unknown.png"/>
      </div>
    </div>
    <div>
      <img style="border-radius:10px;height:300px" src="https://media.discordapp.net/attachments/773580650255089675/774420822643179520/unknown.png"/>
  <strong style="padding-left:22px">Config settings are easily setup through command lines and can be changed at any time.
</strong>
  	</div>
  </div>
  <div style="width:100%;text-align:center;padding-top:20px">
    <h1>The basics</h1>
  </div>
  <hr style="border: 1px solid grey;background-color:grey;width:100%">
  <div style="display:flex;padding-top:30px;flex-direction:column">
  	<strong>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.</strong>
  	<div style="margin:0;">
      <div class="basics" style="display:flex;top:15%;align-items: center;padding:10px 0">
        <img style="border-radius:10px" src="https://media.discordapp.net/attachments/733160959954386986/773583167051137034/unknown.png"/>
        <strong style="padding-left:20px">Users can be warned, muted, kicked, or banned by either a mention or User ID (available through enabling Discord's Developer Mode).

  </strong>
      </div>
      <div class="basics" style="display:flex;top:28%;align-items: center;padding:10px 0">
        <img style="border-radius:10px" src="https://media.discordapp.net/attachments/733160959954386986/773611161039405066/unknown.png">
        <strong style="padding-left:20px">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.
</strong>
      </div>
      <div class="basics" style="display:flex;top:44%;align-items: center;padding:10px 0">
        <img style="border-radius:10px;" src="https://media.discordapp.net/attachments/739975295641321581/773582591910871069/unknown.png">
        <strong style="padding-left:20px">
          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).
        </strong>
      </div>
      <div style="display:flex;top:84%;width:50%">
        <strong>
          Warns will remain on record even if the user is no longer a member of the server. Because Vivi doesn't forget.<br><br>
          Checking a users warnings will show the time they were warned, the warn ID on the left indicated by the <span style="color: red">#</span> sign and the mod that issued the warn.
        </strong>
      </div>
      <div style="display:flex;top:94%;">
      <strong style="padding: 100px 30px">Do you want to welcome your users with a sweet calming banner? Use one of two default designs!</strong>
        <div>
        <img style="border-radius:10px;width:500px" src="https://cdn.discordapp.com/attachments/733160959954386986/828722670510145576/welcome-image.png">
        <br>
        <img style="border-radius:10px;width:500px" src="https://cdn.discordapp.com/attachments/733160959954386986/828731705689899068/welcome-image.png">
        </div>
      </div>
    </div>
  </div>
  <div style="width:100%;text-align:center;padding-top:20px">
    <h1>Mod log system and how to use it</h1>
  </div>
  <hr style="border: 1px solid grey;background-color:grey;border-radius:5px;width:100%">
  <br>
  <div style="width:100%;text-align:center;padding-bottom:10px;">
    <h3>Warnings, mod logs and changing reasons</h3>
  </div>
  <br>
  <div style="display:flex;width:90%">
    <img style="border-radius:10px;height:230px" src="https://media.discordapp.net/attachments/739975295641321581/773611955301908520/unknown.png">
    <div style="padding-left:20px">
      <strong>
        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.
      </strong><br><br>
      <p>
        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.
      </p>
    </div>
  </div>
  <div style="display:flex;width:90%;padding-top:20px;align-items:center">
    <img style="border-radius:10px;width:300px;height:100px" src="https://media.discordapp.net/attachments/739975295641321581/773691525124194314/r_u_d_e.png">
    <div style="padding-left:20px">
      <strong>For example, say a user evades Vivi's banned word filter, to which you warn them for. What if you need to provide proof?
      </strong><br>
    </div>
  </div>
  <div class="warn-reason" style="display:flex;width:90%;padding-top:20px;">
    <img style="border-radius:10px;height:200px;width:350px;" src="https://media.discordapp.net/attachments/739975295641321581/773691547489140796/proof.png"><div style="width:50px"></div>
    <img style="border-radius:10px;height:200px;width:350px;" src="https://media.discordapp.net/attachments/739975295641321581/773691575976722452/proof2.png">
  </div>
  <div style="padding-left:20px;">
      <hr style="border: 1px solid grey;background-color:grey;border-radius:5px;">
      <strong><span style="color:red">Inside your mod logs channel</span> 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.</strong>
      <hr style="border: 1px solid grey;background-color:grey;border-radius:5px;">
    </div>
  <div style="display:flex;width:90%;padding-top:20px;">
    <img style="border-radius:10px;width:333px;height:100%" src="https://media.discordapp.net/attachments/739975295641321581/773696231562149888/mute1.png">
    <div style="padding-left:20px">
      <strong>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! 
      </strong>
    </div>
  </div>
  <div style="display:flex;width:90%;padding-top:20px;">
    <img style="border-radius:10px;height:350px" src="https://media.discordapp.net/attachments/739975295641321581/773696270929494046/mute3.png">
    <div style="padding-left:20px">
      <strong>
        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.
      </strong>
    </div>
  </div>
  <div style="display:flex;width:90%;padding-top:20px;">
    <img>
    <div style="padding-left:20px">
      <strong></strong>
    </div>
  </div>
</div>
<hr style="border: 1px solid grey;background-color:grey;width:100%"><br>
<img src="https://media.discordapp.net/attachments/739975295641321581/774191295924142100/vivi_commands.png">

<div class="mobile" style="display:none">
  <h2>Hey! On mobile? My page is best experienced on desktop so that you can best understand how I work along with my detailed command descriptions! I hope to see you there!</h2>
</div>

<style>
@media only screen and (max-width: 600px) {
  .main { display: none; }
  .mobile { display: block !important; }
}
@media only screen and (max-width: 1200px) {
  .warn-reason {
    flex-direction: column;
  }
  img {
    padding: 10px 0;
  }
}
.commands {
  text-align:center;
}
table, th, td {
  font-family: monospace;
  text-align: left;
  border: 1px solid #2396c7;
  padding: 10px;
}
tr td:last-child {
  font-family: "Karla",BlinkMacSystemFont,-apple-system,Segoe UI,Roboto,Oxygen,Ubuntu,Cantarell,Fira Sans,Droid Sans,Helvetica Neue,Helvetica,Arial,sans-serif;;
}
</style>

<div class="commands">

# Server Configuration
<hr style="border: 1px solid grey;background-color:grey;width:100%">

`<>` = required arguments | `[]` = optional arguments
<table style="width:100%">
  <col style="width:40%">
  <col style="width:35%">
  <col style="width:25%">
  <tr>
    <th>Command</th>
    <th>Examples</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>v.config</td>
    <td>v.config</td>
    <td>Show the configuration for the server.</td>
  </tr>
  <tr>
    <td>v.config prefix &lt;new prefix&gt;</td>
    <td>v.config prefix !</td>
    <td>Change the servers prefix.</td>
  </tr>
  <tr>
    <td>v.config join &lt;add | remove | list&gt; &lt;name | id&gt;</td>
    <td>v.config join add 781062380934266901<br>
      v.config join add Member<br>
      v.config join remove 781062380934266901<br>
      v.config join list
    </td>
    <td>Add or remove a role that will be given to any user that joins the server. You can view the roles being given out with the list option.</td>
  </tr>
  <tr>
    <td>v.config word &lt;add | delete&gt; &lt;word&gt;</td>
    <td>v.config word delete uwu<br>v.config word delete owo, 0w0, o3o<br>v.config word add uwu<br>v.config word add owo, 0w0, o3o</td>
    <td>Add or delete a word or list of words for the banned words filter list.</td>
  </tr>
  <tr>
    <td>v.config banmsg &lt;msg sent to banned users&gt;</td>
    <td>v.config banmsg You've been bad! Get out!</td>
    <td>Set the message that gets sent to users right before they're banned.</td>
  </tr>
  <tr>
    <td>v.config logs &lt;mod | server&gt; &lt;#channel | ID&gt;</td>
    <td>v.config logs mod #mod-logs<br>v.config logs mod 773580650255089675<br>v.config logs server #server-logs</td>
    <td>Set specific log channels</td>
  </tr>
  <tr>
    <td>v.config mute &lt;@role | id | none&gt;</td>
    <td>v.config mute @Muted<br>v.config mute 750488381070245949<br>v.config mute none</td>
    <td>Set the mute role for Vivi to use. If you use 'none' then Vivi will remove it from the config.</td>
  </tr>
  <tr>
    <td>v.config warnexpire &lt;# days in range 1-30&gt;</td>
    <td>v.config warnexpire 5</td>
    <td>Set how long it takes for a users warn to expire and no longer be considered as a bannable offence.</td>
  </tr>
  <tr>
    <td>v.config maxwarns &lt;# in range 1-10&gt;</td>
    <td>v.config maxwarns 5</td>
    <td>Set how many active warns a user is allowed to have, their next warn would be their ban.</td>
  </tr>
  <tr>
    <td>v.config whitelist &lt;add | remove&gt; &lt;#channel | ID&gt;</td>
    <td>v.config whitelist add #mod-chat<br>v.config whitelist remove #general<br>v.config whitelist add 773580650255089675</td>
    <td>Whitelist channels you don't want Vivi keeping server logs of.</td>
  </tr>
  <tr>
    <td>v.config listwords</td>
    <td>v.config listwords</td>
    <td>This will send all the banned words in a spoiler tag.</td>
  </tr>
  <tr>
    <td>v.config setup</td>
    <td>v.config setup</td>
    <td>If Vivi failed to generate your servers config run this command to fix it.<br>Can only be run once if the server doesn't have a config.</td>
  </tr>
  <tr>
    <td>v.config banner &lt;left | center&gt;</td>
    <td>v.config banner center<br>v.config banner left</td>
    <td>Display Vivi's welcome banners! There are currently only two default ones. A left avatar, or a center avatar.</td>
  </tr>
  <tr>
    <td>v.config welcome &lt;add | remove&gt; &lt;#channel | channel-id&gt;</td>
    <td>v.config welcome add #welcome<br>v.config welcome add 773580650255089675<br>v.config welcome remove</td>
    <td><span style="color:red">By default vivi doesn't have a welcome channel for you.</span> You use this command to tell Vivi which channel to use when welcoming users with a banner.</td>
  </tr>
</table>

<br>

# Moderation Commands
<hr style="border: 1px solid grey;background-color:grey;width:100%">

`<>` = required arguments | `[]` = optional arguments

<table style="width:100%">
  <col style="width:35%">
  <col style="width:30%">
  <col style="width:35%">
  <tr>
    <th>Command</th>
    <th>Examples</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>v.ban &lt;@user | ID&gt; &lt;reason&gt;</td>
    <td>v.ban @Panku For being stinky<br>v.ban 125492204234997761 Was rude to me</td>
    <td>Ban a user by mention or ID</td>
  </tr>
  <tr>
    <td>v.checkwarns &lt;@user | ID&gt; [active]</td>
    <td>v.checkwarns @Panku<br>v.cw @Panku active</td>
    <td>Check a users warning history. If you want to view only their active warns pass active after mention/ID.<br>Use a user id to get warn history even after the user is gone!</td>
  </tr>
  <tr>
    <td>v.kick &lt;@user | ID&gt; &lt;reason&gt;</td>
    <td>v.kick @Panku Get out!<br>v.k @Panku Cya punk.</td>
    <td>Kick a user from the server.</td>
  </tr>
  <tr>
    <td>v.mute &lt;@user | ID&gt; &lt;reason&gt; | &lt;#[(m)inutes/(h)ours/(d)ays/(w)eeks/(y)ears]&gt;</td>
    <td>v.mute @Panku Annoying users in VC | 3d<br>v.mute @Panku Disruptive | 1d</td>
    <td>Mute a user for any given time. If you don't pass a time the user will be default muted for an hour.</td>
  </tr>
  <tr>
    <td>v.purge &lt;# of messages&gt;</td>
    <td>v.purge 10</td>
    <td>Class purge messages command.</td>
  </tr>
  <tr>
    <td>v.reason &lt;case ID&gt; &lt;new reason&gt; [ | &lt;#[(h)ours/(d)ays/(w)eeks/(m)onths/(y)ears]&gt; ]</td>
    <td>v.reason 12 Making users uncomfortable<br>v.reason 12 Disruptive in VC! | 3d<br>v.r 12 Changing warn reason!!</td>
    <td><span style="color:red">This command can only be ran in the configured mod-logs channel.</span> It allows you to reword mod logs(cases). You get the requried case id from the message embeds.<br>If you need to change a mute duration you can do that too by using the same time format as the mute command.</td>
  </tr>
  <tr>
    <td>v.say [#channel] &lt;words to say&gt;</td>
    <td>v.say #announcements New update incoming!<br>v.say Hey guys!</td>
    <td>Basic say command, if given a channel (anywhere in the command) Vivi will send the message there.</td>
  </tr>
  <tr>
    <td>v.unban &lt;ID&gt; &lt;reason&gt;</td>
    <td>v.unban 125492204234997761 Appealed their ban!</td>
    <td>Classic unban command.</td>
  </tr>
  <tr>
    <td>v.unmute &lt;@user | ID&gt; &lt;reason&gt;</td>
    <td>v.unmute @Panku Apologized for being loud in VC.</td>
    <td>Unmute a muted user.</td>
  </tr>
  <tr>
    <td>v.unwarn &lt;warn ID&gt; &lt;reason&gt;</td>
    <td>v.unwarn 1337 Was a mistake</td>
    <td>Remove a warn offence from a users warnings. Get its ID from v.checkwarns command.</td>
  </tr>
  <tr>
    <td>v.warn &lt;@user | ID&gt; &lt;reason&gt;</td>
    <td>v.warn @Panku Not listening after verbal warning</td>
    <td>Warn a user to kep track of their warnings. Check their current warnings with v.checkwarns. If a user surpasses the servers max warns setting they get automatically banned.</td>
  </tr>
</table>

<br>

# General Commands
<hr style="border: 1px solid grey;background-color:grey;width:100%">

`<>` = required arguments | `[]` = optional arguments

<table style="width:100%">
  <col style="width:35%">
  <col style="width:30%">
  <col style="width:35%">
  <tr>
    <th>Command</th>
    <th>Examples</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>v.avatar [@user | id]</td>
    <td>v.avatar<br>v.ava<br>v.avatar @Panku<br>v.avatar 125492204234997761</td>
    <td>Grab a users avatar. Command alias is 'ava'. If no user ID is given or user mentioned it'll send your avatar!</td>
  </tr>
  <tr>
    <td>v.botstatus</td>
    <td>v.botstatus</td>
    <td>Sends general info about how manyt servers the bot'sF in.</td>
  </tr>
  <tr>
    <td>v.help [config | mod | general]</td>
    <td>v.help<br>v.help general</td>
    <td>Given one of the 3 arguments Vivi will give you detailed commands for each category.</td>
  </tr>
  <tr>
    <td>v.status</td>
    <td>v.status</td>
    <td>Basic info about the server.</td>
  </tr>
  <tr>
    <td>v.userinfo [@user | ID]</td>
    <td>v.userinfo @Panku<br>v.userinfo 125492204234997761</td>
    <td>Get info for a users account along with how many warnings they have and a list of the active warns.</td>
  </tr>
</table>
</div>

Vivi

Unique moderation/server logging system that incorporates moderation warnings. Auto Join roles.

Voting for Vivi

Do you want to support us?