Discord Permissions
It is necessary that Aleeva has the following Discord permissions. Why she needs each one, and which feature depends on it, is listed below.
Discord permissions Aleeva requests
Manage Roles
Allows Aleeva to manage (change position and permissions, and assign) all roles below her own role.
Affected features:
- Alliance Verification
- Member Verification
- Guest Management
- Role Mapping
Manage Channels
Allows Aleeva to create, delete and manage channels on your server.
Affected features:
- Event Management
Kick Members
Allows Aleeva to kick members who do not have a role higher than her own.
Affected features:
- Guest Management
- Scam Protection
Ban Members
Allows Aleeva to ban members who do not have a role higher than her own.
Affected features:
- Scam Protection
Send Messages
Allows Aleeva to send messages on your server. This permission can be declined on individual channels to prevent Aleeva from sending messages there.
Affected features:
- All
Read Messages
Allows Aleeva to read messages in your server channels. This permission can be declined on individual channels to prevent Aleeva from reacting to commands there.
Affected features:
- All
Manage Messages
Allows Aleeva to manage messages on your server. This is needed to remove commands and edit messages.
Affected features:
- DPS Report Uploader
- Scam Protection
Embed Links
Allows Aleeva to add links into messages, as well as generate the response boxes.
Affected features:
- All
Attach Files
Allows Aleeva to send files in server channels.
Affected features:
- All
Use External Emojis
Allows Aleeva to use her own emojis, which are needed for answers and interactions.
Affected features:
- All
Read History
Allows Aleeva to read messages that members and Aleeva itself have written in the past.
Affected features:
- Event Management
Add Reactions
Allows Aleeva to add reactions to messages.
Affected features:
- All
Guild Wars 2 API key permissions
Aleeva requires this set of permissions (account, builds, characters, inventories, wallet, progression, unlocks and wvw) because it allows all Aleeva commands to be usable.
If you only want to get verified on a server and do not intend to use Aleeva, you can opt for a light key, which only requires the permissions account and wvw.
The full key ensures that all of Aleeva's features are available, so Aleeva works without issue. The reasons why specific permissions are needed:
- Account. Used for account verification with Aleeva.
- Builds. Allows you to use Aleeva functions related to builds (such as traits in PvE, PvP and WvW, as well as equipment load-outs and masteries).
- Characters. Allows you to use Aleeva commands related to specific characters (such as listing your character birthdays).
- Inventories. Allows you to use Aleeva to search for particular items in your character inventories (for example the or command).
- Wallet. Allows you to search for items in your in-game wallet (such as a particular map currency or festival currency; this does not relate to real-world financial information about your account).
- Progression. Allows you to use Aleeva features to query progress (such as which raid bosses you have killed or which achievements you are missing).
- Unlocks. Allows you to query Aleeva about things you have unlocked in the game (such as mount skins, dyes, minis, and so on).
- WvW. Allows you to query Aleeva about WvW team related information as well as team role assignments.
- Guilds. Only needed by guild leaders to check the rank of members in the guild (to map in-game roles to roles in Discord).
If we allowed users to pick and choose the API permissions themselves, they would need to change the API token permissions multiple times to be able to use all of Aleeva's commands and features. We want a better experience than that. It would also lead to problems like one feature working and another not. In addition, the API keys are saved globally for the user so they work across all Discord servers the user can access that use Aleeva, no matter what features of Aleeva the server uses. The pvp and trading-post permissions are the only optional permissions, because we only have one pvp command so far.
