This is a PlugMan *Fork*

PlugMan

PlugMan is a simple, easy to use plugin that lets server admins manage plugins from either in-game or console without the need to restart the server.

Features

• Enable, disable, restart, load, reload, and unload plugins from in-game or console.
• List plugins alphabetically, with version if specified.
• Get useful information on plugins such as commands, version, author(s), etc.
• Show hard dependencies, soft dependencies, and plugins that depend on a target plugin.
• Easily manage plugins without having to constantly restart your server.
• List commands a plugin has registered.
• Find the plugin a command is registered to.
• Tab completion for command names and plugin names.
• Dump plugin list with versions to a file.
• Check if a plugin is up-to-date with dev.bukkit.org
• Load and reload modern Paper plugins that use paper-plugin.yml.
• Runtime load, unload, and reload support for Velocity plugins.
• Clean up classloader-owned Velocity 3.4+ packet registrations during unload and rollback.
• Clean up Paper plugin manager state, commands, listeners, and provider storage on unload.
• Reload/restart dependent plugins in a safer order and optionally limit dependent reloads.
• Confirm dangerous bulk reload/restart operations before affecting many plugins.
• Optional Paper reload diagnostics with paperReloadDebug.
• Permissions Support - All commands default to OP.

Warning

Building the Velocity module requires JDK 25 or newer, but its output targets Java 21 and can run on a Java 21 or newer Velocity proxy. The Paper, Bukkit, Bungee, and Core modules also require Java 21 or newer.

Velocity does not expose an official runtime unload API. PlugManX checks the required runtime capabilities before enabling it, but some plugins may still require a full proxy restart. Velocity also has no separate enabled/disabled plugin state. On Velocity, /plugman enable loads a previously unloaded plugin and /plugman disable fully unloads it. All PlugManX Velocity commands are restricted to the proxy console. The proxy command is hidden from players so /plugman can be forwarded to a backend Paper server that also runs PlugManX.

Commands

Command	Description
/plugman help	Show help information.
/plugman list [-v]	List plugins in alphabetical order. Use "-v" to include versions.
/plugman info [plugin]	Displays information about a plugin.
/plugman dump	Dump plugin names and version to a file.
/plugman usage [plugin]	List commands that a plugin has registered.
/plugman deps [plugin]	Show dependencies and dependent plugins for a plugin.
/plugman lookup [command]	Find the plugin a command is registered to.
/plugman enable [plugin|all]	Enable a plugin; on Velocity, this loads it.
/plugman disable [plugin|all]	Disable a plugin; on Velocity, this fully unloads it.
/plugman restart [plugin|all]	Restart a plugin; on Velocity, this performs unload/load.
/plugman load [plugin]	Load a plugin.
/plugman reload [plugin|all]	Reload (unload/load) a plugin.
/plugman reloadconfig	Reload PlugMan config and messages.
/plugman reloadmode [mode]	View or change dependent reload mode.
/plugman unload [plugin]	Unload a plugin.
/plugman check [plugin|all] [-f]	Check if a plugin is up-to-date.

Reload Modes

/plugman reloadmode controls which dependent plugins are reloaded together with the target plugin:

Mode	Description
ALL	Reload plugins with hard depend and softdepend links.
REQUIRED_ONLY	Reload only plugins with a required depend link.
OFF	Do not reload dependent plugins automatically.

On Velocity, critical plugins such as PlugManX, LuckPerms, and Geyser are protected by default. Reloading, restarting, disabling, or unloading them requires --force and the matching <command>.force permission.

Permissions

Permission Node	Default	Description
plugman.admin	OP	Allows use of all PlugMan commands.
plugman.update	OP	Allows user to see update messages.
plugman.help	OP	Allow use of the help command.
plugman.list	OP	Allow use of the list command.
plugman.info	OP	Allow use of the info command.
plugman.dump	OP	Allow use of the dump command.
plugman.usage	OP	Allow use of the usage command.
plugman.deps	OP	Allow use of the deps command.
plugman.lookup	OP	Allow use of the lookup command.
plugman.enable	OP	Allow use of the enable command.
plugman.enable.all	OP	Allow use of the enable all command.
plugman.disable	OP	Allow use of the disable command.
plugman.disable.all	OP	Allow use of the disable all command.
plugman.restart	OP	Allow use of the restart command.
plugman.restart.all	OP	Allow use of the restart all command.
plugman.load	OP	Allow use of the load command.
plugman.reload	OP	Allow use of the reload command.
plugman.reload.all	OP	Allow use of the reload all command.
plugman.reloadconfig	OP	Allow use of the reloadconfig command.
plugman.reloadmode	OP	Allow use of the reloadmode command.
plugman.unload	OP	Allow use of the unload command.
plugman.check	OP	Allow use of the check command.
plugman.check.all	OP	Allow use of the check command.

Configuration

File	URL
config.yml	https://github.com/Test-Account666/PlugManX/blob/master/plugman-core/src/main/resources/config.yml

Important options:

Option	Default	Description
ignored-plugins	See config	Plugins PlugManX should not manage.
showVelocityWarning	true	Shows the Velocity runtime warning at startup.
paperReloadDebug	false	Enables extra Paper reload diagnostics in console.
reloadDependentsMode	REQUIRED_ONLY	Controls dependent reload behavior for reload/restart operations.

Building

Build Instructions

Building PlugManX is simple:

1. Clone the repository:

   git clone https://github.com/Test-Account666/PlugManX.git
   cd PlugManX

2. First Build

   mvn install -N
   cd plugman-paper
   mvn paper-nms:init
   cd ..

3. Build the project:

   mvn clean install

   The full reactor includes the Velocity module and therefore requires JDK 25. The resulting Velocity JAR targets Java 21. To build only Velocity and its required modules, use:

   mvn -pl plugman-velocity -am clean package

4. Find the built artifacts:

   • Individual module JARs will be in each module's target/ directory
   • For Velocity, use plugman-velocity/target/PlugManX-<version>.jar
   • The assembled distribution will be in plugman-assembly/target/

Version Management

PlugManX uses a centralized version property for easy version management across all modules. To update the version:

1. Edit the <plugman.version> property in the root pom.xml file
2. The version will automatically be updated in all modules and resource files during build

Current version is managed by the plugman.version property in the parent POM.

Developers

Maintenance instructions for adding messages, finding Paper API classes, and updating Paper reload compatibility are documented in DEVELOPMENT.md.

How to include PlugMan with Maven:

<repositories>
    <!-- PlugMan -->
    <repository>
        <id>PlugManX</id>
        <url>https://raw.githubusercontent.com/Test-Account666/PlugManX/repository/</url>
    </repository>
</repositories>

<dependencies>
<dependency>
    <groupId>com.rylinaux</groupId>
    <artifactId>PlugManX</artifactId>
    <version>${plugman.version}</version>
    <scope>provided</scope>
</dependency>
</dependencies>

How to include PlugMan with Gradle:

repositories {
    maven {
        name = 'PlugManX'
        url = 'https://raw.githubusercontent.com/Test-Account666/PlugManX/repository/'
    }
}
dependencies {
    compileOnly 'com.rylinaux:PlugManX:${plugman.version}'
}

License

This project is a fork of PlugMan (Link no longer works) and is distributed under the same license: LICENSE.