PlugMan

Table of Contents

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.

https://github.com/r-clancy/PlugMan

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.

Comments

_ForgeUser12439567

Join Date: 10/15/2013
Posts: 5
Member Details

#315 Posted Jun 15, 2014

Hi, i've translate this plugin into Traditional Chinese (zh_TW)!

# 
# 自定義訊息文件
prefix: '&7[&aPlugMan&7] '
disable:
  all: '&9已停用除本外掛外的所有外掛！'
  already-disabled: '&c已經停用 {0}！'
  disabled: '&9已停用 {0}！'
enable:
  all: '&9已啟用所有外掛！'
  already-enabled: '&c已經啟用 {0}！'
  enabled: '&9已啟用 {0}！'
error:
  ignored: '&cPlugMan已忽略此外掛！'
  invalid-plugin: '&c這不是一個可用的外掛！'
  no-permission: '&c你沒有權限來進行此操作！'
  specify-plugin: '&c你必須指定一個外掛！'
  usage:
    command: '&命令： &7{0}'
    description: '&9描述： &7{0}'
    usage: '&9使用方法： &7{0}'
help:
  header: '&7--------------------- [&a PlugMan &7] ---------------------'
  help: '&7- &a/plugman help &f- &7顯示本幫助'
  list: '&7- &a/plugman list [-v] &f- &7顯示所有外掛'
  dump: '&7- &a/plugman dump &f- &7將所有外掛的名稱及版本儲存至特定文件中'
  info: '&7- &a/plugman info [外掛名稱] &f- &7查看此外掛的資訊'
  usage: '&7- &a/plugman usage [外掛名稱] &f- &7查看此外掛所使用的命令'
  enable: '&7- &a/plugman enable [外掛名稱|all] &f- &7啟用此外掛'
  disable: '&7- &a/plugman disable [外掛名稱|all] &f- &7停用此外掛'
  restart: '&7- &a/plugman restart [外掛名稱|all] &f- &7重啟此外掛'
  load: '&7- &a/plugman load [外掛名稱] &f- &7載入此外掛'
  reload: '&7- &a/plugman reload [外掛名稱|all] &f- &7重新載入此外掛'
  unload: '&7- &a/plugman unload [外掛名稱] &f- &7取消載入此外掛'
info:
  header: '外掛資訊： {0}'
  version: '&7- 版本： &a{0}'
  authors: '&7- 作者： &a{0}'
  status: '&7- 狀態： {0}'
list:
  list: '&9外掛 (共{0}個)： {1}'
load:
  already-loaded: '&c已經載入 {0}！'
  cannot-find: '&c無法找到相關文件！'
  invalid-description: '&c此外掛含有錯誤描述！'
  invalid-plugin: '&c此文件並不是外掛！'
  loaded: '&9已啟用並載入 {0}！'
  plugin-dir: '&c無法找到外掛資料夾！'
reload:
  all: '&9已重新載入所有外掛！'
  reloaded: '&9已重新載入 {0}！'
restart:
  all: '&9已重啟所有外掛！'
  restarted: '&9已重啟 {0}！'
unload:
  failed: '&c無法取消載入 {0}！'
  unloaded: '&9已取消載入 {0}！'
updater:
  available: '&9有更新可用： &ahttp://dev.bukkit.org/bukkit-plugins/plugman/'
usage:
  usage: '&9命令： &7{0}'
dump:
  dumped: '&9已儲存外掛資訊至 {0}！'
  error: '&4無法儲存外掛資訊！'

_ForgeUser12425620
- Join Date: 10/12/2013
- Posts: 1
- Member Details
#314 _ForgeUser12425620

View User Profile

Send Message

Posted Jun 12, 2014
This plugin dont work anymore , find another plugin like this

Rollback Post to Revision RollBack
_ForgeUser12763297
- Join Date: 12/7/2013
- Posts: 22
- Member Details
#313 _ForgeUser12763297

View User Profile

Send Message

Posted Jun 1, 2014
@tobster78

You should never reload all your plugins. I'm surprised this feature is included. Some plugins simply aren't meant to be reloaded or they'll break.

Most plugins however are okay with it and things usually work okay if you selectively reload the plugins that actually need to be reloaded.

PlugMan isn't a substitute for plain old server restarts. Reloading all plugins has always been a dangerous thing to do and you should never do it.

Rollback Post to Revision RollBack
_ForgeUser9985041
- Join Date: 11/15/2012
- Posts: 51
- Member Details
#312 _ForgeUser9985041

View User Profile

Send Message

Posted May 24, 2014
/plugman reload all may as well just be /crashthewholebloodyserver

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#311 rylinaux

View User Profile

Send Message

Posted May 21, 2014
@PoopinSprinklez

PlugMan requires Java 7 or above to run properly - you aren't using that.

Rollback Post to Revision RollBack
_ForgeUser14200308
- Join Date: 4/19/2014
- Posts: 2
- Member Details
#310 _ForgeUser14200308

View User Profile

Send Message

Posted May 20, 2014
http://pastie.org/9194950 i don't know what happened

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#309 rylinaux

View User Profile

Send Message

Posted May 1, 2014
Version 2.0.2 has been uploaded and is awaiting approval. If you wish, you can download the build as #48 on my Jenkins.

This is a recommended update for all as it fixes the broken load command from 2.0.1, and fixes Updater running partially in the main thread that could cause lock-ups of the server.

Last edited by rylinaux: May 1, 2014

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#308 rylinaux

View User Profile

Send Message

Posted Apr 30, 2014
@luridftw32

@EnergizerBEAST1

@Ruan942

I should have some time this weekend to fix the load command - I see the problem but I just don't have the time right now.

