CraftHub
DSPlugMan

DSPlugMan

Remote Minecraft server management via Discord with full PlugMan integration

48 downloads
2 followers

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

DSPlugMan β€” your Minecraft server, always at your fingertips. πŸ”Œβœ¨