Dynamic Discord UM+ ( Uptime Monitor )

🌐 **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. --- ---