PlugMan
What is 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.
- Easily manage plugins without having to constantly restart your server.
- List commands a plugin has registered.
- Find which 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
- Permissions Support - All commands default to OP.
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 | Dumps plugin list and versions to a file. |
/plugman usage [plugin] | List commands that a plugin has registered. |
/plugman lookup [command] | Find which plugin a command is registered to. |
/plugman enable [plugin| all] |
Enable a plugin. |
/plugman disable [plugin| all] |
Disable a plugin. |
/plugman restart [plugin| all] |
Restart (disable/enable) a plugin. |
/plugman load [plugin] | Load a plugin. |
/plugman reload [plugin| all] |
Reload (unload/load) a plugin. |
/plugman unload [plugin] | Unload a plugin. |
/plugman check [plugin| all] [-f] |
Check if a plugin is up-to-date. |
Permissions
Permission Node | Default | Description |
---|---|---|
plugman.admin | OP | Allow use of all PlugMan commands. |
plugman.update | OP | Allow 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.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.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 all comamnd. |
Configuration
File | URL |
---|---|
config.yml | https://github.com/r-clancy/PlugMan/blob/master/src/main/resources/config.yml |
Source
PlugMan is open source and hosted on GitHub; feel free to fork, star, or contribute to PlugMan by making pull requests and opening issues.
Sponsors
To view those who enable this project to be developed, please refer to the GitHub page.
Tutorial
Samkio has made a tutorial showing the basic usage of the plugin.
User Content
- Logo: HariboPenguin
- Tutorials
- English (Samkio): http://www.youtube.com/watch?v=E_vQSEfYckA
- Spanish (cloud_strife_91spain): https://www.youtube.com/watch?v=euJH1XGunAk&feature=youtu.be
- German (ThePhantom123): https://www.youtube.com/watch?v=SYJfpGJQlvM&feature=youtu.be
- Portuguese (AbsintoJ): https://www.youtube.com/watch?v=VfoB6HlVeYQ
Notes
- PlugMan requires (at least) Java 7 to run.
- If you have an error, please use a paste service (such as http://hastebin.com/) instead of the comment box.
@Liger_XT5
I'll have some time over the coming weeks to look into this, thanks for the error.
If you encounter any other plugins that have the same issue, please do let me know.
@mario3232
Which plugins? Are the errors being thrown that you could give me?
@mario3232
I can some-what vouch for mario3232.
I've come along a number of plugins that do not like to be loaded (either being unloaded or added since server last startup).
Example: Recently needed to unload MythicDrops. Made my config changes, and attempted to load it up with /plugman load MythicDrops (file is MythicDrops.jar) and the response is: That file is not a valid plugin.
Not sure what to go by for the actual name for loading such plugins. NoCheatPlus is the same way.
The first plugman load MythicDrops v3.1.0-SNAPSHOT-b384-STABLE with the file name of MythicDrops v3.1.0-SNAPSHOT-b384-STABLE.jar
The second plugman load MythicDrops v3.1.0-SNAPSHOT-b384-STABLE with file called MythicDrops.jar.
The third is with a simple /plugman load mythicdrops with MythicDrops.jar
uhhh....when i reloaded some plugins they broke and now they wont work ive disabled them and reinstalled them still wont show up in /plugins and plugman wont reload them saying they are not valid plugins when clearly I was able to reload them before >.> Not sure how this even happened anyone else ever have this problem????
@Iwitrag
It works fine with the latest version of MC, it's not prone to breaking.
@frol1
I won't have much time until next week, but I can definitely add this. If you wanted to make a feature request on GitHub, that would be great.
Hey mate,
I was wondering if I could suggest an update to the plugin? It would be awesome if there was a command that is essentially the same as /plugman list -v but it makes a text file?
@Bimmr
Something weird is going on there, I've never seen it before.
If you're reloading a plugin of that complexity, perhaps just restarting the server is a better idea. Unload is hackish by nature, there are no native methods to unload a plugin.
Not sure if theres a problem with Infected, or what, but when I use /Plugman reload Infected I get this error http://pastebin.com/ypvG6uRn . It only happens when I reload using this command
Intreppid is now sponsoring PlugMan in terms of hosting for the Jenkins build server and a test development platform!
@ChengZi368
Thanks, glad to hear!
@Iwitrag
I guess you can think of disable as a soft unload. It unregisters the commands and listeners. Unload, however, attempts to completely remove the plugin from the server which includes everything disable does, and more such as removing from the plugin list, closing the ClassLoader, and removing the lock the OS has on the file.
@Liger_XT5
Are there any errors printed out to the console?
The proper name should be found inside the plugin's "plugin.yml" located inside the jar (but it's normally the same as the plugin itself).
What difference is between unload and disable?
How does one go about finding the exact name of a plugin to load?
I decided to unload our NoCheatPlus to redo the config, when I tell it to load, it says the file is not a valid plugin. I've seen this happen on a lot of other plugins, which is rather annoying.
Otherwise, I love the plugin, it has helped a lot with adding in plugins while the server is running, turning off others while debugging issues, and reloading those that do not have built in reload commands, let alone easier to update plugins without restarting the server.
Really useful! I cant live without this! Keep updaing it :)
@tobster78
Good to hear, glad you enjoy it!
Awesome plugin! This will be so useful for me, thanks!
@Ath1n
If you wouldn't mind, could you stick the entire error onto pastebin so I can take a look as to why it occured?
@Ath1n
Glad you got it working! Thanks for bringing this issue to my attention, however, it's interesting that it fails to work with a 32-bit JVM.
@rylinaux
Ha! I installed a 64 bit version of Java 7 and it is running fine now! Thanks for this plugin, keep up the good work :)
@rylinaux
So I tried it on my desktop (windows 7) and it works fine. However on my Mac (the server) it will not start. I have verified that both the desktop and the server are running Java 7 Update 51. Yet it throws me an error for the server. Any ideas?
@rylinaux
Mac os also auto updates java so im pretty sure Im using the correct version as there is only one version. I would really like to get this amazing plugin up and running but can not seem to find out the problem.