# \ud83d\udcac AuryxDiscord – Lightweight Minecraft-Discord Integration<\/p>\n
\n
\n
\n<\/p>\n
**AuryxDiscord** is a lightweight, high-performance Minecraft-Discord integration plugin built **without JDA**. Using modern HTTP clients (OkHttp + Jetty), it provides seamless two-way communication between your Minecraft server and Discord with minimal resource usage.<\/p>\n
—<\/p>\n
## \u2728 **Key Features**<\/p>\n
### \ud83d\udcac **Two-Way Communication**
\n– **Minecraft \u2192 Discord** – Chat messages, events, notifications via webhooks
\n– **Discord \u2192 Minecraft** – Messages from Discord appear in-game via HTTP server
\n– **Real-time sync** – Instant message delivery with async processing
\n– **No JDA dependency** – Lightweight HTTP-only implementation<\/p>\n
### \ud83c\udfae **Server Events Integration**
\n– **Join\/Leave Messages** – Player connection notifications with custom formats
\n– **Death Messages** – Death notifications with cause and custom formatting
\n– **Chat Synchronization** – Full chat integration with AuryxChat support
\n– **Punishment Alerts** – Ban\/mute\/kick notifications for moderation teams
\n– **Server Status** – Startup\/shutdown notifications<\/p>\n
### \ud83c\udfa8 **Rich Formatting & Customization**
\n– **Discord Embeds** – Beautiful rich messages with colors and timestamps
\n– **Player Avatars** – Automatic player head integration via Minotar
\n– **Custom Formats** – Fully customizable message templates for each event type
\n– **Placeholder Support** – PlaceholderAPI and AuryxCore placeholder integration
\n– **Emoji Support** – \ud83d\udfe2 Join, \ud83d\udd34 Leave, \u2620\ufe0f Death, \u26a0\ufe0f Punishments<\/p>\n
### \ud83d\udd27 **Advanced Configuration**
\n– **Multiple Webhooks** – Separate channels for chat, logs, deaths, punishments
\n– **Event Filtering** – Enable\/disable specific event types
\n– **Message Queuing** – Anti-spam protection with configurable queue limits
\n– **HTTP Server** – Built-in Jetty server for Discord \u2192 MC communication<\/p>\n
—<\/p>\n
## \ud83c\udfae **Commands Overview**<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/auryxdiscord` | Main plugin command | `auryxdiscord.admin` |
\n| `\/auryxdiscord reload` | Reload configuration | `auryxdiscord.reload` |
\n| `\/auryxdiscord test [message]` | Send test message to Discord | `auryxdiscord.test` |
\n| `\/auryxdiscord info` | View plugin status and integration info | `auryxdiscord.info` |<\/p>\n
—<\/p>\n
## \ud83d\udd04 **How It Works**<\/p>\n
### **Minecraft \u2192 Discord Flow**
\n1. **Event Detection** – Listeners capture chat, join\/leave, death events
\n2. **Message Formatting** – Apply custom templates with placeholders
\n3. **Webhook Delivery** – Send via OkHttp to Discord webhook URLs
\n4. **Queue Management** – Async processing prevents server lag<\/p>\n
### **Discord \u2192 Minecraft Flow**
\n1. **HTTP Server** – Built-in Jetty server receives Discord webhooks
\n2. **Message Processing** – Parse and validate incoming Discord messages
\n3. **Chat Integration** – Forward to AuryxChat or broadcast directly
\n4. **Security** – Webhook signature verification for safety<\/p>\n
—<\/p>\n
## \ud83d\udccb **Message Examples**<\/p>\n
### **Discord Notifications**
\n“`
\n\ud83d\udfe2 **Sqrilizz** joined the server (Players: 5\/20)
\n[MC] Sqrilizz: Hello everyone from Minecraft!
\n\u2620\ufe0f Sqrilizz was slain by Zombie
\n\u26a0\ufe0f **Admin** banned **Griefer**: Griefing spawn area
\n\u2705 **Server started** – Players can now join!
\n“`<\/p>\n
### **Minecraft Chat**
\n“`
\n[Discord] DiscordUser: Hello from Discord!
\n[Discord] Moderator: Server restart in 5 minutes
\n“`<\/p>\n
—<\/p>\n
## \u2699\ufe0f **Configuration Highlights**<\/p>\n
### **Webhook Setup** (`config.yml`)
\n“`yaml
\nwebhooks:
\n chat: “https:\/\/discord.com\/api\/webhooks\/YOUR_CHAT_WEBHOOK”
\n log: “https:\/\/discord.com\/api\/webhooks\/YOUR_LOG_WEBHOOK”
\n death: “https:\/\/discord.com\/api\/webhooks\/YOUR_DEATH_WEBHOOK”
\n punishment: “https:\/\/discord.com\/api\/webhooks\/YOUR_MOD_WEBHOOK”
\n“`<\/p>\n
### **Event Configuration**
\n“`yaml
\nevents:
\n join-leave: true
\n deaths: true
\n punishments: true
\n console: false
\n startup-shutdown: true
\n“`<\/p>\n
### **Message Formats**
\n“`yaml
\nformats:
\n join: “\ud83d\udfe2 **{player}** joined the server (Players: {online}\/{max})”
\n leave: “\ud83d\udd34 **{player}** left the server”
\n death: “\u2620\ufe0f {death_message}”
\n ban: “\u26a0\ufe0f **{staff}** banned **{player}**: {reason}”
\n“`<\/p>\n
### **HTTP Server** (Discord \u2192 MC)
\n“`yaml
\nserver:
\n enabled: true
\n port: 8080
\n path: “\/discord-webhook”
\n secret: “your-webhook-secret”
\n“`<\/p>\n
—<\/p>\n
## \ud83c\udf10 **Platform Compatibility**<\/p>\n
| Platform | Status | Features |
\n|———-|——–|———-|
\n| **Paper** | \u2705 Full Support | All features available |
\n| **Folia** | \u2705 Full Support | Thread-safe implementation |
\n| **Spigot** | \u2705 Compatible | Core features work |
\n| **Bukkit** | \u2705 Compatible | Basic functionality |
\n| **Purpur** | \u2705 Enhanced | Additional optimizations |
\n| **Velocity** | \u2705 Supported | Cross-server integration |<\/p>\n
—<\/p>\n
## \ud83d\udd17 **Integration & Dependencies**<\/p>\n
### **Required Dependencies**
\n– **AuryxCore** – Core functionality and API<\/p>\n
### **Optional Integrations**
\n– **AuryxChat** – Enhanced chat formatting and modes
\n– **PlaceholderAPI** – Extended placeholder support
\n– **AuryxLink** – Discord account linking (planned)<\/p>\n
### **Developer API**
\n“`java
\n\/\/ Get AuryxDiscord API
\nAuryxDiscordAPI api = AuryxDiscord.getAPI();<\/p>\n
\/\/ Send messages to Discord
\napi.sendChatMessage(player, “Hello Discord!”);
\napi.sendLogMessage(“Server event occurred”);
\napi.sendEmbed(“Title”, “Description”, “#5865F2”);<\/p>\n
\/\/ Check integration status
\nboolean enabled = api.isDiscordEnabled();
\nboolean chatSync = api.isChatEnabled();
\n“`<\/p>\n
—<\/p>\n
## \ud83d\ude80 **Performance & Technical Details**<\/p>\n
### **Lightweight Architecture**
\n– **No JDA** – Uses OkHttp for HTTP requests (much lighter)
\n– **Async Processing** – All Discord operations are non-blocking
\n– **Smart Queuing** – Message queue prevents spam and rate limiting
\n– **Memory Efficient** – Minimal RAM usage compared to bot-based solutions<\/p>\n
### **HTTP Components**
\n– **OkHttp Client** – Modern, efficient HTTP requests to Discord
\n– **Jetty Server** – Embedded HTTP server for receiving Discord messages
\n– **Gson JSON** – Fast JSON processing for webhook payloads
\n– **Shaded Dependencies** – No conflicts with other plugins<\/p>\n
### **Cross-Version Support**
\n– **Single JAR** – Works on Minecraft 1.8.8 through 1.21.10
\n– **API Compatibility** – Adapts to different Bukkit\/Paper API versions
\n– **Legacy Support** – Maintains compatibility with older server versions<\/p>\n
—<\/p>\n
## \ud83d\udcca **Setup Guide**<\/p>\n
### **1. Installation**
\n1. Download **AuryxCore** (required)
\n2. Download **AuryxDiscord** from Modrinth
\n3. Place both JARs in your `plugins\/` folder
\n4. Restart your server<\/p>\n
### **2. Discord Webhook Setup**
\n1. Go to your Discord server settings
\n2. Navigate to **Integrations \u2192 Webhooks**
\n3. Create webhooks for different channels:
\n – `#minecraft-chat` – For player chat messages
\n – `#server-logs` – For join\/leave\/death events
\n – `#moderation` – For punishment notifications
\n4. Copy webhook URLs to `config.yml`<\/p>\n
### **3. Configuration**
\n“`yaml
\n# Basic setup – just add your webhook URLs
\nwebhooks:
\n chat: “https:\/\/discord.com\/api\/webhooks\/123456789\/abcdefg”
\n log: “https:\/\/discord.com\/api\/webhooks\/987654321\/hijklmn”<\/p>\n
# Enable desired events
\nevents:
\n join-leave: true
\n deaths: true
\n punishments: true<\/p>\n
# Optional: Enable Discord \u2192 Minecraft
\nserver:
\n enabled: true # Allows Discord users to send messages to MC
\n port: 8080
\n secret: “change-this-secret”
\n“`<\/p>\n
### **4. Testing**
\n“`bash
\n\/auryxdiscord info # Check integration status
\n\/auryxdiscord test # Send test message to Discord
\n“`<\/p>\n
—<\/p>\n
## \ud83c\udfaf **Use Cases**<\/p>\n
### **\ud83c\udff0 Roleplay Servers**
\n– Immersive Discord integration for RP communities
\n– Character death notifications
\n– Staff moderation alerts<\/p>\n
### **\ud83c\udfc3 Survival Servers**
\n– Player activity monitoring
\n– Community chat bridge
\n– Achievement sharing<\/p>\n
### **\ud83c\udfae Mini-game Networks**
\n– Cross-server announcements via Velocity
\n– Tournament notifications
\n– Player statistics sharing<\/p>\n
### **\ud83d\udee1\ufe0f Moderated Communities**
\n– Real-time punishment notifications
\n– Staff communication bridge
\n– Server status monitoring<\/p>\n
—<\/p>\n
## \ud83d\udd27 **Advanced Features**<\/p>\n
### **Message Placeholders**
\n“`yaml
\n# Available placeholders in message formats:
\n{player} # Player name
\n{displayname} # Player display name
\n{message} # Chat message content
\n{server} # Server name
\n{online} # Current online players
\n{max} # Maximum players
\n{balance} # Player balance (AuryxCore)
\n{death_message} # Full death message
\n{staff} # Staff member name
\n{reason} # Punishment reason<\/p>\n
# PlaceholderAPI support:
\n%player_name% # Player name
\n%server_online% # Online count
\n%auryxcore_balance% # Player balance
\n# + 1000+ other PAPI placeholders
\n“`<\/p>\n
### **Webhook Security**
\n– **Signature Verification** – Validates incoming Discord webhooks
\n– **Secret Keys** – Configurable webhook secrets
\n– **IP Filtering** – Optional IP whitelist for HTTP server
\n– **Rate Limiting** – Built-in protection against spam<\/p>\n
### **Multi-Channel Setup**
\n“`yaml
\nwebhooks:
\n chat: “https:\/\/discord.com\/api\/webhooks\/chat-webhook”
\n log: “https:\/\/discord.com\/api\/webhooks\/log-webhook”
\n death: “https:\/\/discord.com\/api\/webhooks\/death-webhook”
\n punishment: “https:\/\/discord.com\/api\/webhooks\/mod-webhook”<\/p>\n
# Events automatically route to appropriate channels
\n# Falls back to ‘log’ webhook if specific webhook not configured
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcde **Support & Community**<\/p>\n
– **\ud83d\udc1b Bug Reports**: GitHub Issues
\n– **\ud83d\udcac Discord**: Auryx Studio Community
\n– **\ud83d\udcd6 Documentation**: Wiki & Setup Guide
\n– **\ud83d\udd27 Source Code**: GitHub Repository<\/p>\n
—<\/p>\n
## \ud83c\udd9a **Why Choose AuryxDiscord?**<\/p>\n
### **vs Traditional Discord Bots:**
\n– \u2705 **No Bot Hosting** – Runs directly on your Minecraft server
\n– \u2705 **Lower Resource Usage** – No JDA, just HTTP requests
\n– \u2705 **Easier Setup** – No bot tokens or permissions needed
\n– \u2705 **Better Integration** – Direct access to server events and data<\/p>\n
### **vs Other Discord Plugins:**
\n– \u2705 **Modern Architecture** – Built for Paper\/Folia with async processing
\n– \u2705 **Lightweight** – 6MB vs 20MB+ for JDA-based plugins
\n– \u2705 **Two-Way Communication** – Most plugins only do MC \u2192 Discord
\n– \u2705 **Rich Formatting** – Embeds, avatars, and advanced placeholders<\/p>\n
### **vs EssentialsX Discord:**
\n– \u2705 **Better Performance** – Async processing and message queuing
\n– \u2705 **More Features** – HTTP server, multiple webhooks, embeds
\n– \u2705 **Active Development** – Regular updates and new features
\n– \u2705 **Modern Codebase** – Java 21, latest APIs, clean architecture<\/p>\n
—<\/p>\n
## \ud83d\udcc4 **License**<\/p>\n
AuryxDiscord is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.<\/p>\n
—<\/p>\n
**Made with \u2764\ufe0f by Auryx Studio**<\/p>\n
*Requires **AuryxCore** for full functionality. Part of the complete Auryx server management suite!*<\/p>\n
—<\/p>\n
## \ud83d\ude80 **Quick Start**<\/p>\n
1. **Install**: Download AuryxCore + AuryxDiscord
\n2. **Configure**: Add Discord webhook URLs to config
\n3. **Test**: Use `\/auryxdiscord test` command
\n4. **Enjoy**: Seamless Minecraft-Discord integration!<\/p>\n
**Transform your server communication today!** \ud83c\udf8a\ud83d\udcac<\/p>\n","protected":false},"excerpt":{"rendered":"
Lightweight Minecraft-Discord integration without JDA. Two-way chat sync, server events, webhooks, embeds, and HTTP server. Modern alternative to heavy Discord bots with AuryxCore integration.<\/p>\n","protected":false},"featured_media":22768,"template":"","meta":{"_minecraft_slug":"auryxdiscord","_minecraft_project_id":"Pje0Bi9j","_minecraft_author":"Sqrilizz","_minecraft_license":"MIT","_minecraft_downloads":70,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"auryxdiscord.zip","_minecraft_size_bytes":5738966,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:30:10.272977Z","_minecraft_date_created":"2025-10-27T08:06:51.220080Z","_minecraft_date_modified":"2025-10-26T16:38:19.149283Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/auryxdiscord","_minecraft_icon_attachment_id":22768,"_minecraft_imported_at":"2026-05-31T22:07:21+00:00","_minecraft_import_hash":"59bf60280f27f2d69118d9346e111f87","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,867,129,985],"mod_loader":[130,131,132,133,134,986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82,31,860,861,862,863,864],"class_list":["post-22767","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-velocity","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n