Guides
Some helpful guides on how to make the most of Ser Aymeric
Permissions Guide
About Permissions
Please see Discord's guide on permissions here.
Minimum Permissions
At a bare minimum we advise you to ensure that Ser Aymeric has:

  • Read Messages
  • Read Message History
  • Embed Links
  • Attach Files
  • Add Reactions
In every channel you would like the bot to operate in & every channel you have configured in some way from your Discord's settings page. This will ensure that the bot will be able to post messages like responses to commands, live streamer notifications & feeds from Twitter, Reddit & the Lodestone if you have configured them.

These bare minimum commands will not enable the bot to perform any moderation actions, and will not allow members to manage their own roles through custom commands or reaction roles, e.t.c.
Role Hierarchy
Ser Aymeric's role must be above any other role in your Discord's role hierarchy that you have asked Ser Aymeric to manage in some way.
Text Channel Permissions
1
Manage Roles
The following features require this permission
  • Custom commands if you have set up command actions that can assign or remove roles, live streamer notifications
  • Reaction Roles to assign and remove a user's roles when they react to a reaction roles message
  • Live streamer notifications if you have configured the bot to assign a role to a user when they go live on Twitch, YouTube, Mixer or Picarto
  • New Members, if you have configured the bot to assign a role to new members with they join your Discord
  • Final Fantasy XIV, if you have configured the bot to assign roles for Datacenter, World & achievements
  • Auto-moderator for assigning/ removing roles when offences are committed
2
Manage Channels
The following features require this permission
  • Moderation mute, tempmute,lock & templock commands, to add permissions overrides to user to disallow them to type messages.
3
Manage Messages
The following features require this permission
  • Moderation for the clearing of messages
  • Moderation for the muting of users
  • Moderation for the locking of channels
  • Moderation for warning users
  • Auto-moderator for deleting messages containing Discord invite links/ bad words, etc
4
Kick/ Ban users
The following features require this permission
  • Moderation for kicking/ banning users
  • Raid mode for kicking users
  • Auto-moderator for kicking/ banning users
5
Manage Nicknames
The following features require this permission
  • Custom Commands for the creation of commands with actions that change user's nicknames
6
Attach Files
The following features require this permission
  • Final Fantasy XIV to upload character information cards, character portraits and character equipment cards
  • Utilities for the user avatar command
7
Embed Links
Required by most features, to post responses containing Discord embeds
8
Send Messages
Required by every feature to respond to commands or automatically post any configured messages.
9
Read Messages
Required by every feature to detect a command
Voice Channel Permissions
1
Connect
The following features require this permission
  • Music for streaming music to a voice channel
2
Speak
The following features require this permission
  • Music for streaming music to a voice channel
Setting up self-assignable roles
What are self-assignable roles?
Self-assignable roles are created with Ser Aymeric's Custom Commands plugin and are a way for your Discord's members to choose roles for themselves via bot commands without having to ask your Discord's management team to do it for them. You might use this feature to allow members to select which channels they have access to, or to select their own coloured roles.
What are custom commands?
One of Ser Aymeric's super useful features is the ability for you to create your own bot commands. Each command is fully customisable, allowing you to control who can invoke them and in what channels and allow you to have up to 5 actions the bot should take when the command is invoked. These actions include sending messages, managing roles and managing nicknames.
Required permissions
"Manage roles", "Manage Nicknames", "Send messages" & Ser Aymeric's role must be above any self-assignable role in your Discord's role hierarchy.
1
Go to your Discord's "Manage" page and click the "Reaction Roles" button
  • Login to this website with your Discord account
  • Click on your Discord's icon in the navigation bar
  • In the expanded menu, click on "Manage" to access your Discord's settings
  • Scroll down the page of plugin settings buttons and click on "Custom Commands"
This is your custom commands management section. From here you are able to add, edit & delete your custom commands and view your Discord's limits.

At a glance, you can see each command you've added, the text required to trigger it after your Discord's own command prefix {p} and any groups you've assigned to that command.

