Skip to main content
1

Understanding the Mute System

The Mute System lets moderators temporarily silence members by applying a Muted role.
Muted members cannot send messages or create threads until the mute expires or they are unmuted.
This is a moderation tool designed for handling spam or disruptive behavior without banning or kicking users.
Bot Permissions Required:
  • Manage Roles
  • Manage Channels
  • Moderate Members
2

System Overview

When the Mute System is active, Omex automatically:
  • Creates a dedicated Muted role with restricted permissions.
  • Applies channel overrides to block muted members from chatting.
  • Logs all mute and unmute actions in a configured log channel.
  • Automatically removes mutes after their duration expires.
  • Assigns case IDs to each action for tracking in moderation logs.
3

Setting Up the Mute System

To start using the system, run the setup command:
.setupmute <#log_channel>
Description:
Creates the Muted role, sets channel permissions, and links logs to the specified channel.Setup Includes:
  • Creating a Muted role automatically.
  • Updating all channels to prevent muted users from chatting.
  • Saving the configuration in the bot’s database.
  • Sending all future mute/unmute logs to your chosen channel.
You only need to run setup once — unless the Muted role is deleted or renamed.
4

Muting a Member

Temporarily mute a user with the following command:
.mute @User [duration] [reason]
  • Description: Mutes the specified member for a set duration.
  • Example: 
    .mute @NoisyGuy 30m Spamming memes
What Happens:
  • The Muted role is added to the user.
  • The action is logged with a case ID.
  • The user will automatically be unmuted once the time expires.
5

Unmuting a Member

Remove the mute role from a member using:
.unmute @User
  • Description: Unmutes a specific member.
  • Example: 
    .unmute @NoisyGuy
What Happens:
  • The Muted role is removed.
  • A case ID is logged.
  • The member regains full chat permissions.
6

Unmuting All Members

To remove the mute role from all currently muted users:
.unmuteall
Description: Unmutes every muted member on the server.
Useful after raids or server-wide cleanups.
This action affects all muted members and cannot be undone.
A full log will be recorded in your moderation channel.
7

Limits & Best Practices

⚙️ Important Notes
  • Moderators cannot mute members with higher or equal roles.
  • The Muted role must stay below the bot’s role in the hierarchy.
  • If the Muted role is deleted, rerun: 
    .setupmute <#log_channel>
Duration Formats:
  • 5m → 5 minutes
  • 2h → 2 hours
  • 3d → 3 days
Always ensure the bot has Manage Roles and Manage Channels permissions for proper mute management.
8

Accessing the Mute System

The Mute System is available to all servers with Omex installed — no premium required.
Only users with proper permissions (like Manage Roles or Moderate Members) can use these commands.
Once configured, the system will automatically handle mutes, unmutes, and expiry — no manual tracking needed.
9

Completion

You’ve successfully set up and learned how to use the Mute System! 🎉You can now:
  • Mute disruptive members safely
  • Automatically manage mute durations
  • Keep clean and organized moderation logs