Admin
Voice Roles
Manage roles that automatically control users in voice channels. Disconnect, mute, deafen, or move members based on their roles.
Subcommand Groups
disconnect
Auto-disconnect users with a specific role from voice
mute
Auto-mute users with a specific role in voice
deafen
Auto-deafen users with a specific role in voice
move
Auto-move users with a specific role to a target channel
Each group has add, remove, and list subcommands.
Usage Examples
Auto-disconnect users with a role:
/voice-roles disconnect add role:@Banned-VC
/voice-roles disconnect remove role:@Banned-VC
/voice-roles disconnect listAuto-mute users with a role:
/voice-roles mute add role:@Muted
/voice-roles mute remove role:@Muted
/voice-roles mute listAuto-deafen users with a role:
/voice-roles deafen add role:@Deafened
/voice-roles deafen remove role:@Deafened
/voice-roles deafen listAuto-move users with a role to a channel:
/voice-roles move add role:@AFK channel:#afk-channel
/voice-roles move remove role:@AFK
/voice-roles move listPermissions Required
- Manage Roles — Required to configure voice roles
- Move Members — Required for the bot to move users
- Mute Members — Required for the bot to mute/deafen users
What You'll See
Confirmation of voice role configuration. Once set up, the bot automatically applies the voice action (disconnect, mute, deafen, or move) whenever a user with the specified role joins a voice channel.
Troubleshooting
- Not working: Ensure the bot has Move Members, Mute Members, and
Deafen Members permissions.
- Role not triggering: The bot monitors role changes in real-time. Make sure the target role is correctly configured.
- Cannot add role: The bot's highest role must be above the voice control role.