Those who subscribe to Ser Aymeric's premium service via Patreon are rewarded with triple the amount of custom commands they can add to their Discords.
2
Add/ edit custom commands
Trigger
This is the text after your Discord's command prefix {p} that will be used to trigger the command.
Trigger
Command triggers must not contain spaces and must consist of alpha-numeric characters only with the exception of - _ / characters
Group
You may wish to group commands together. This is simply a text name to categories your command and is used by the {p}roles & {p}customcommands commands to allow users to select from a paginated menu, which group they'd like to view custom commands for.
Permissions
You can control who can invoke your custom commands and in what channels they can be invoked. If you do not specify any roles or channels then the command will be unrestricted.
Actions
Randomise
This setting means the bot will choose a single, random respond or DM action from those you have configured to enact.

One command, multiple memes!
Toggle
The toggle actions allows you to configure a role that will be assigned to the user when they invoke your command if they don't already have it, or remove it if they do with a single custom command.

You may be familiar with some bot's using the {p}joinrole role and {p}leaverole role notation. But Ser Aymeric makes this much simpler.
Assign
Simply assign a role to the user if they don't already have it.
Remove
Remove one of the user's roles.
Clear
The clear action removes all of the user's other self-assignable roles in the same group that you have configured. If you have not named a group for any of your self-assignable role commands then all other self-assignable roles will be removed.
4
List your commands!
?customcommands

List all of your custom commands, excluding those with self-assignable roles

?roles

List all of your custom commands with self-assignable roles

?roles group

List all of your custom commands in a given group with self-assignable roles

5
Example custom command: Suggestion command that assigns a contributor role
6
Example custom command: Funny command with a randomised response
7
Example custom command: Toggle a self-assignable role and toggle nickname prefix
Message Formatting
Did you know?
You can heavily customise the bot's responses where there is an option to tell Ser Aymeric what to say. For example, in custom commands, new member greetings, auto-moderator responses & raid mode, e.t.c. See below for some helpful tips as to how!
How to obtain Discord IDs of things
Please see this guide on how to obtain the IDs by enabling developer mode. You can also obtain IDs by prefixing a role mention or custom emoji with a backslash into the chat, e.g. \:blobcatgooglewave: or \@Developers
1
Mark Down
Please see this guide on how to use mark down in your messages. Mark down can be used in configurable bot messages too!
2
User, Role & Channel mentions
Type Structure Example
User <@USER_ID> <@80351110224678912>
User (Nickname) <@!USER_ID> <@!80351110224678912>
Channel <#CHANNEL_ID> <#103735883630395392>
Role <@&ROLE_ID> <@&165511591545143296>
Using the markdown for either users, roles, or channels will mention the target(s) accordingly.
3
Custom Emoji
Type Structure Example
Custom Emoji <:NAME:ID> <:blobcatgooglywave:216154654256398347>
Custom Emoji (Animated) <a:NAME:ID> <a:dontfeelsoblob:392938283556143104>
Help Function
About Help
The bot's help function exists to allow you to review all of the bot's commands inside Discord. You can also view a complete list of commands on this website.
Reactions
Reactions are attached to the help function to allow you to navigate the paginated list of commands. These buttons will only respond to the user who originally invoked the help function.
Changed the command prefix?
All of Ser Aymeric's commands, even the help function will respond to the command prefix you have set inside your Discord. The help function will also list commands with your new prefix.
Command permissions
How to invoke the help function
1
?help
2
?help category
Ser Aymeric has a lot of commands & you may only wish to view commands for a specific category. Simply pass in the name of the category as a parameter to the help command.
  • Moderation for the clearing of messages
  • Moderation for the muting of users
  • Moderation for the locking of channels
  • Moderation for warning users
  • Auto-moderator for deleting messages containing Discord invite links/ bad words, etc
3
?help command
Command Prefix
What is a command prefix?
Discord bots listen for messages posted in channels for something they might need to respond to. A bot's command prefix is a character or series of characters that indicate to the bot that a response is required.
Ser Aymeric's default command prefix
Ser Aymeric's default command prefix is a single question mark. For example, if you post a message beginning with ? such as ?help, the bot knows that you have entered a command called 'help'.
How to change the command prefix for your Discord
Use the '?setprefix' command to change your Discord's command prefix. Please specify the new prefix as a parameter to this command. The new prefix must be a single punctuation character.
Only Administrators of your Discord can change the command prefix
You must be the Administrator of the Discord to use the ?setprefix command. Please also note that your members may be used to using Ser Aymeric in other Discord servers, so please ensure that you properly inform your members of what the prefix is in your server.
Have you forgotten your Discord's command prefix?
Simply mention Ser Aymeric's username with the word 'prefix' and the bot will tell you. For example, type "@Ser Aymeric what is the command prefix?"
Multi-language Support
Guide Coming Soon
Sorry this guide is not finished yet, please come talk to us in our Discord if you would like to know more about this topic.
Reaction Roles
What are Reaction Roles?
The reaction roles feature allow users to summon a menu with the ?rroles command, which will list the roles you have configured and automatically add the reactions to that menu. By specifying a group for each roles, you can have multiple reaction roles listed in a single message by providing the same group name.

