Permissions and Roles
Why a command might refuse to work, and how to fix it fast.
Every command checks two things before it runs: whether you have the right permission, and whether Ethvex has the right permission. Each command page lists both.
Why Ethvex asks for Administrator #
The invite link asks for the Administrator permission. That is purely for convenience. Ethvex has a lot of systems, and between them they need around fifteen different permissions. Administrator covers all of them at once, so every command and panel works straight away and you never hit a missing permission error while setting things up.
Ethvex only ever uses the permission a command actually needs. It does not touch anything you did not ask it to do, and every action it takes is something a member of your staff started or set up.
Administrator is optional. You can untick it when you invite Ethvex, or remove it any time later. Ethvex works fine without it, as long as its role has the permissions listed below.
Running Ethvex without Administrator #
If you prefer to give Ethvex only what it needs, you can do it while inviting the bot or afterwards.
While inviting
On the Discord invite screen, scroll through the permission list, untick Administrator, and leave the other permissions ticked.
After it is already in your server
Open the Ethvex role
Go to Server Settings → Roles and click the Ethvex role.
Turn off Administrator
Open the Permissions tab and switch Administrator off.
Turn on what Ethvex needs
Switch on the permissions from the table below for the features you use. If you are unsure, turn them all on.
Save
Press Save Changes. Ethvex keeps working with the permissions you gave it.
Without Administrator, channel overrides start to matter. If a channel blocks the Ethvex role from viewing or sending messages there, Ethvex cannot work in that channel. Give the Ethvex role access to any channel you want it to post in, log to or moderate.
If a command says Ethvex is missing a permission, the error tells you which one. Add it to the Ethvex role and try again.
Role hierarchy #
Discord only lets you act on members whose highest role sits below yours in the role list. Ethvex follows the same rule, and it also checks its own role. So for a ban to work:
- Your highest role must be above the member's highest role.
- The Ethvex role must be above the member's highest role.
- Nobody can act on the server owner, on themselves, or on Ethvex itself.
If you see a hierarchy error, go to Server Settings → Roles and drag the Ethvex role higher. That fixes most problems.
What Ethvex needs #
These are the permissions to give the Ethvex role if you are not using Administrator.
| Permission | Used by |
|---|---|
| View Channels | Everything. Ethvex needs to see a channel to work in it. |
| Send Messages | Replies, panels, logs, welcome messages and giveaways. |
| Embed Links | Embeds and link previews, including the Builder. |
| Attach Files | Ticket transcripts and images. |
| Read Message History | Purge, sticky messages and replying to messages. |
| Ban Members | ban, unban, AutoMod |
| Kick Members | kick, AutoMod, verification kicks |
| Moderate Members | timeout, untimeout, warn, AutoMod timeouts |
| Manage Messages | purge, stickyconfig, AutoMod deleting messages |
| Manage Channels | lock, unlock, hide, unhide, slowmode, tickets, Join to Create rooms, verification channel permissions, statistics counters |
| Move Members | Join to Create, to move members into their new room |
| Manage Roles | role, reaction roles, auto roles, Role All, Voice Roles, boost rewards, giveaway winner roles, verification roles |
| Manage Nicknames | nick, auto nickname templates |
| Manage Expressions | steal |
| View Audit Log | Server logs, to show who made a change |
| Add Reactions | Reaction roles and reaction giveaways |
The permission you need for each command is listed on its own page under Permissions.
Ethvex