Solifex Studios
DiscordSynthesisWiki
Browse the wiki

Features

Ban sync

Mirror bans between Minecraft and Discord — either direction — with staff alerts.

Module

modules.banSync

Config

features.banSync

Platform

All

Ban a player in Minecraft and they're banned in Discord; ban them in Discord and they're banned in Minecraft. Choose the directions, the authority on conflicts, and how the Discord side is enforced.

yamlfeatures.yml
banSync:
  syncMinecraftToDiscord: true
  syncDiscordToMinecraft: true
  # MINECRAFT / DISCORD / BOTH
  authority: BOTH
  # Only sync bans for players who have linked accounts
  requireLinking: true

Enforcement on the Discord side

By default a synced ban is a real Discord guild ban. Alternatively, assign a Banned role instead — useful if you'd rather quarantine than remove.

yamlfeatures.yml
banSync:
  # Leave empty to use real Discord bans
  bannedRoleId: ''
  removeOtherRoles: false

Custom commands on the Minecraft side

Run your own ban plugin's commands when a Discord ban syncs in, instead of the vanilla ban:

yamlfeatures.yml
banSync:
  # Placeholders: %player%, %reason%
  onDiscordBanCommands:
    - 'ban %player% %reason%'
  onDiscordUnbanCommands:
    - 'unban %player%'

Staff notifications

Post every synced ban to a staff channel as an embed with the reason, source, and who issued it.

yamlfeatures.yml
banSync:
  notifyStaffChannel: true
  staffChannelId: '123456789012345678'