Correct a DiscordSRV link made to the wrong Discord account

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

A player can accidentally link Minecraft to a secondary Discord account. Correct that one relationship using the documented unlink flow instead of deleting DiscordSRV’s whole linking database or manually editing unrelated records.

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

Confirm ownership through your normal private support process. Ask the player to identify the intended Minecraft account and Discord account without requesting their Discord password, bot token or a public copy of a live linking code.
Record which non-sensitive role changes the existing mapping produced. Check the installed commands and permissions for unlinking an account; use the supported self-service route where available rather than granting administrative permissions to the player.
Unlink the incorrect identity and follow the documented linking process with the intended Discord account. Complete the exchange privately and treat the code as temporary proof rather than something to keep in a public screenshot.
Trigger or wait for the normal role synchronisation and compare both Discord accounts. Check removal from the old account as well as assignment to the new account, especially if membership affects Minecraft access.

Check the result

Only the intended Discord identity should be linked, and the recorded membership policy should apply after reconnecting. Ask the player to verify the account shown in Discord rather than accepting a successful code response alone.

If the test fails

If the replacement cannot be verified, leave the affected relationship unlinked and gather the specific error privately. Do not clear everyone’s links or manually duplicate a role assignment to conceal the unresolved account mismatch.

When link-to-join is enabled, schedule the repair while staff can help the player reconnect. An unlink operation can intentionally interrupt admission until the new relationship is complete.

References and related help

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

Give a LuckPerms permission an expiry without leaving permanent access

Make a LuckPerms event rank expire while preserving other ranks

Limit a LuckPerms command permission to one Minecraft world

Keep a LuckPerms permission local to one network backend

Move a player along a LuckPerms track without replacing unrelated groups

Fix a LuckPerms prefix priority without changing chat formatting

Remove a direct LuckPerms exception without weakening its parent rank

Apply a small LuckPerms web-editor session to the correct server

Export LuckPerms data before changing its storage configuration

Find an inheritance cycle before it complicates a rank change

Keep default-player permissions separate from staff inheritance

Diagnose LuckPerms edits that reach one backend but not another

Check a player UUID before changing LuckPerms account data

Remove a staff member from one LuckPerms track without clearing their account

Give an EssentialsX rank a fixed home limit

Restrict one EssentialsX warp to an approved player group

Test EssentialsX teleport delay and movement cancellation

Add an EssentialsX cooldown to one utility command

Resolve an EssentialsX command alias conflict without removing either plugin

Check EssentialsX AFK kick exemptions for a staff role

Limit EssentialsX nickname changes without granting formatting control

Give staff a read-only EssentialsX player-information role

Recover from an accidental EssentialsX ignore setting

Restrict EssentialsX repair commands to the intended tool policy

Review EssentialsX command-disabled entries after a plugin change

Test an EssentialsX jail location without trapping a real player

Change the EssentialsX starting balance for new players only

Set EssentialsX maximum and minimum money limits with a boundary test

Change the EssentialsX currency symbol without changing stored money

Test an EssentialsX pay dispute using two controlled accounts

Review EssentialsX worth prices before enabling item selling

Explain an EssentialsX balance leaderboard that looks out of date

Trace an unexpected EssentialsX command charge

Back up EssentialsX money before a player-data migration

Verify a LiteBans temporary ban expires at the intended time

Test whether a LiteBans mute covers a private-message command

Build a LiteBans appeal-review role without punishment access

Check a LiteBans moderator’s maximum punishment duration

Find which plugin handled a ban command on a mixed-plugin server

Verify the server scope of a LiteBans network punishment

Investigate a LiteBans database connection failure without losing history

Reverse one appealed LiteBans punishment while preserving the audit trail

Test an AdvancedBan time layout before staff use it

Check AdvancedBan warnings without accidentally escalating a real player

Give an AdvancedBan helper access to history without ban powers

Check AdvancedBan storage before changing from local files to MySQL

Lift one AdvancedBan restriction after an approved appeal

Locate AdvancedBan correctly on a proxy network

Test SuperVanish visibility with separate staff and player accounts

Check whether a vanished SuperVanish moderator can pick up items

Verify flight is safe when a SuperVanish moderator reappears

Check silent chest inspection without changing container contents

Find a SuperVanish join or player-list information leak

Remove vanish access from a staff role without leaving a hidden account

Check PremiumVanish layered visibility after changing staff ranks

Verify PremiumVanish network vanish across Velocity backends

Check vanished staff interactions before a live investigation

Recognize the PremiumVanish API jar before installing an integration

Give GrimAC alerts to one observer without granting exemptions

Remove a GrimAC exemption and verify when checks resume

Collect a GrimAC prediction log for a false-positive report