🌐 WEBSITE: https://lynx-development.lynx197.qzz.io/

🔌 Dynamic Discord UM+

A Self-Contained, High-Performance Discord Status Bot for Minecraft

Dynamic Discord UM+ is a modern Spigot/Paper plugin that seamlessly connects your Minecraft server to Discord without any external bot hosting. Instead of relying on limited Java-only Discord implementations, the plugin automatically deploys and manages a full Node.js environment directly inside your server directory, delivering a powerful, reliable, and feature-rich Discord status system.

---

✨ Key Features

📡 Real-Time Server Status

• Maintains one persistent, pinned embed message in a configured Discord channel
• Updates automatically at a configurable interval (default: 30 seconds)
• Displays live server data:
  • Online Players / Max Players
  • Server Uptime
  • Latency (Ping)
• Automatically fetches and displays:
  • Minecraft Server Version
  • Server Country / Location

---

🎨 Smart Embed System

• Online Mode
  • Customizable embed color (default: green)
  • Full real-time statistics
• Offline Mode
  • Instantly switches to OFFLINE (red embed)
  • Displays the exact time the server went down
• Banner Support
  • Optional custom server banner image displayed in the embed

---

⚡ Hybrid Technology

• Powered by discord.js for a modern, responsive Discord bot experience
• Uses minecraft-server-util for accurate external pings
  • Supports both Java Edition and Bedrock Edition servers

---

🚀 Zero-Hassle Installation

• No manual Node.js setup required
• Automatic OS detection (Windows / Linux)
• Downloads an isolated Node.js binary directly into the plugin folder
• Automatically installs all required npm packages on first startup
• Fully self-contained and portable

---

⚙️ Configuration

All settings are managed through a simple config.yml file:

🔐 Bot Settings

• Discord Bot Token
• Target Channel ID

🖥 Server Details

• Server IP
• Server Port
• Display Name

🎨 Visual Customization

• Custom Hex colors for Online and Offline states
• Toggle banner image on or off

⚡ Performance

• Adjustable update interval to balance real-time accuracy and Discord API usage

---

🛠 Technical Overview

🔄 Initialization

• On server startup, the plugin checks for a local node directory
• If missing, it downloads a portable Node.js runtime (v18.x) compatible with the host OS

🔗 Java ↔ Node Bridge

• Extracts the bundled bot.js
• Installs required npm dependencies automatically

▶ Execution

• Launches the Discord bot as a managed Node.js sub-process

🔔 Graceful Shutdown Handling

• When the Minecraft server stops or crashes:
  • The plugin signals the bot to update the Discord embed to OFFLINE
  • Ensures users always see the correct server state
  • Cleanly terminates the Node.js process afterward

---

Dynamic Discord UM+ delivers a clean, powerful, and future-proof way to keep your Discord community informed — all from inside your Minecraft server.

---

Note: Does not work on servers with DDoS protection.

---

---