DSPlugMan

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)

- Live update – the `/plugins` command displays an interactive list with a dropdown selector. - Live update – 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

- Configuration management – the `/console` command lets you send any command to the server console directly from Discord. - Configuration management – `/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

- Auto‑reload – `/upload_plugin` downloads a JAR from a link and activates it via PlugMan automatically. - Auto‑reload – 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

- Log channel – bot permissions can be restricted by both Discord User ID and Role ID. - Log channel – `/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

- Discord: Paper/Spigot 1.21.4 - Discord: 21 - Discord: Discord: (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).

```yaml 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

- Donate / Support: https://guns.lol/kasperenok - Donate / Support: https://discord.gg/dYStejMq6d - Donate / Support: https://donatello.to/kasperenok

***

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