Skip to main content
The VC Role system lets you automatically assign a specific role to members as soon as they connect to any voice channel in your server. When they leave the voice channel, the role is instantly removed. This is perfect for creating “In Voice” lists or giving members access to voice-chat-only text channels while they are connected.
Required Permission: Hierarchy Status — Server Owner, Extra Owner, or a user with a role higher than the bot’s highest role.

​
Setting Up

Configuring the VC Role system is quick and easy.
1

Run the Set Command

Provide the role you want to award to members who join voice channels.
.vcrole set @In Voice
2

Verify the Configuration

Use the show command to confirm your role is set and the system is enabled.
.vcrole show
For security, ZEON blocks you from assigning roles that have dangerous permissions (Administrator, Manage Server, etc.). The bot will also refuse to manage a role that is equal to or higher than its own top role, or yours.

​
Commands

All commands are located under the .vcrole (or .voicerole) group.
CommandDescription
.vcrole set <role>Sets the role to be automatically given to users who join any voice channel.
.vcrole showShows the currently configured VC role and whether the system is enabled.
.vcrole resetDeletes the VC role configuration from the server.
.vcrole enableEnables the VC role system without needing to reconfigure the role.
.vcrole disablePauses the VC role system (roles will no longer be assigned/removed).

​
How It Works

  • Instant Assignment: ZEON uses high-speed Redis caching to detect voice state updates instantly, assigning the role the moment a user connects.
  • Auto-Cleanup: If the assigned VC role is deleted from the server, ZEON automatically deletes the VC role configuration to prevent errors.
  • Bot Ignored: The VC Role system ignores bots, meaning other bots in your server will not trigger role assignments.