AuryxDiscord

💬 AuryxDiscord - Lightweight Minecraft-Discord Integration

without JDA 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.

---

✨ Key Features

💬 Two-Way Communication

- No JDA dependency - Chat messages, events, notifications via webhooks - No JDA dependency - Messages from Discord appear in-game via HTTP server - No JDA dependency - Instant message delivery with async processing - No JDA dependency - Lightweight HTTP-only implementation

🎮 Server Events Integration

- Server Status - Player connection notifications with custom formats - Server Status - Death notifications with cause and custom formatting - Server Status - Full chat integration with AuryxChat support - Server Status - Ban/mute/kick notifications for moderation teams - Server Status - Startup/shutdown notifications

🎨 Rich Formatting & Customization

- Emoji Support - Beautiful rich messages with colors and timestamps - Emoji Support - Automatic player head integration via Minotar - Emoji Support - Fully customizable message templates for each event type - Emoji Support - PlaceholderAPI and AuryxCore placeholder integration - Emoji Support - 🟢 Join, 🔴 Leave, ☠️ Death, ⚠️ Punishments

🔧 Advanced Configuration

- HTTP Server - Separate channels for chat, logs, deaths, punishments - HTTP Server - Enable/disable specific event types - HTTP Server - Anti-spam protection with configurable queue limits - HTTP Server - Built-in Jetty server for Discord → MC communication

---

🎮 Commands Overview

| Command | Description | Permission | |---------|-------------|------------| | `/auryxdiscord` | Main plugin command | `auryxdiscord.admin` | | `/auryxdiscord reload` | Reload configuration | `auryxdiscord.reload` | | `/auryxdiscord test [message]` | Send test message to Discord | `auryxdiscord.test` | | `/auryxdiscord info` | View plugin status and integration info | `auryxdiscord.info` |

---

🔄 How It Works

Minecraft → Discord Flow

1. Queue Management - Listeners capture chat, join/leave, death events 2. Queue Management - Apply custom templates with placeholders 3. Queue Management - Send via OkHttp to Discord webhook URLs 4. Queue Management - Async processing prevents server lag

Discord → Minecraft Flow

1. Security - Built-in Jetty server receives Discord webhooks 2. Security - Parse and validate incoming Discord messages 3. Security - Forward to AuryxChat or broadcast directly 4. Security - Webhook signature verification for safety

---

📋 Message Examples

Discord Notifications

``` 🟢 Server started joined the server (Players: 5/20) [MC] Sqrilizz: Hello everyone from Minecraft! ☠️ Sqrilizz was slain by Zombie ⚠️ Server started banned Server started: Griefing spawn area ✅ Server started - Players can now join! ```

Minecraft Chat

``` [Discord] DiscordUser: Hello from Discord! [Discord] Moderator: Server restart in 5 minutes ```

---

⚙️ Configuration Highlights

Webhook Setup (`config.yml`)

```yaml webhooks: chat: "https://discord.com/api/webhooks/YOUR_CHAT_WEBHOOK" log: "https://discord.com/api/webhooks/YOUR_LOG_WEBHOOK" death: "https://discord.com/api/webhooks/YOUR_DEATH_WEBHOOK" punishment: "https://discord.com/api/webhooks/YOUR_MOD_WEBHOOK" ```

Event Configuration

```yaml events: join-leave: true deaths: true punishments: true console: false startup-shutdown: true ```

Message Formats

```yaml formats: join: "🟢 {player} joined the server (Players: {online}/{max})" leave: "🔴 {player} left the server" death: "☠️ {death_message}" ban: "⚠️ {player} banned {player}: {reason}" ```

HTTP Server (Discord → MC)

```yaml server: enabled: true port: 8080 path: "/discord-webhook" secret: "your-webhook-secret" ```

---

🌐 Platform Compatibility

| Platform | Status | Features | |----------|--------|----------| | Velocity | ✅ Full Support | All features available | | Velocity | ✅ Full Support | Thread-safe implementation | | Velocity | ✅ Compatible | Core features work | | Velocity | ✅ Compatible | Basic functionality | | Velocity | ✅ Enhanced | Additional optimizations | | Velocity | ✅ Supported | Cross-server integration |

---

🔗 Integration & Dependencies

Required Dependencies

- AuryxCore - Core functionality and API

Optional Integrations

- AuryxChat - Enhanced chat formatting and modes - PlaceholderAPI - Extended placeholder support - AuryxLink - Discord account linking (planned)

Developer API

```java // Get AuryxDiscord API AuryxDiscordAPI api = AuryxDiscord.getAPI();

// Send messages to Discord api.sendChatMessage(player, "Hello Discord!"); api.sendLogMessage("Server event occurred"); api.sendEmbed("Title", "Description", "#5865F2");

// Check integration status boolean enabled = api.isDiscordEnabled(); boolean chatSync = api.isChatEnabled(); ```

---

🚀 Performance & Technical Details

Lightweight Architecture

