โ“ Frequently Asked Questions

Everything you wanted to know about MOD_BOT

Total questions: 24

๐Ÿค–

How do I add the bot to my server?

โ–ผ

Click the "Invite Bot" button on the home page. Then select your server and grant the necessary permissions.

๐Ÿ’ฐ

Is the bot free?

โ–ผ

โœ… Yes, the bot is completely free. All features are available without restrictions.

๐Ÿ”‘

What permissions does the bot need?

โ–ผ

The bot requires the following permissions:

  • Manage Roles โ€” to assign/remove roles
  • Moderate Members โ€” for temporary restrictions
  • Manage Messages โ€” for clearing messages
  • Ban Members โ€” for banning and viewing ban list
  • Manage Channels โ€” for creating ticket channels
  • Send Messages โ€” to send messages
  • Embed Links โ€” for rich embedded messages
โฑ๏ธ

How do I remove a punishment?

โ–ผ

Use these commands to remove punishments:

  • /unmute @user โ€” remove text mute
  • /vcunmute @user โ€” remove voice mute
  • /unban @user โ€” remove ban
  • /untempban @user โ€” remove temporary ban
  • /unwarn @user โ€” remove warning
๐Ÿงน

How do I clear many messages at once?

โ–ผ

Use the /clear command โ€” it deletes 1 to 100 messages at a time.

Available parameters:

  • amount: 50 โ€” number of messages (1-100)
  • member: @user โ€” delete only their messages
  • contains: text โ€” delete only messages containing the text
  • bots_only: True โ€” only bot messages

โš ๏ธ Requires the Manage Messages permission.

๐Ÿ”จ

How do I view the ban list?

โ–ผ

Use the /banlist command โ€” it shows all banned users on the server.

For each user it displays:

  • ๐Ÿ‘ค Name and ID
  • ๐Ÿ“Œ Ban reason
  • ๐Ÿ‘ฎ Who issued the ban

๐Ÿ’ก The list is paginated โ€” use the buttons to navigate.

๐Ÿ—‘๏ธ

Can I delete a user's messages when banning?

โ–ผ

Yes! When using /ban, you can specify the delete_days parameter:

  • delete_days: 0 โ€” don't delete messages (default)
  • delete_days: 1 โ€” delete from the last 24 hours
  • delete_days: 7 โ€” delete from the last 7 days

๐Ÿ’ก Useful when banning spammers โ€” instantly clears their message history.

๐Ÿ”Š

How do I voice mute a user?

โ–ผ

Use the /vcmute command for voice mutes:

  • /vcmute @user 10m "Reason" โ€” mute for 10 minutes
  • /vcmute @user 1h "Reason" โ€” mute for 1 hour
  • /vcmute @user "Reason" โ€” permanent mute

Features:

  • โœ… Automatic removal โ€” mute expires automatically
  • ๐Ÿ”„ Database storage โ€” timers restore after bot restart
  • ๐Ÿ“Š Statistics tracking โ€” voice mutes shown in /stats and /history

โš ๏ธ Requires Mute Members permission.

๐Ÿ“œ

Where can I view my voice mute history?

โ–ผ

Use the /history @user command:

  • In "Active punishments" โ€” if a voice mute is active, the remaining time will be shown
  • In "Violation history" โ€” all voice mutes, including removed and expired ones

Also, /stats shows the number of active voice mutes and how many were issued during the selected period.

๐ŸŽ‚

How do I set my birthday?

โ–ผ

Use the /birthday command and provide the day and month:

  • action: set โ€” set birthday
  • day: 15 โ€” day (1-31)
  • month: 6 โ€” month (1-12)
  • year: 1995 โ€” year (optional)

The bot will automatically wish you a happy birthday on that day!

๐Ÿ“…

How do I find out whose birthday is coming up?

โ–ผ

Use the /birthdays command with the period parameter:

  • today โ€” today
  • week โ€” this week
  • month โ€” this month
  • all โ€” all birthdays
โš™๏ธ

How do I set up birthday greetings (channel and role)?

โ–ผ

Administrator permissions are required:

  • /birthday_channel #channel โ€” set the greeting channel
  • /birthday_role @role โ€” set the role to mention
  • /birthday_role without a role โ€” remove the setting

๐Ÿ’ก Tip: create a dedicated role ๐ŸŽ‚ Birthdays and channel #greetings.

๐Ÿ”’

Who can see my birthday?

โ–ผ

Your birthday is visible only to:

  • You โ€” via the /birthday command
  • Server members โ€” via /birthdays (only day and month, no year)
  • The bot โ€” for automatically sending the greeting

๐Ÿ”’ The birth year is not shown publicly.

๐Ÿ›ก๏ธ

Can I remove someone else's birthday?

โ–ผ

Yes, but only server administrators can. Use the command:

  • /birthday_admin_remove @user โ€” remove a member's birthday

โš ๏ธ The command is available only to users with server management permissions.

โณ

Why isn't the /birthday command working?

โ–ผ

You've most likely hit the data change limit.

The /birthday commands (set, update, delete) can be used only once per hour. This protects against accidental multiple changes and spam.

If you try to use the command earlier, the bot will show the remaining time until the next attempt. Just wait.

๐ŸŽซ

How do I open a ticket?

โ–ผ

Find the message with the ticket panel (created by an administrator via /ticket_panel) and click the ๐ŸŽซ Open Ticket button.

Then:

  • Fill in the modal โ€” describe your issue
  • A private channel will be created, accessible only to you and moderators
  • Describe your problem โ€” moderators will respond

โš ๏ธ One user = one open ticket. You cannot open a second one until you close the first.

๐Ÿ”’

How do I close a ticket?

โ–ผ

There are two ways:

