Skip to content

Sync Setup


Please make sure to go through the Basic Setup before going through with this setup.


Get the name(s) of the minecraft group(s) you want to sync🔗

the synchronization is case-sensitive so make sure you don't mess up with the capitalization

# Example from generic permissions plugin
groups:
  MinecraftGroup1:
    permissions
    ...
  MinecraftGroup2:
    permissions
    ...

You can see what groups DiscordSRV can see in the discordsrv-info.txt file of debug reports, which can be accessed through the link generated from /discordsrv debug

# discordsrv-info.txt from debug report
vault groups: [default, MinecraftGroup1, MinecraftGroup2]

Get Role ID(s) for the role(s) you want to sync🔗

If you have Developer Mode enabled (see Basic Setup), you can get the IDs from Server Settings > Roles by right-clicking the role(s)

Role IDs are also in the discordsrv-info.txt file of debug reports, which can be accessed through the link generated from /discordsrv debug

//discordsrv-info.txt from debug report
discord guild roles: [R:DiscordRole1(680679725206994947), R:DiscordRole2(680679790025506861)]

Set the Role ID(s) and group name(s) in the synchronization option🔗

Now that you have both the Role ID(s) and the Minecraft Group Name(s), add them into GroupRoleSynchronizationGroupsAndRolesToSync located inside the synchronization.yml config file.

# synchronization.yml Line 27
 GroupRoleSynchronizationGroupsAndRolesToSync: {"MinecraftGroup1": "680679725206994947", "MinecraftGroup2": "680679790025506861"}

That's the basics of it! Read the comments for the other options in the synchronization.yml for more control over this system.