AuryxDiscord

# 💬 AuryxDiscord - Lightweight Minecraft-Discord Integration

!(https://img.shields.io/badge/Version-1. 0. 0--SNAPSHOT-blue?style=for-the-badge) !(https://img.shields.io/badge/Minecraft-1. 8. 8--1. 21. 10-green?style=for-the-badge) !(https://img.shields.io/badge/Platform-Paper%20%7C%20Spigot%20%7C%20Folia%20%7C%20Purpur%20%7C%20Velocity-orange?style=for-the-badge) !(https://img.shields.io/badge/License-MIT-red?style=for-the-badge)

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.

## ✨ Key Features

### 💬 Two-Way Communication - Minecraft → Discord - Chat messages, events, notifications via webhooks - Discord → Minecraft - Messages from Discord appear in-game via HTTP server - Real-time sync - Instant message delivery with async processing - No JDA dependency - Lightweight HTTP-only implementation

### 🎮 Server Events Integration - Join/Leave Messages - Player connection notifications with custom formats - Death Messages - Death notifications with cause and custom formatting - Chat Synchronization - Full chat integration with AuryxChat support - Punishment Alerts - Ban/mute/kick notifications for moderation teams - Server Status - Startup/shutdown notifications

### 🎨 Rich Formatting & Customization - Discord Embeds - Beautiful rich messages with colors and timestamps - Player Avatars - Automatic player head integration via Minotar - Custom Formats - Fully customizable message templates for each event type - Placeholder Support - PlaceholderAPI and AuryxCore placeholder integration - Emoji Support - 🟢 Join, 🔴 Leave, ☠️ Death, ⚠️ Punishments

### 🔧 Advanced Configuration - Multiple Webhooks - Separate channels for chat, logs, deaths, punishments - Event Filtering - Enable/disable specific event types - Message Queuing - 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 ` | Send test message to Discord | `auryxdiscord.test` | | `/auryxdiscord info` | View plugin status and integration info | `auryxdiscord.info` |

## 🔄 How It Works

### Minecraft → Discord Flow 1. Event Detection - Listeners capture chat, join/leave, death events 2. Message Formatting - Apply custom templates with placeholders 3. Webhook Delivery - Send via OkHttp to Discord webhook URLs 4. Queue Management - Async processing prevents server lag

### Discord → Minecraft Flow 1. HTTP Server - Built-in Jetty server receives Discord webhooks 2. Message Processing - Parse and validate incoming Discord messages 3. Chat Integration - Forward to AuryxChat or broadcast directly 4. Security - Webhook signature verification for safety

## 📋 Message Examples

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

### Minecraft Chat ``` DiscordUser: Hello from 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: "⚠️ {staff} 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 | |----------|--------|----------| | Paper | ✅ Full Support | All features available | | Folia | ✅ Full Support | Thread-safe implementation | | Spigot | ✅ Compatible | Core features work | | Bukkit | ✅ Compatible | Basic functionality | | Purpur | ✅ Enhanced | Additional optimizations | | Velocity | ✅