๐Ÿ‘ค By the user:

  • Click the ๐Ÿ”’ Close (User) button in the ticket channel
  • Confirm the closure
  • The channel will be hidden from you, but moderators will still see it

๐Ÿ›ก๏ธ By the moderator:

  • Click ๐Ÿ—‘๏ธ Close (Staff)
  • The reason is optional โ€” you can close without it
  • The ticket is fully deleted after 3 seconds
  • A TXT and HTML transcript (chat log) is generated
๐Ÿ“œ

Where can I find the ticket history?

โ–ผ

Moderators can use the /ticket_history command โ€” it shows all server tickets.

Features:

  • ๐Ÿ“„ Pagination โ€” 5 tickets per page
  • ๐ŸŸข Open filter โ€” only open tickets
  • ๐Ÿ”ด Closed filter โ€” only closed tickets
  • ๐Ÿ“‹ All filter โ€” all tickets

Each ticket displays: number, author, reason, date, who closed it.

๐Ÿ’ก Transcripts (logs) of closed tickets are sent to a special channel set via /ticket_setup. Links are protected and expire after 1 hour.

๐Ÿ”

Are ticket transcripts secure?

โ–ผ

Yes, transcripts are protected by multiple layers:

  • HMAC signature โ€” the link contains a cryptographic HMAC-SHA256 signature
  • 1-hour expiry โ€” after this, the link returns 403 Link expired
  • Can't be forged โ€” without the secret, the signature cannot be generated
  • Unique filenames โ€” files don't overwrite each other

โš ๏ธ Even if the link is forwarded, it will stop working after 1 hour.

๐Ÿ“

How do I set up server logs?

โ–ผ

Use the /logs_setup command โ€” it allows you to specify channels for different event types:

  • join_channel โ€” channel for member join logs
  • leave_channel โ€” channel for member leave logs
  • voice_channel โ€” channel for voice events (join/leave/mute)
  • role_channel โ€” channel for role changes

๐Ÿ’ก Flexibility: you can use one channel for everything /logs_setup join_channel:#logs leave_channel:#logs voice_channel:#logs role_channel:#logs or just the ones you need. To view current settings, use /logs_setup without parameters.

๐Ÿ›‘ Disable all: use the /logs_disable command.

๐Ÿ“œ

How do I set up message history?

โ–ผ

The bot stores message history in its database. To see notifications about deletions and edits in Discord, use:

/messagelogs_setup channel:#channel

What is stored:

  • ๐Ÿ“ All sent messages
  • ๐Ÿ—‘๏ธ Deleted messages (with who deleted them)
  • โœ๏ธ Edited messages (before / after)

โณ Retention periods: regular messages โ€” 90 days, deleted messages โ€” 7 days.

๐Ÿ—ณ๏ธ

How do I vote for the bot on Top.gg?

โ–ผ

Use the /vote command โ€” the bot will send an embed with a button linking to Top.gg.

After voting, you'll automatically receive the Voter role ๐ŸŽญ on our server.

โฐ You can vote once every 12 hours.

โœ…

How do I check if I've voted for the bot?

โ–ผ

Use the /checkvote command โ€” the bot will show your current voting status.

Possible responses:

  • โœ… You've Voted! โ€” you've already voted, role is active
  • โŒ No Vote Found โ€” you haven't voted yet, use /vote
๐ŸŸก

What is the difference between stop words and banned words?

โ–ผ

We divided the filters into two independent lists:

  • ๐ŸŸก Stop words โ€” the bot does not delete the message, but simply sends a notification to the log channel (to record insults, controversial phrases). The moderator decides what to do.
  • ๐Ÿ”ด Banned words โ€” the bot instantly deletes the message and logs it (for ads, scams, @everyone, @here).
๐Ÿšซ

How do I add words to the filter?

โ–ผ

Use the respective commands:

  • /stopwords_add words:word1, word2 โ€” add stop words
  • /bannedwords_add words:word1, word2 โ€” add banned words

๐Ÿ’ก Tip: you can add the root of a word (e.g., scam), and the bot will catch all related words (scammer, scamming).

โš™๏ธ

How do I set up notification channels?

โ–ผ

Use the /stopwords_setup command:

/stopwords_setup stopwords_channel:#stop-logs banned_words_channel:#banned-logs

๐Ÿ’ก You can specify the same channel for both types if it's more convenient.

โš™๏ธ

How do I get server or role information?

โ–ผ

Use the utility commands:

  • /serverinfo โ€” full server information
  • /roleinfo @role โ€” details about a specific role
  • /channelinfo #channel โ€” information about a channel
๐Ÿ“ข

How do I make a beautiful announcement?

โ–ผ

You have two options:

  • /announce โ€” quick announcement in the channel (headline, text, ping, image).
  • /embed_create โ€” interactive builder with live preview, buttons, and modal windows.

๐Ÿ’ก ะ’ /announce you can add a ping in a spoiler โ€” the mention is hidden until you click, but the notification comes right away.

๐ŸŒค๏ธ

How do I check the weather in Discord?

โ–ผ

Use the weather commands:

  • /weather city:Moscow โ€” current weather
  • /forecast city:London โ€” 5-day forecast
  • /air_quality city:Tokyo โ€” air quality (AQI)

๐Ÿ’ก If you save your city via /set_my_city, you can use /weather without parameters.

๐ŸŒ

How do I translate a message in one click?

โ–ผ

The fastest way is to right-click on a message โ†’ Apps โ†’ ๐ŸŒ Translate this message.

You can also use /translate text:"..." or reply to a message with /translate.

โš ๏ธ You must first set your target language via /set_my_language.

๐ŸŽฎ

Where can I get help?

โ–ผ

You can join our support server.

Also available:

๐Ÿ”

Nothing found

Try changing your search query