UltraPluginManager (UPM)

UltraPluginManager (UPM) is a modern, safe, and advanced plugin management system for Spigot servers (1.18.2+). It serves as a robust alternative to PlugMan, featuring a clean architecture, asynchronous operations, and a user-friendly GUI.

✨ Features

• Plugin Management: Enable, Disable, Restart, Load, and Unload plugins dynamically.
• Modern GUI: A chest-based GUI to manage plugins visually with pagination and status indicators.
• Safety First:
  • Prevents disabling critical plugins (e.g., Vault, ProtocolLib, WorldGuard).
  • Checks for dependencies before disabling.
  • Detects circular dependencies.
• Async Operations: Heavy operations (like loading/unloading) are handled asynchronously to prevent server lag.
• Multi-Language Support: Built-in support for English (en) and Hungarian (hu), with the ability to add custom language files.
• Tab Completion: Full tab completion for all commands and file names.
• Hex Color Support: Beautiful chat and GUI formatting with Hex color codes.

📥 Installation

1. Ensure your server is running Java 17 or newer.
2. Download the UPM.jar.
3. Place the jar file into your server's plugins folder.
4. Restart the server.

🛠 Commands & Permissions

| Command | Alias | Description | Permission |
| :--- | :--- | :--- | :--- |
| /upm | | Shows the help menu. | upm.admin |
| /upm list | | Lists all plugins with their status. | upm.list |
| /upm enable <plugin> | | Enables a disabled plugin. | upm.enable |
| /upm disable <plugin> | | Disables an enabled plugin. | upm.disable |
| /upm reload <plugin> | | Reloads a specific plugin. | upm.reload |
| /upm reload | areload | Reloads the UPM configuration. | upm.reload |
| /upm load <file> | | Loads a jar file from the plugins folder. | upm.load |
| /upm unload <plugin> | | Unloads a plugin from memory (Use with caution). | upm.unload |
| /upm info <plugin> | | Shows detailed info (version, authors, deps). | upm.info |
| /upm gui | | Opens the Plugin Manager GUI. | upm.gui |
| /upm debug | | Toggles debug mode. | upm.debug |

Wildcard Permission: upm.admin grants access to all commands.

⚙️ Configuration

The config.yml allows you to customize the plugin's behavior.

# Language setting (en, hu, or custom)
language: en

# Toggle debug messages in console
debug-mode: false

# GUI Title
gui-title: "&9&lUPM &8- &bPlugin Manager"

# Plugins that cannot be disabled/unloaded via UPM
protected-plugins:
  - "Vault"
  - "ProtocolLib"
  - "LuckPerms"
  - "WorldEdit"
  - "WorldGuard"
  - "UPM"

Language Support

UPM generates lang_en.yml and lang_hu.yml by default. To create a new language:

1. Copy lang_en.yml and rename it (e.g., lang_it.yml).
2. Translate the messages.
3. Set language: it in config.yml.
4. Run /upm reload.

⚠️ Warning Regarding unload and reload

While UPM uses advanced techniques to unload plugins (closing ClassLoaders, clearing references), Java's architecture makes "clean" unloading difficult without a full server restart.

• Use /upm reload for development: It is great for testing small changes in your own plugins.
• Avoid reloading complex plugins: Plugins with heavy packet usage (ProtocolLib) or complex dependency injections may not reload cleanly.
• Memory Leaks: Repeatedly loading/unloading plugins can lead to Metaspace memory leaks over time. Always restart your server for production changes.

👨‍💻 Developer

Created by Ywxlol.