Ethvex logo Ethvex Docs
Updated Invite

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.

You are in control

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.
Quick fix

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.

PermissionUsed by
View ChannelsEverything. Ethvex needs to see a channel to work in it.
Send MessagesReplies, panels, logs, welcome messages and giveaways.
Embed LinksEmbeds and link previews, including the Builder.
Attach FilesTicket transcripts and images.
Read Message HistoryPurge, sticky messages and replying to messages.
Ban Membersban, unban, AutoMod
Kick Memberskick, AutoMod, verification kicks
Moderate Memberstimeout, untimeout, warn, AutoMod timeouts
Manage Messagespurge, stickyconfig, AutoMod deleting messages
Manage Channelslock, unlock, hide, unhide, slowmode, tickets, Join to Create rooms, verification channel permissions, statistics counters
Move MembersJoin to Create, to move members into their new room
Manage Rolesrole, reaction roles, auto roles, Role All, Voice Roles, boost rewards, giveaway winner roles, verification roles
Manage Nicknamesnick, auto nickname templates
Manage Expressionssteal
View Audit LogServer logs, to show who made a change
Add ReactionsReaction roles and reaction giveaways

The permission you need for each command is listed on its own page under Permissions.