You can specify whether your users will be notified about role changes in DM or not, whether the reaction is automatically removed again after it has been selected and whether or not users can have multiple roles from a group. If you specify that the reaction is automatically removed after selected then the user must select the reaction again to remove the role, otherwise they simply remove the reaction themselves to toggle the role off.
Premium-only Feature
Our reaction roles feature is for premium subscribers only. This is both a great way to enhance your Discord server by allowing user's to manage their own roles in a very accessible way, and also supports the project. If you'd like more information about this please see here. However, our custom commands features are very powerful and customisable and allow your users to manage their own roles too, and isn't part of the premium package.
Required permissions
"Add Reactions", "Manage roles" and Ser Aymeric's role must be above any reaction role in your Discord's role hierarchy.
Features
1
Notify users of role changes in DM or keep the changes silent.
2
Categorise multiple roles together with a "group" to allow more user-friendly navigation of the ?rroles command, and to allow multiple messages to be pinned in a roles channel in your Discord.
3
Specify your own description text for each group.
4
Allow users to select one role, or multiple from a specific group.
5
The bot can either leave the reaction in-place when one of your users selects one, which means they can deselect the reaction to have the role removed, or you can specify that the reaction should instantly be removed, in which case the user must add the reaction again to toggle the role.
6
As with any of our commands, you can customise which roles can use the ?rroles command, and in which channel. By default everyone can use the command, but you can also leave the response which contains the reaction roles menu in a channel and it will continue to work.
7
Requirements enable you to specify that users must also have another role before they can obtain a reaction role, or that they must be a member of your Discord for x days.
Setting-up Reaction Roles
Where do I set-up Reaction Roles?
You can configure reaction roles from your Discord's "Manage" page on this website. Please use the navigation menu at the top right of this page to select your Discord, click on "Manage" and on your settings page, select the "Reaction Roles" button.
1
Go to your Discord's settings page
Reaction Role list
Here you will see a list of all the reaction roles you have configured along with their group. If you have not specified a group then the text "ungrouped" will be shown. Ungrouped in itself is still technically a group, so if you don't specify a group for any of your reaction roles they will be displayed together in an "ungrouped" category.

You may also delete your reaction roles from this list.
2
Click the "Add Roles" button to add a new reaction role
Group (optional)
The name of the group to assign to this (and other reaction roles) to list multple reaction roles together in a single message.
Emoji (required)
The reaction that is automatically added to the reaction roles menu that users can select from to assign/ remove a role.
Role (required)
The role to assign or remove when a user reacts to the reaction role menu.
Must first have role (optional)
Users cannot obtain the above role unless they also have this role.
Must be a member for x days (optional)
Users cannot obtain the above role unless they have been a member of your Discord for x days.
3
Scroll down to view all the groups you have attributed to reaction roles and configure options
Allow members only one role
If this is checked, then when a user selects a role from a reaction, then all other roles in this group will be removed from the user aside from this one.
Description
The description text to give to this group. Allows you to specifically describe the group of reaction roles.
4
Use the ?rroles command!
Notes
Selecting Roles
Our role pickers that are related to the bot managing user's roles have some restrictions, please see the example below.
Searching
After clicking on the drop-down menu, you may enter text to search for a list of roles in your Discord.
Roles Not Shown
Role pickers will not show "managed" roles. These are roles that are given to specific bots you have invited to your Discord and cannot be removed unless you kick the related bot.
Roles Not Selectable
Discord's role hierarchy is important. Users cannot assign or remove roles that are above that user's own role in your Discord's role hierarchy. Roles that are above the bot's own managed role in your Discord are not selectable and are indicated by strikethrough text.
Listening to Music
Guide Coming Soon
Sorry this guide is not finished yet, please come talk to us in our Discord if you would like to know more about this topic.
Command Restrictions
Guide Coming Soon
Sorry this guide is not finished yet, please come talk to us in our Discord if you would like to know more about this topic.