Berend Botje

Dashboard coming soon!

Feature requests are welcome, join the discord!

At first just written for our own server to replace other bots or add on functionality already in discord. Now better tested and running stable on our server for a while. I am still actively working on the bot and feature requests are more than welcome. Majority of the features in the current version are requested by users or something we found useful in our server that could not be done with discord itself.

A short list of functionality, more detailed info below.

• Extensive role and permissions system
• Leveling by sending messages or hanging out in voice with role rewards
• Role rewards based on how long you are in the server
• Send reminders with interval and custom message to channels
• Custom welcome messages, custom level up messages, custom mention messages
• Extensive bot config where all features can be toggled and values changed
• Enable / Disable server invites completely
• User config per guild
• Extensive logging with ability to enable/disable each individual event -Automatic timeout detection with easier overview (better than audit log)
• Assign roles to users when they join the server
• Reminder for our Question of the Day channel (Tag a role when somebody posts a question)
• Cringe counter which users can increase and decrease to keep track who is being most cringe!
• A bunch of other small commands like retrieving info from urban dictionary
• Moderator statistics to have a funny overview who kicks/bans/mutes the most.

Roles and permissions

The bot uses a permissions and role system. Permissions are coded into the bot and available for you to assign to as many roles as you like, those roles can be assigned to as many users as you like. Users can also have multiple roles.

Permissions

View Roles Create role, Delete role, Update role, Permissions, Update permission from role, Update roles from user,Manage the config, Manage timeouts, Media filter, Increase cringe counter, Decrease cringe counter, Manage custom commands, Manage reactions, Manage rewards, Manage xp for users, Manage channel flags, Manage log config, Add mention replies, Remove mention replies, Manage reply groups,Manage blacklist, Manage server invites, Manage custom messages

Default Roles

• Admin View Roles Create role, Delete role, Update role, Permissions, Update permission from role, Update roles from user, Manage the config, Manage timeouts, Media filter, Increase cringe counter, Decrease cringe counter, Manage custom commands, Manage reactions, Manage rewards, Manage xp for users, Manage channel flags, Manage log config, Add mention replies, Remove mention replies, Manage reply groups, Manage blacklist, Manage server invites, Manage custom messages.

• Moderator Manage timeouts, Media filter, Increase cringe counter, Decrease cringe counter, Manage custom commands, Manage reactions, Manage channel flags, Add mention replies, Remove mention replies, Manage reply groups, Manage blacklist, Manage custom messages.

Commands

• roles list • Overview of all roles and their permissions
• roles add role_name • Add a new role
• roles delete role_name • Delete a role
• roles roles user_mention • See your roles or those from another user
• permissions list • Overview of all permissions
• permissions add role_name perm_name • Add permission(s) to a role
• permissions delete role_name perm_name • Remove permission(s) from a role
• users list • Overview of all users and their roles
• users add user_mention role_name • Add user to the given role
• users delete user_mention role_name • Remove user from given role";

Levels and XP

If enabled users can gain xp by sending messages and hanging out in voice. Check the Bot config section below for more control how much xp people gain per message, per minute in voice and if you want to enable this functionality at all. It is possible to attach role rewards to levels, when a user reaches that specific level a new role is granted.

For gaining xp in voice we have two extra rules:

• Muted users (either mic muted or both) do not gain XP.
• Users in a voice channel marked as no_xp will not gain XP.

More on how to set the no_xp flag to a channel later.

Calculating Levels

This is what I use to calculate required XP for each level: 5 * (lvl ^ 2) + (50 * lvl) + 100 - xp it is the exact same XP system as MEE6 uses. You can read more here -> https://github.com/Mee6/Mee6-documentation/blob/master/docs/levels_xp.md

Commands

• xp leaderboard • Show the leaderboard with the highest ranking members at the top
• xp rank user_mention • Show your own level, xp and messages or that of another user
• xp give user_mention xp_amount • Give user xp
• xp remove user_mention xp_amount • Remove user xp
• xp reset user_mention • Reset XP for user
• rolerewards list • Show the role rewards for different levels
• rolerewards add level role_id • Add a role reward to a level
• rolerewards delete level • Delete role rewards from this level";

Role rewards based on how long you are in the server

You can add role rewards based on how long people are in the server. Some duration examples:

• 1y2m3d - One year, two months and three days
• 4m - Four months
• 1y1d - One year and one day

Commands

• rewards duration list
• rewards duration add <duration> <role>
• rewards duration delete <duration>
• rewards duration sync

Bot Config

The bot loads a config from the settings table which can be viewed and changed, it allows only integer values! So when setting channels or roles make sure to use the IDS.

• config guid list
• config guild edit setting_name new_value

Settings

• xp_count - xp gained per message
• xp_cooldown - seconds cooldown after last message before it counts again
• xp_voice_count - xp gained in voice
• xp_voice_cooldown - cooldown for xp gain in voice
• enable_xp - enable the message xp system
• enable_voice_xp - enable the voice xp system
• enable_emote_counter - enable emote counters
• enable_role_rewards - enable role rewards for gaining levels
• enable_bump_counter - enable bump counter
• enable_reactions - enable custom reactions
• enable_commands - enable custom commands
• enable_logging - enable general logging
• enable_mention_responder - Enable the responses when you mention the bot
• enable_qotd_reminder - Enable the role mention in set question of the day channel
• enable_join_role - Enables giving users a role when they join the server
• enable_welcome_msg - Enable the welcome message
• enable_lvl_msg - Enable level up message
• enable_bump_reminder - enable reminder tag
• enable_count - Enable the counting channel
• bump_channel - Channel where the bump reminders are tagged
• qotd_channel - Channel to tag qotd role
• count_channel - Counting channel ID
• welcome_msg_channel - Channel to welcome user
• level_up_channel - Channel to send level up messages
• log_channel_id - set the channel ID where the log sends messages
• bump_reminder_role - Role to be tagged for bump reminders
• qotd_role - Role to tag in qotd channel
• join_role - Actual role to give when a user joins the server
• current_count - Current counter for counting channel

