DSPlugMan — The Ultimate PlugMan Addon

🔄 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

Build the project: ./gradlew shadowJar (the JAR will be in build/libs/).
Put the plugin JAR into your server's plugins/ folder.
Start the server to generate config.yml.
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.
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. 🔌✨