Setup

Requires NamelessMC v2 pre-8.

Invite the bot to your guild & Discord setup

1. Invite the bot using this link. You are required to have the "Manage Roles" permission in the guild in order to invite the bot.
2. Send the command !apiurl <guild id> <api url> to the bot user. To get the bot ID, enable developer mode in discord then right click your discord server. You can find the API URL in Panel > Configuration > API
3. You can now enable Discord integration in Panel > Integrations > Discord

Link NamelessMC and Discord accounts

In order for Discord to know which website user is associated with each discord member, people who wish to have their ranks synced must link their accounts using the following steps.

1. Open Account > Profile Settings and click Link in the Discord link section.
2. Follow the instructions and send the specified command to the bot.

If you ever change your Discord username, you can update it on the website using the !updateusername command. This may be done automatically in the future.

Group sync

In order for the bot to know which Discord role to assign to each NamelessMC group, you must setup the Discord Role ID for any groups you want to sync. To do this, open Panel > Configuration > API > Group Sync and match Discord roles to NamelessMC groups.

Make sure the bot role is set to be higher than the highest role you want the bot to manipulate. For example, if you want the bot to be able to sync all roles, drag the bot role all the way to the top. For security reasons it is recommended to leave it below any admin or moderator roles with dangerous permissions. This way, if a malicious person compromises the bot they won't have full access to your Discord server.

Roles are synced in both directions.