Until then, you can safely downgrade back to 2.0.0 (just remember to disable the auto-updater), it works with the latest version of Bukkit.

Rollback Post to Revision RollBack
_ForgeUser10172414
- Join Date: 12/6/2012
- Posts: 156
- Member Details
#307 _ForgeUser10172414

View User Profile

Send Message

Posted Apr 30, 2014
Agreed, Please fix the Load command, It is very Important.

Rollback Post to Revision RollBack
_ForgeUser12943037
- Join Date: 1/3/2014
- Posts: 79
- Member Details
#306 _ForgeUser12943037

View User Profile

Send Message

Posted Apr 30, 2014
Indeed, the load command isn't working.
And that is 1 of the most command I use, so I don't have to reload all the time.
Pleas fix this fast.

Rollback Post to Revision RollBack
_ForgeUser7557739
- Join Date: 9/16/2011
- Posts: 115
- Member Details
#305 _ForgeUser7557739

View User Profile

Send Message

Posted Apr 29, 2014
Another issue: http://pastie.org/pastes/9126330/text?key=xvfegpzu2hypydv2szcmg (this is dependency related as well)

And this: http://pastie.org/pastes/9126351/text?key=dogulohoct7t7napralclg (the load command in PlugMan consists of dead code...)

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#304 rylinaux

View User Profile

Send Message

Posted Apr 28, 2014
@Ruan942

Thanks for the very detailed bug report, I should have some time coming over the next couple weeks to really dig into it.

As for the Updater, the file download doesn't run in the main thread (Updater makes a new thread and runs it in that), but I suppose the checks on my end for the result are in the main thread and would wait for the Updater to finish running - I suppose that could be moved to another thread as well. I hadn't thought about that in the past, thanks for the catch.

Rollback Post to Revision RollBack
_ForgeUser7557739
- Join Date: 9/16/2011
- Posts: 115
- Member Details
#303 _ForgeUser7557739

View User Profile

Send Message

Posted Apr 27, 2014
@rylinaux

I wish it was as easy as looking at the stack trace - I can reload the plugin fine on a test server with less plugins running on the same machine with the same java version and launch options. I think I've figured out the issue, actually - the plugin has a dependency. This dependency is running on both servers, but there's a method called which sort of invokes the dependency by calling a static method on the class.

Here's a way I managed to reproduce the issue: https:github.com/ruany/BreakPlugMan

Also: PlugMan just froze up my testing server completely. It checks for updates in the main thread. Really? Why? The config.yml I got with the plugin was mostly uncommented so I didn't know there was a 'none' option to updater-type. I'd have thought it would time out after 30 seconds or so, but no, it deadlocked the server.

Last edited by _ForgeUser7557739: Apr 28, 2014

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#302 rylinaux

View User Profile

Send Message

Posted Apr 27, 2014
@Mephisto43

That's great to hear, thanks!

@Ruan942

I would need the entire stack trace in order to debug the issue, along with the plugin the command is being run on - could you grab those for me?

Rollback Post to Revision RollBack
_ForgeUser7557739
- Join Date: 9/16/2011
- Posts: 115
- Member Details
#301 _ForgeUser7557739

View User Profile

Send Message

Posted Apr 27, 2014
I get a whole lot of "java.lang.LinkageError: loader constraint violation" errors when I reload a plugin. Any ideas?

Rollback Post to Revision RollBack
_ForgeUser12800618
- Join Date: 12/12/2013
- Posts: 11
- Member Details
#300 _ForgeUser12800618

View User Profile

Send Message

Posted Apr 26, 2014
wow, WOW! Dude, this plugin is an absolute miracle!

I have a nice batch of about 25 plugins which would typically crash the server sometimes when I typed /reload. I can definitely say that PlugMan is a HUGE improvement and allows me to disable and enable plugins on-the fly. You have definitely saved my server from constant crashes that would have really become a huge problem if this server were to go public today. Thank you Rylinaux.

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#299 rylinaux

View User Profile

Send Message

Posted Apr 24, 2014
Version 2.0.1 has been uploaded and is awaiting approval.

This version features some readability enhancements with the list command, a config option to silently ignore Metrics and Updater, better handling of plugins with names not matching their file, and the addition of a command that dumps plugins and versions to a file.

If you wish to download it before it's approved, you can do so on my Jenkins linked above as build #44.

EDIT: For this version, you will want to remove your old messages.yml file and let it regenerate to reflect the changes in formatting to the current values.

Last edited by rylinaux: Apr 28, 2014

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#298 rylinaux

View User Profile

Send Message

Posted Apr 23, 2014
@Thomas15v

I've been meaning to add something like for a while. Perhaps a better (or alternative) option would be to do "/plugman install (name)" for any plugin on BukkitDev and it would grab the latest version and load it on the server.

If you wanted to make a feature request on GitHub, that would be great.

Rollback Post to Revision RollBack
_ForgeUser11191196
- Join Date: 5/4/2013
- Posts: 23
- Member Details
#297 _ForgeUser11191196

View User Profile

Send Message

Posted Apr 22, 2014
Maybe an idea for a feature.

/plugman install <jar url>

Last edited by _ForgeUser11191196: Apr 22, 2014

Rollback Post to Revision RollBack
rylinaux
- Join Date: 5/19/2011
- Posts: 161
- Member Details
#296 rylinaux

View User Profile

Send Message

Posted Apr 15, 2014
The Jenkins has been moved over to the new server Intreppid has given me and can be found at http://ci.rylinaux.com/

I also have a paste service up and running at http://paste.rylinaux.com/ in-case anyone would like to use it.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.