HepBoat is only available to servers that meet certain criteria, please see the home page for more information about this criteria.
Servers accept that our team will only provide support for bot issues, not with setting the bot up. If you need assistance, join the support server listed above. An effort must be made to read this documentation, we will not set the bot up for you. Furthermore we reserve the right to remove your whitelist if we feel HepBoat is not right for your community.
First, the guild trying to use HepBoat will need to be on the whitelist. See the Quick Start Guide for details. If the bot is invited to a guild that is not whitelisted, it will immediately leave. If you're whitelisted but the bot leaves, please let us know in the support server.
Before inviting HepBoat, if you are not the owner, please advise the owner that the bot WILL message them with some instructions and a welcome message, just so that they are aware.
If the bot is whitelisted for your server, it will stick around and automatically set itself up, rather than having to run a command like you did in the past!
If there are any issues with the setup, it will automatically notify the admins. If HepBoat remains in the server, you are the owner, and you don't appear in the dashboard, please visit us in our support server, this is a very rare occurance and it almost always is the cause of a user error.
Your guild configuration should now be available at https://dash.hep.gg for editing.
Use the sidebar to read about each plugin, and then use the example below along with the information in the sidebar to set up your own customized HepBoat configuration.
The bot will need each plugin explicitly enabled in order to use the corresponding commands in the server.
The following are some valid configuration examples. While you can simply copy-paste these configurations to your own server's configuration and fill in the blanks for a functional HepBoat, it is highly encouraged that you read through the full documentation to understand each component and customize HepBoat to your server's needs.
web:
148359099782791168: admin # JakeyPrime - Change This
levels:
148359099782791168: 100 # Your role id or individual admin ID's
commands:
prefix: '!'
plugins:
utilities: {}
web:
148359099782791168: admin # JakeyPrime - Change This
commands:
prefix: '!'
overrides: # Custom commands hardening. See custom commands plugin page for more details.
- group: cc
out:
roles:
- 00000000000000000 # Admin
- name: cc-usr
out:
roles:
- 00000000000000000 # Admin
lockdown:
- group: cc
out:
channels: [000000000000000000] # Admin commands channel
levels:
180768265633660928: 100 # Server Admin Role Id
131682843326808064: 99 # server admin bot Role Id
274266640403791873: 60 # Senior Moderator Role Id
77190254141911040: 50 # Moderator Role Id
335114792820015106: 10 # Bot Role Id
nickname: H4PB0AT
plugins:
admin:
persist:
roles: true
role_ids: # Roles to recover after leaving and joining back
- 000000000000000000 # Muted Role
nickname: true
voice: true
Your server log
infractions:
confirm_actions: true
confirm_actions_reaction: true
mute_role: 000000000000000000 # Muted Role
hard_mute_role: 000000000000000000 # Muted Role
reason_edit_level: 100
report_channel: 535051955639418890 # Channel for reports to go to
notify:
WARN:
format: true
BAN:
format: true
TEMPMUTE:
format: true
MUTE:
format: true
TEMPBAN:
format: true
modlog:
channels:
171383278048247808: # Server Log Channel
exclude: []
mode: pretty
utilities: {}
tags: {}
web:
148359099782791168: admin # JakeyPrime # Change this
84912325282254848: editor # Alchameth # Change this
commands:
prefix: '!'
overrides: # Custom commands hardening. See custom commands plugin page for more details.
- group: cc
out:
roles:
- 00000000000000000 # Admin
- name: cc-usr
out:
roles:
- 00000000000000000 # Admin
lockdown:
- group: cc
out:
channels: [000000000000000000] # Admin commands channel
nickname: 'HepBoat'
levels:
000000000000000000: 100 # Admin ID
000000000000000000: 99 # Server admin bot role ID
000000000000000000: 60 # Senior Moderator role ID
000000000000000000: 50 # Moderator role ID
000000000000000000: 46 # AI - Bots roles ID
000000000000000000: 10 # Trusted role ID
000000000000000000: 0 # Everyone ID
plugins:
utilities: {}
admin:
persist:
roles: true
role_ids: # Roles to recover after leaving and joining back
- 000000000000000000 # Muted Role
nickname: true
voice: true
censor: # You're advised to add malicious websites under domain blacklist and racial slurs and offensive words under words & token filtering
levels:
45:
filter_zalgo: true
filter_invites: true
invites_whitelist: []
invites_blacklist: []
filter_domains: true
domains_whitelist: ['000000'] # Add gibberish to filter all domains by default
blocked_tokens: []
blocked_words: []
blocked_nicknames: []
block_zalgo_nicknames: true
spam:
levels:
45:
punishment: TEMPMUTE # Change that if you wish : "TEMPMUTE, MUTE, KICK, BAN"
punishment_duration: 300
clean: true
clean_count: 50
clean_duration: 500
channel_whitelist: [] # If you want to whitelist channels for anti-spam to not apply. You can also whitelist PER ANTI SPAM TYPE by adding "channel_whitelist: [ID] in the same column as count/interval.
max_messages:
count: 10
interval: 7
max_mentions:
count: 8
interval: 30
max_links:
count: 10
interval: 60
max_emojis:
count: 100
interval: 120
max_newlines:
count: 60
interval: 120
max_duplicates:
count: 5
interval: 30
infractions:
confirm_actions: true
confirm_actions_reaction: true
mute_role: 000000000000000000 # Muted Role
hard_mute_role: 000000000000000000 # Muted Role
reason_edit_level: 100
report_channel: 535051955639418890 # Channel for reports to go to
notify: #
WARN:
emoji: warning
format: |-
You have been **{action!s}** in **{guild.name}** by **{actor!s}** for `{reason!s}`.
TEMPMUTE:
emoji: no_mouth
format: |-
You have been **{action!s}** in **{guild.name}** by **{actor!s}** for `{reason!s}` until **{expires}** GMT+0.
MUTE:
emoji: no_mouth
format: |-
You have been **{action!s}** in **{guild.name}** by **{actor!s}** for `{reason!s}`.
TEMPBAN:
emoji: tools
format: |-
You have been **{action!s}** until **{expires} GMT+0 in **{guild.name}** by **{actor!s}** for `{reason!s}`.
BAN:
emoji: tools
format: |-
You have been **{action!s}** in **{guild.name}** by **{actor!s}** for `{reason!s}` .
KICK:
emoji: boot
format: |-
You have been **{action!s}** in **{guild.name}** by **{actor!s}** for `{reason!s}`.
modlog: # See modlog plugin documentation for more actions to explicitly include.
channels:
000000000000000000: # Message Logs
exclude: []
include:
- MESSAGE_DELETE
- MESSAGE_DELETE_BULK
- MESSAGE_EDIT
- CENSORED
timestamps: true
timezone: GMT+0
000000000000000000: # Server Logs
exclude:
- MESSAGE_DELETE
- MESSAGE_DELETE_BULK
- MESSAGE_EDIT
include: []
timestamps: true
timezone: GMT+0
000000000000000000: # User-Logs
exclude: []
include:
- GUILD_MEMBER_ADD
- GUILD_MEMBER_REMOVE
timestamps: true
timezone: GMT+0
000000000000000000: # Action-Log - Your public moderation log where the server can see actions taken.
exclude: []
include:
- MEMBER_KICK
- GUILD_BAN_ADD
- GUILD_BAN_REMOVE
- MEMBER_TEMPBAN
- MEMBER_SOFTBAN
- MEMBER_BAN
- MEMBER_MUTED
- MEMBER_TEMP_MUTED
- MEMBER_WARNED
ignored_users: []
new_member_threshold: 86400 # time in seconds
tags:
max_tag_length: 1000 # Set it as long as you want or remove
min_level_remove_others: 50 # To allow only level 50 and above to remove (in this config, moderators)