User config

Users have their own settings per guild. For now, I only use a single setting but more to come soon.

• no_role_rewards - Disables gaining role rewards based on levels (if the guild has it enabled)

You can use the following commands to view/change your own settings:

• config user list - Show your config
• config user edit <setting_key> <setting_value> - Update a value in your user config

Logging

The bot is able to log some events to a specific log channel, you have to set the following two settings properly in the bot config to make it work:

• enable_logging - Enable the general log
• log_channel_id - Id of the channel where the log sends messages

Events

I pretty much copied the way MEE6 logs events, it looks the same but it logs more and there is no delay. Not sure why MEE6 is sometimes so laggy.

The following events are logged:

• Joined server
• Left server
• Kicked from server
• Banned from server
• Unbanned from server
• Received timeout
• Joined voice call
• Left voice call
• Switched voice call
• Muted in voice by moderator
• Unmuted in voice by moderator
• Updated username
• Message updated
• Message deleted
• Invite created
• Invite removed
• Started streaming in voice
• Stopped streaming in voice
• Enabled his webcam in voice
• Disabled his webcam in voice

You can enable/disable each event in the log config:

• config log list - Look at the log config
• config log edit key value - Enable or disable one of the events

Reminders

You can set reminders in a specific channel with a custom message! For now the reminder interval is in minutes!

• reminders list
• reminders create interval channel message
• reminders delete id

Moderation

We have some commands which can help moderate the server, or improve other things!

Timeout detection

We are not satisfied with the audit log and how timeouts are displayed and filtered. It is not easy to quickly look up how often somebody has been timed out, for what reason and how long. Every timeout is automatically saved in the database including the reason and duration. We can easily see a history of timeouts + filter timeouts only for specific users.

• timeouts list <user_mention> - All timeouts or those from a specific user
• timeouts edit <timeout_id> <new_reason>- Update the reason for a timeout
• timeouts delete <timeout_id> - Remove a timeout from the log only

Blacklist

People can be put on a blacklist manually or automatically.

• blacklist list - Show everyone on the blacklist
• blacklist block <user_mention <reason> - Add someone to the blacklist
• blacklist unblock <user_mention> - Remove someone from the blacklist

Join role

You can make sure the bot gives users a role when they join the server. In order to make it work you have to set the following settings:

• enable_join_role - Enable or disable giving the role
• join_role - ID of the actual role to give

Disable server invites

Since discord requires a "Mange server" permission to pause invites I added a simple command to do it with the bot:

• invites toggle - Enable/disable invites

Custom messages

When adding custom messages you can use the :user parameter in you message to be replaced with a tag of the user, for level up messages you can also use :level. Example:

• Welcome :user!
• Congrats :user you are now :level!

Welcome

You can add custom welcome messages to the bot. It wil pick one of the random messages and sends it in the channel set in the config.

• messages welcome list - Show list of custom level up messages
• messages welcome add <message> - Add new level up message
• messages welcome delete <message> - Delete level up message (Message is autocompleted)

Levels

You can set custom messages when users level up to a certain level. If you don't set any, a default message will be used if level up messages are enabled. When a user levels up, it checks for the highest message in the list which is not higher than that users level. Meaning if you set 2 messages, one for level 1 and one for level 10. The level 1 message will be used until that user reached level 10.

• messages levels list - Show list of custom level up messages
• messages levels add <level> <message> - Add new level up message
• messages levels delete <level> - Delete level up message

Mention Responder

Small funny feature, when you tag the bot you will get a random reply from a list of mention replies. There are default replies, but you can also add your own replies based on certain roles or users in the server.

The bot comes with some default groups and replies:

• If you have a high rank in the server (according to the xp system)
• If you are the highest person on the leaderboard (according to the xp system)
• If you bumped the discord the most (all time)
• If you bumped the discord a lot
• If you had timeouts in the past
• If you are highly ranked on the cringe counter leaderboard

You can manage all groups and their replies by using these commands:

• mention groups list - Show all groups
• mention groups add discord_role - Add a group
• mention groups delete group_id - Delete a group and its replies (!!!)
• mention replies group_id - Show all replies for a single group
• mention replies add group_id reply_line - Add a reply to a group
• mention replies delete reply_id- Delete a reply

Fun commands

A few fun commands you can use!

• fun urb search_term - Searches on urban dictionary
• fun 8ball question - Ask a question to the 8ball
• fun ask question - Ask a question and get a gif response
• fun say something - say something
• fun modstats - Who got the power?
• fun bumpcounter time-range • Check the monthly or all time bump leaderboard
• cringe add <user> - Increase someone's cringe counter
• cringe delete <user> - Decrease someone's cringe counter
• cringe reset - Reset someone's cringe counter

Bump Reminder

In order to make the bump reminder work, you need to set the following 3 settings:

• enable_bump_reminder - Enable 2 hour tag for people who want to bump the discord
• bump_reminder_role - Role to be tagged for bump reminders
• bump_channel - Channel where the bump reminders are tagged

Question of the day

In our server some people post questions every day, when they do the bot tags people who want to be reminded that a new question is posted. This way I do not have to give mention permissions which can be abused easily.

Check these settings:

• qotd_channel
• qotd_role
• enable_qotd_reminder

Help command

You can write /help on discord to get information on most commands in the bot and explanation how they work. You can pick your section from the list and get more info.

That's it for now! Enjoy! :)