DSPlugMan — The Ultimate PlugMan Addon

🇷🇺 Русская версия (Russian Version)

🔄 Remote Minecraft server management via Discord with full PlugMan integration

---

⚠️ Important Requirement

DSPlugMan is an addon for PlugManX.
For most plugin management features to work, PlugMan or its modern fork PlugManX MUST be installed on the server.

---

🚀 Key Features

🛠️ Interactive Management (GUI)

• Selection menu – the /plugins command displays an interactive list with a dropdown selector.
• Control buttons – quick actions for each selected plugin: Enable, Disable, Reload, Delete.
• Live update – the 🔄 Refresh button instantly updates the list without re‑typing the command.

📝 Remote Console & Management

• Command execution – the /console command lets you send any command to the server console directly from Discord.
• Status monitoring – /status shows memory usage, player count, uptime and server software version.
• Configuration management – view and adjust plugin settings with /config on the fly without reopening files.

📥 Smart Plugin Upload

• URL upload – /upload_plugin downloads a JAR from a link and activates it via PlugMan automatically.
• Drag‑and‑drop – drop a .jar file into the configured Discord channel and the bot will install it on the server.
• Auto‑reload – if an existing plugin file is replaced, the plugin is automatically reloaded.

🔐 Security & Logging

• Role & user access – bot permissions can be restricted by both Discord User ID and Role ID.
• Admin whitelist – /add_admin and /remove_admin for quick access management.
• Log channel – all sensitive actions (plugin deletion, console use, uploads) can be mirrored to a separate log channel for audit.

---

💻 Command List

Plugin Management

• /plugins — display a list of all plugins with control buttons.
• /reload_plugin <name> — reload a specific plugin.
• /enable <name> — enable a plugin.
• /disable <name> — disable a plugin.
• /delete_plugin <name> — completely remove a plugin from the server (including the file).
• /upload_plugin <url> [filename] — upload a plugin from a direct URL.

System Commands

• /status — show server status (RAM, online players, uptime).
• /console <command> — execute a command as console.
• /reload — reload all server plugins (/reload).

Administration

• /config [property] [value] — view and change DSPlugMan configuration at runtime.
• /add_admin <user> — add a user to the bot’s admin list.
• /remove_admin <user> — remove a user from the admin list.

---

📋 Requirements

• Game: Paper/Spigot 1.21.4
• Java: 21
• Dependencies: PlugManX (recommended)
• Discord: a bot created in the Discord Developer Portal with Message Content Intent enabled.

---

🛠️ Installation

1. Build the project: ./gradlew shadowJar (the JAR will be in build/libs/).
2. Put the plugin JAR into your server’s plugins/ folder.
3. Start the server to generate config.yml.
4. Open the config and set:
   • token – your Discord bot token.
   • guild-id – your Discord server ID.
   • channel-id – the ID of the text channel used for management.
   • admin-users – (optional) list of Discord User IDs with access.
   • management-role-id – (optional) role ID that grants access to commands.
5. Reload the plugin or restart the server.

---

🌐 Language Configuration

You can change the bot's language in config.yml. Supported languages: en (English), ru (Russian).

language: "en"

---

🐞 Known Issues

• Plugin deletion: in some environments deleting a plugin may fail due to file locks or PlugManX limitations (the JAR remains on disk or in use). A more reliable deletion flow is planned for a future update.

---

🔗 Links

• Bio / Socials: https://guns.lol/kasperenok
• Kasper Studios Discord: https://discord.gg/dYStejMq6d
• Donate / Support: https://donatello.to/kasperenok

---

DSPlugMan — your Minecraft server, always at your fingertips. 🔌✨