Overview
DiscordSynthesis is a comprehensive Discord integration plugin that bridges your Minecraft server with your Discord community. With support for Spigot, BungeeCord, and Velocity platforms, it offers a wide range of features from chat synchronization to player management and reporting systems.

Key Features

Multi-Platform Support

• Works with Spigot, BungeeCord, and Velocity
• Proxy mode for networked servers
• Seamless integration across all platforms

Communication Features

• Chat Synchronization - Send Minecraft chat to Discord and vice versa
• Multiple Formats - Choose between text, webhook, or embed messages
• Command Logging - Track player commands in Discord
• Broadcasting System - Send announcements to both platforms
• Custom Commands - Create Discord slash commands with custom responses

Player Management

• Account Linking - Connect Minecraft and Discord accounts
• Required Linking - Require players to link accounts to join
• Group Synchronization - Sync Discord roles with Minecraft permissions
• Nickname Synchronization - Keep usernames consistent across platforms

Server Information

• Statistics Channels - Display server stats in Discord voice channels
• Status Updates - Show player count in bot status
• Server Events - Notify Discord of server starts/stops

Logging Features

• Player Activity - Track joins, leaves, deaths, and advancements
• Server Switching - Monitor player movement across network
• Console Integration - View server console in Discord

Reporting Systems

• Player Reports - Allow players to report rule breakers
• Bug Reports - Collect feedback about server issues
• Report Management - Handle reports through Discord
• Teleport to Reports - Quickly investigate reported incidents

Reward System

• Message Rewards - Reward players for Discord activity
• Voice Chat Rewards - Incentivize voice channel participation
• Customizable Commands - Configure any command as a reward

Detailed Feature Breakdown

Chat Synchronization
Send messages between Minecraft and Discord with three different display options:

• Text Mode - Simple text messages with customizable format
• Webhook Mode - Messages with player avatars and names
• Embed Mode - Stylish embedded messages with custom colors

Configure channel-specific sync for different server types or chat channels. Filter messages with blacklist support to prevent unwanted content from being shared.

Account Linking System
Players can link their Minecraft and Discord accounts using:

• /connect command in Minecraft generates a unique code
• /connect <code> in Discord completes the connection
• Alternative /pin command for additional options

Optional required linking feature ensures players must connect accounts before joining, with configurable role requirements and exemptions.

Group Synchronization
Powerful two-way synchronization between Discord roles and Minecraft permissions:

• Authority Control - Choose whether Discord or Minecraft has priority
• Multiple Mappings - Configure any number of role-group pairs
• Permission-Based Sync - Sync based on specific permissions
• Automatic Updates - Periodic re-sync to ensure consistency

Statistics Display
Show real-time server statistics in Discord:

• Player Count - Current online players
• Unique Players - Total unique players who have joined
• Custom Bot Status - Display stats in the bot's activity status

Reporting System
Comprehensive in-game reporting tools:

• Player Reports - Report rule violations with evidence
• Bug Reports - Submit technical issues to staff
• Management Interface - Handle reports through commands
• Discord Notifications - Alert staff of new reports
• Teleport Feature - Jump to report locations for investigation

Commands
Permissions

Installation
1. Download the plugin JAR file
2. Place in your server's plugins folder
3. Restart your server
4. Configure the plugin in the generated config.yml file
5. Set up your Discord bot and invite it to your server
6. Restart again to apply changes

Configuration
DiscordSynthesis offers extensive configuration options to customize every aspect of the plugin. The main configuration files are:

• config.yml - Core plugin settings
• messages.yml - Customizable message formats

Discord Bot Setup
1. Create a bot at the Discord Developer Portal
2. Enable necessary intents (Server Members, Message Content)
3. Copy your bot token to the config.yml
4. Invite the bot to your server with appropriate permissions
5. Configure channel IDs in the config.yml

Database Configuration
The plugin supports both SQLite (default) and MySQL:

• SQLite - No additional configuration needed
• MySQL - Configure connection details in config.yml

FAQ
Q: How do I link my Discord and Minecraft accounts?
A: Type /connect in Minecraft, then use the provided code with /connect <code> in Discord.

Q: Can I use this plugin on a BungeeCord network?
A: Yes! DiscordSynthesis supports Spigot, BungeeCord, and Velocity. For Spigot servers in a network, enable proxy mode.

Q: How do I create custom Discord commands?
A: Add them to the customCommands section in the config.yml file with parameters, responses, and optional Minecraft commands to execute.

Q: Can I sync multiple Discord roles with Minecraft groups?
A: Yes, you can configure multiple group-role mappings in the synchronizationSettings section.

Requirements

• Minecraft 1.13+
• Spigot, BungeeCord, or Velocity server
• Java 16 or higher
• Discord bot with Server Members and Message Content intents

Wiki | ️ Discord