Overview
DC-MC is a powerful bridge between Discord and Minecraft that seamlessly connects your community across both platforms. With bidirectional chat, role synchronization, and comprehensive player management, your server will feel more connected than ever.
*Notice* Large File:
Why so big:
- JDA includes a complete Discord bot framework
- H2 is a full database engine
Features
- Bidirectional Chat Sync - Messages flow seamlessly between Discord and Minecraft with clean formatting
- Role Synchronization - Automatic syncing between Discord roles and Minecraft permissions
- Account Linking System - Secure account linking with rewards for connected players
- Player Information - Check detailed stats for online and offline players from Discord
- Performance Optimized - Async operations, message batching, and smart caching
- Clean Embeds - Discord embeds with player avatars and server branding
- Event Notifications - Join/leave messages, death notifications, and server status
- Console Streaming - Live server console output to Discord with ANSI color support
- McMMO Integration - View McMMO stats and power levels
- Vault Support - Display player balances with economy integration
- Rate Limiting - Prevent spam with configurable message limits
Commands:
Minecraft Commands:
/dcmc [reload|status|sync] - Main admin command
/link - Get your account linking code
/unlink - Remove your Discord connection
/discord - View Discord server information
Discord Slash Commands:
/link <code> - Link your Minecraft account
/online - Show online players
/player <name> - Get player information (works offline too!)
Permissions
dcmc.* - All permissions
dcmc.admin - Admin commands
dcmc.link - Link accounts (default: true)
dcmc.unlink - Unlink accounts (default: true)
dcmc.info - View Discord info (default: true)
dcmc.reload - Reload configuration
dcmc.sync - Force role synchronization
dcmc.bypass - Bypass link requirement
⚡Quick Setup
- Drop DC-MC.jar into your plugins folder
- Start your server to generate config.yml
- Create a Discord bot at https://discord.com/developers/applications
- Add your bot token and channel IDs to config.yml
- Enable these intents in Discord Developer Portal:
- SERVER MEMBERS INTENT
- MESSAGE CONTENT INTENT - Invite your bot to your Discord server
- Restart your server and enjoy!
⚙️ Configuration Highlights
config.yml
discord:
bot-token: "YOUR_BOT_TOKEN"
guild-id: "YOUR_GUILD_ID"
chat-channel-id: "YOUR_CHANNEL_ID"
chat:
discord-to-minecraft:
format: "&8[&9Discord&8] &7%user%&8: &f%message%"
minecraft-to-discord:
embed:
enabled: true
color: "#5865F2"
roles:
sync-enabled: true
role-mappings:
owner:
discord-role-id: "ROLE_ID"
minecraft-permission: "group.owner"
linking:
enabled: true
rewards:
enabled: true
commands:
- "give {player} diamond 5"Screenshots
Screenshots
Using /player when they are offline

Using /player when they are online

Bidirectional chat in action

Join and Leaves
What Console Looks Like:
Dependencies
Required:
- Spigot/Paper 1.20+
- Java 21
Optional:
- Vault - Economy support
- LuckPerms - Advanced permission handling
- McMMO - Skill statistics
- PlaceholderAPI - Custom placeholders
Pro Tips
- Use Discord webhooks for even better message formatting
- Set up role mappings to automatically sync ranks
- Link commands auto-delete after 3 seconds to keep chat clean
- Configure message batching for high-traffic servers
- Enable rate limiting to prevent spam
Common Issues
Troubleshooting
Bot shows as offline:
- Verify your bot token is correct
- Check that required intents are enabled
- Ensure the bot is invited to your server
Messages not syncing:
- Confirm channel IDs are correct
- Check bot permissions in Discord
- Verify chat sync is enabled in config
Roles not syncing:
- Bot needs "Manage Roles" permission
- Bot's role must be higher than roles it manages
- Check role mappings in config
Performance
DC-MC is designed with performance in mind:
- Async message processing
- Efficient caching system
- Message batching for reduced API calls
- Minimal server impact
- H2 database for fast data storage
❤️ Special Thanks
Thanks to all the beta testers and contributors who helped make this plugin awesome!
If you enjoy DC-MC, please leave a review!
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta