Skip to main content

Choose the authority direction for one DiscordSRV rank mapping

Applies to: DiscordSRV; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

Rank synchronisation can undo a manual change when the wrong side is authoritative. Test one ordinary group and one disposable Discord role before enabling a mapping for staff or paying members.

Prepare the test

Use a private test channel and two test identities before changing the public bridge. Keep bot tokens, linking codes and staff console output out of screenshots and public support messages.

Make the change

  1. Write down the intended rule in plain language: a Minecraft group grants a Discord role, or a Discord role grants a Minecraft group. Decide what should happen when that membership is removed, not only when it is added.
  2. Open synchronization.yml and compare the installed comments with the official configuration reference. Check the authority direction, one-way behaviour and whether only the primary Minecraft group participates before editing the mapping.
  3. Confirm the exact group name visible to DiscordSRV and the Discord role ID. Case, display names and role IDs matter; a similarly named role is not a reliable substitute for the intended object.
  4. Apply the single mapping using the release-supported reload or a planned restart. Link two disposable identities and test adding then removing the authoritative membership while observing the other side.

Check the result

Both promotion and removal should follow the written rule. Reconnect the test account and trigger the documented resynchronisation if needed, then confirm the relationship remains stable rather than flipping after the next sync.

If the test fails

Disable the trial mapping and restore its saved configuration if permissions spread unexpectedly. Remove only the test membership changes you recorded; do not clear all linked accounts or reset your permission database.

Keep staff and owner roles outside the first trial. Synchronising a cosmetic member role proves the direction without giving the test account administrative access.

References and related help

Check the official DiscordSRV documentation against your installed release before using a command or setting from another version.

No comments to display