DiscordFusion

# DiscordFusion - Seamless Discord-Minecraft Integration (https://img.shields.io/badge/Minecraft-1.20--1.21-blue)](https://modrinth.com/plugin/discordfusion) (https://img.shields.io/badge/Paper-1.21.x-orange)](https://modrinth.com/plugin/discordfusion) (https://img.shields.io/badge/Download-Modrinth-green)](https://modrinth.com/plugin/discordfusion) (https://img.shields.io/badge/version-1.0.0-orange)](https://modrinth.com/plugin/discordfusion) (https://img.shields.io/badge/downloads-1+-green)]() **DiscordFusion** is a powerful, feature-rich plugin that seamlessly bridges your Minecraft server with Discord. Create a truly connected community where your players can interact across platforms, and server staff can manage everything from Discord! ## ✨ Features ### 🎮 Three Dedicated Discord Channels - **💬 Chat Channel** - Regular public chat, perfect for community interaction - **🔒 Admin Channel** - All messages including private whispers (/msg, /tell, /reply) - **📊 Log & Command Channel** - Console logs with smart aggregation + command execution ### 🔄 Two-Way Communication - **Minecraft → Discord**: All chat messages, join/leave events, and achievements - **Discord → Minecraft**: Messages appear with tag in chat - **Rich Embeds**: Beautiful embeds with player heads for join/leave/achievement events ### 🛡️ Advanced Security & Control - **AFK Detection**: Auto-mark inactive players with configurable timeout - **Rate Limiting**: Prevent spam with cooldowns and limits - **User Whitelist**: Control who can execute Minecraft commands from Discord - **Private Message Filtering**: Private messages stay private in public channels - **Vanished Players stay Vanished**: Doesnt show vanished players when playerlist command is used - **Silent join/leave**: Doesn't show player joined or left when discordfusion.silentjoin/leave permission is true ### 💻 Server Management from Discord - Execute any Minecraft command directly from Discord - View online player list with simple `playerlist` command - Monitor console logs in real-time - Reload configuration without restarting the server ### ⚡ Performance Optimized - **Message Aggregation**: Console logs are grouped into single messages (edited every 5-10 minutes) - **Async Operations**: Never blocks your server thread - **Lightweight**: Minimal performance impact - **Memory Efficient**: No memory leaks or unnecessary caching ## 📋 Commands | Command | Description | Permission | |---------|-------------|------------| | `/discordfusion reload` | Reload configuration without restart | `discordfusion.reload` | | `/discordfusion status` | View plugin status and statistics | `discordfusion.status` | | `/discordfusion test <message/embed/ping>` | Test Discord connection | `discordfusion.admin` | | `playerlist` (Discord) | Show online players in Discord | None (anyone) | ## 🔧 Configuration ```yaml # Discord Bot Token (required) bot-token: "YOUR_BOT_TOKEN_HERE" # Channel IDs (required) chat-channel-id: 123456789012345678 admin-channel-id: 123456789012345678 log-command-channel-id: 123456789012345678 # Custom Messages server-started-message: "🟢 **Server Started!**" server-stopped-message: "🔴 **Server Stopped!**" # Allowed Discord Users (User IDs) allowed-discord-users: - "123456789012345678" # Message Formats message-format: discord-to-minecraft: "&8 &f%player%&7: &f%message%" minecraft-to-discord: "**%player%:** %message%" afk-suffix: " *(AFK)*" # Security Settings security: max-commands-per-minute: 10 filter-private-messages: true # Advanced Settings advanced: aggregation-interval: 5 afk-timeout: 5 debug-mode: false