Guides
Some helpful guides on how to make the most of Ser Aymeric
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 "Custom Commands" 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. Please ensure the bot has the "Add Reactions" permission for the help function to work.
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.
How to invoke the help function
1
?help
Help
The help command lists all the bot's commands. However, since there are so many the list is paginated. You can cycle through the pages using the reaction controls attached to the message. These reactions will only respond to the person that invoked the help function. The help function shows:
  • The different ways you can invoke a command, sometimes there are multiple depending on acceptable parameters.
  • A description of what the command does.
  • Shortcuts or aliases that will also invoke the command. For example, you don't have to type ?equipment, you can simply type ?eq
  • A link to our Twitter and support Discord, if you'd like additional help.
Please Note
Help's reaction controls will only respond to the user who invoked the function, and there is a timer. The bot will not respond to these commands forever. Please re-invoke the help function if some time has passed and it is no longer responsive.
3
?help {category}
Help
Sometimes you may only want to view commands for a specific module. You can pass the name of the module to the ?help command as a parameter to view only commands for that module. Modules correspond to the categories you see on your Discord's settings page on our website, so for example:
  • Music
  • Profiles
  • Moderation
  • Information
  • Utilities
  • Fun
  • FFXIV
Please Note
Some modules don't have commands, as their features are configured entirely from your Discord's settings page on our website, for example the Twitter and Reddit feeds module. Though, in these cases there may be commands in the information module that enables you to view what you have configured.
3
?help {command}
Help
You may also want to view information about a specific command only. This may be useful if you want to show the help to another user. If you use the help function for a specific command, you will also see some additional information about whether or not that command is enabled in that particular Discord, who can use it, and in which channels.
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 Permissions & Restrictions
What are command permissions and restrictions?
Another one of Ser Aymeric's most useful features is that it allows you full control over whether or not a command is enabled, who can use it, in what channels, and also whether or not the invoking command and response should be deleted, allowing you to keep your channels super tidy! This guide demonstrates how to customise your commands at two levels.
Please Note
If you enable or configure any global command override under the "General" module of your Discord's settings page, these will take absolute precedence over ALL of Ser Aymeric's commands, including the ones you have created yourself.
Moderation Commands
Moderation commands are an exception. You may not edit the permissions of moderation commands from our website. Instead, as moderation commands can have a significant impact on your Discord, permissions to use them are taken directly from the role settings of individual users. For example, If a member uses the ?clear command to prune messages, the bot will only allow this command to work if that member has the ability to "Manage Messages" in your Discord.
1
At the global level
Edit Individual Commands
Under the general settings module on your Discord's settings page on our website, you can:
  • Restrict all commands to users with specific roles
  • Restrict all commands to certain channels
  • Ask the bot to delete command triggers when they have been posted if the command was successful
  • Ask the bot to delete command triggers when they have been posted if the command errored
  • Ask the bot to delete command responses after x seconds when they have been posted if the command was successful
  • Ask the bot to delete command responses after x seconds when they have been posted if the command errored
Please Note
These settings will only take affect if they have values or have been enabled. Otherwise, the configuration will be taken from the settings of individual commands.
2
At the individual command/ custom command level
Edit Individual Commands
Each module on your Discord's settings page has a section that lists the commands for that module if it has any. Here, you may click the cog icon to bring up the edit menu, for permissions and restrictions or you may toggle the command on or off quickly without opening the edit popup.
Editting Commands
When editting the permissions and restrictions of an individual command, you can:
  • Restrict this command to users with specific roles
  • Restrict this command to certain channels
  • Ask the bot to delete the command trigger if the command was successful
  • Ask the bot to delete the command trigger if the command errored
  • Ask the bot to delete the command response after x seconds if the command was successful
  • Ask the bot to delete the command response after x seconds if the command errored
Please Note
If you have enabled any global command restrictions, then the respective setting on the individual command will be darkened to indicate that it is not accessible. This is to signify that you have global restrictions enabled.