Installation

Requirements#

• Java 17 or newer — the plugin uses modern Java language features.
• Minecraft 1.13+ on Spigot / Paper, BungeeCord / Waterfall, or Velocity.
• A Discord bot you control (see Discord bot setup).
• Nothing else — SQLite storage is built in, so there's no database to stand up.

Install on a single server#

1. 1

   Download the jar

   Grab the latest DiscordSynthesis release from BuiltByBit.

2. 2

   Drop it into plugins/

   Place the jar in your server's plugins folder.

3. 3

   Restart the server

   On first boot the plugin writes its config files into plugins/DiscordSynthesis/ and then shuts the bot off until you add a token.

4. 4

   Add your bot token

   Open config.yml and paste your token into bot.token. See Discord bot setup.

5. 5

   Set your channel IDs

   Fill in channels.yml for the features you want. See Channels.

6. 6

   Reload

   Run /ds reload in-game or from console — no full restart needed for config changes.

Install on a proxy network#

On a BungeeCord or Velocity network you have two options.

• Proxy-only (simplest): install DiscordSynthesis on the proxy alone. It handles chat, links, and events for the whole network.
• Proxy + backends (proxy mode): install on the proxy *and* each Spigot server, then set proxyMode: true on every Spigot. Backends forward everything to the proxy instead of talking to Discord directly — this unlocks Spigot-only extras like advancements and interactive item sharing across the network.

See Proxy & networks for the full setup.

Optional integrations#

DiscordSynthesis reads the plugins you already run rather than replacing them. If these are present it hooks in automatically: