Solifex Studios
DiscordSynthesisWiki
Browse the wiki

Features

Role & permission sync

Keep Minecraft groups and permissions in step with Discord roles — with a configurable authority.

Module

modules.synchronization

Config

features.synchronization

Needs

LuckPerms (recommended)

Platform

All

Map Minecraft groups (and individual permissions) to Discord roles. When one side changes, the other follows. The authority on each mapping decides who wins if they disagree.

Nickname and connect role

yamlfeatures.yml
synchronization:
  # Rename the linked Discord member to their MC username
  syncNickname: true
  # Give every linked member a 'connected' role
  addRole: false
  roleId: ''
  # Console commands run when a player links
  commands: []

Group mappings

Each entry pairs a Minecraft group with a Discord role. authority controls what happens when the rank is removed on one side:

MINECRAFT
Minecraft wins. Remove the Discord role and the plugin re-adds it to match the MC group.
DISCORD
Discord wins. Remove the MC group and the plugin re-adds it to match the Discord role.
BOTH
Mirror. Removing the rank on either side removes it on the other — nothing is re-added.
yamlfeatures.yml
synchronization:
  groups:
    - group: vip
      role: '123456789012345678'
      authority: MINECRAFT
  permissions:
    - permission: essentials.fly
      role: '123456789012345678'
      authority: MINECRAFT

Periodic re-sync

yamlfeatures.yml
synchronization:
  reSyncEveryonePeriodically: false
  reSyncEveryoneTimer: 10.0    # minutes
  reSyncOnlineOnly: false      # skip offline players (faster on big servers)

Note

Group and permission sync read from LuckPerms directly, so display names and prefixes match exactly what LuckPerms reports.