- Memory Efficient - Uses OkHttp for HTTP requests (much lighter) - Memory Efficient - All Discord operations are non-blocking - Memory Efficient - Message queue prevents spam and rate limiting - Memory Efficient - Minimal RAM usage compared to bot-based solutions

HTTP Components

- Shaded Dependencies - Modern, efficient HTTP requests to Discord - Shaded Dependencies - Embedded HTTP server for receiving Discord messages - Shaded Dependencies - Fast JSON processing for webhook payloads - Shaded Dependencies - No conflicts with other plugins

Cross-Version Support

- Legacy Support - Works on Minecraft 1.8.8 through 1.21.10 - Legacy Support - Adapts to different Bukkit/Paper API versions - Legacy Support - Maintains compatibility with older server versions

---

📊 Setup Guide

1. Installation

1. Download AuryxDiscord (required) 2. Download AuryxDiscord from Modrinth 3. Place both JARs in your `plugins/` folder 4. Restart your server

2. Discord Webhook Setup

1. Go to your Discord server settings 2. Navigate to Integrations → Webhooks 3. Create webhooks for different channels: - `#minecraft-chat` - For player chat messages - `#server-logs` - For join/leave/death events - `#moderation` - For punishment notifications 4. Copy webhook URLs to `config.yml`

3. Configuration

```yaml

Basic setup - just add your webhook URLs

webhooks: chat: "https://discord.com/api/webhooks/123456789/abcdefg" log: "https://discord.com/api/webhooks/987654321/hijklmn"

Enable desired events

events: join-leave: true deaths: true punishments: true

Optional: Enable Discord → Minecraft

server: enabled: true # Allows Discord users to send messages to MC port: 8080 secret: "change-this-secret" ```

4. Testing

```bash /auryxdiscord info # Check integration status /auryxdiscord test # Send test message to Discord ```

---

🎯 Use Cases

🏰 Roleplay Servers

- Immersive Discord integration for RP communities - Character death notifications - Staff moderation alerts

🏃 Survival Servers

- Player activity monitoring - Community chat bridge - Achievement sharing

🎮 Mini-game Networks

- Cross-server announcements via Velocity - Tournament notifications - Player statistics sharing

🛡️ Moderated Communities

- Real-time punishment notifications - Staff communication bridge - Server status monitoring

---

🔧 Advanced Features

Message Placeholders

```yaml

Available placeholders in message formats:

{player} # Player name {displayname} # Player display name {message} # Chat message content {server} # Server name {online} # Current online players {max} # Maximum players {balance} # Player balance (AuryxCore) {death_message} # Full death message {staff} # Staff member name {reason} # Punishment reason

PlaceholderAPI support:

%player_name% # Player name %server_online% # Online count %auryxcore_balance% # Player balance

+ 1000+ other PAPI placeholders

```

Webhook Security

- Rate Limiting - Validates incoming Discord webhooks - Rate Limiting - Configurable webhook secrets - Rate Limiting - Optional IP whitelist for HTTP server - Rate Limiting - Built-in protection against spam

Multi-Channel Setup

```yaml webhooks: chat: "https://discord.com/api/webhooks/chat-webhook" log: "https://discord.com/api/webhooks/log-webhook" death: "https://discord.com/api/webhooks/death-webhook" punishment: "https://discord.com/api/webhooks/mod-webhook"

Events automatically route to appropriate channels

Falls back to 'log' webhook if specific webhook not configured

```

---

📞 Support & Community

- 🔧 Source Code: 🔧 Source Code - 🔧 Source Code: %%MD1%% - 🔧 Source Code: %%MD2%% - 🔧 Source Code: %%MD3%%

---

🆚 Why Choose AuryxDiscord?

vs Traditional Discord Bots:

- ✅ Better Integration - Runs directly on your Minecraft server - ✅ Better Integration - No JDA, just HTTP requests - ✅ Better Integration - No bot tokens or permissions needed - ✅ Better Integration - Direct access to server events and data

vs Other Discord Plugins:

- ✅ Rich Formatting - Built for Paper/Folia with async processing - ✅ Rich Formatting - 6MB vs 20MB+ for JDA-based plugins - ✅ Rich Formatting - Most plugins only do MC → Discord - ✅ Rich Formatting - Embeds, avatars, and advanced placeholders

vs EssentialsX Discord:

- ✅ Modern Codebase - Async processing and message queuing - ✅ Modern Codebase - HTTP server, multiple webhooks, embeds - ✅ Modern Codebase - Regular updates and new features - ✅ Modern Codebase - Java 21, latest APIs, clean architecture

---

📄 License

AuryxDiscord is licensed under the MIT License. See MIT License for details.

---

Made with ❤️ by Auryx Studio

*Requires AuryxCore for full functionality. Part of the complete Auryx server management suite!*

---

🚀 Quick Start

1. Enjoy: Download AuryxCore + AuryxDiscord 2. Enjoy: Add Discord webhook URLs to config 3. Enjoy: Use `/auryxdiscord test` command 4. Enjoy: Seamless Minecraft-Discord integration!

Transform your server communication today! 🎊💬