Skip to content
Robin edited this page Mar 29, 2023 · 17 revisions

Invite the bot to your guild & Discord setup

  1. Invite the bot using this link. You are required to have the "Manage Server" permission in the guild in order to invite the bot.
  2. Use the /configure link in your Discord server (not in DMs!) to connect the bot to your website. You can find the API URL and API key in StaffCP > Configuration > API
  3. You can now enable Discord integration in Panel > Integrations > Discord

Note: By using the invite link above you use our Nameless-Link bot instance. This means we store your website API key, see this page for more information. If you know a thing or two about systems administration you might want to host the bot yourself.

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 command has to be run in a Discord server, not in a DM to the bot. Username sync may be done automatically in the future.

Group sync

The bot needs to know which Discord role to assign to each NamelessMC group. To configure this, open StaffCP > 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 or website, they won't have full access to your Discord server.

Roles are synced in both directions.