Help Plus
This project is now inactive, for more information see comment http:dev.bukkit.org/bukkit-plugins/help-plus/?comment=136
HelpPlus is an automated database-powered help plugin. It collects all commands from all your plugins and displays them when you type /help.
Features
- Displays all commands from all plugins
- Help is split up into pages
- No need to write your own documentation on commands if you don't want to (description of a lot of commands is stored in plugins' ymls)
- Configurable colors
- Fast help search (SQL)
- Players who don't have permission to use some command won't see the command. - Doesn't have to work for every command, but covers most commands.
- From version 1.0, plugin is more efficient
Command usage
- /help - Displays 1st page of commands
- /help [page] - Displays specified page of commands
- /help <command> - Displays information about single command
- /hplisting - Lists all your commands & permission nodes into a single TXT file
- /hpexport - Exports specified command to config file for overriding. Can be used like /hpexport <command name> or with patterns like /hpexport -p <pattern>
- You can always type /h+ or /hp instead of /help if you want.
Installation
Download HelpPlus.jar and copy it to your plugins folder.
What does it display?
- Command name
- Permission needed for command(if any) - Important note: some commands don't include information about what permission do you need, so even if you setup everything right, it doesn't have to work.
- Usage
- Command aliases
Configuration
On the first launch, HelpPlus generates its own configuration file. If not, you can create it manually( it must be located in plugins/HelpPlus and must be named config.yml ) by copying an example one from this page.
Configuration Nodes
- perms - Permissions system to use. Possible values(must exactly match): OP, None, SP.
- cmds-on-page - How much commands to display on one page
- colors.a - 1st color (default = blue) Possible values(can be lowercase): BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE.
- colors.b - 2nd color (default = gold) Possible values = same as above
- colors.c - 3rd color (default = green) Possible values = same as above
- show.plugin - Whether the user should see which plugin takes care of specified command( true/false )
- help.perm - Whether you need permission(helpplus.help) to use /help (true or false)
- commands - See Page "Overriding commands' info"
- config-is-primary - If configuration should override information in database
Where are those information from?
Information are downloaded on each plugin list change or bukkit version change from plugins' ymls. If you're a plugin developer, please always put information about your commands into your plugins' ymls. Thanks. Don't know how to format commands in plugin.yml? Check page 'Formatting commands in plugin.yml'
Permissions
- If you set help.perm to true in your config file, your users need to have permission "helpplus.help" to use /help.
- helpplus.listing is needed for /hplisting command.
- helpplus.hpexport is needed for /hpexport.
Achievement get!

Contact Author
If you wish to contact author somewhere else, you can do so on:
- Blog: http://tomsik68.blogspot.com/
- Twitter: https://twitter.com/tomsik68
- E-Mail: tomsik68@gmail.com
- GitHub: https://github.com/tomsik68 (also, sources of all plugins!)
- Skype: Tomsik68 (my pic is redstone dust ;) )
-
View User Profile
-
Send Message
Posted Aug 30, 2012@sehunpark
HelpPlus doesn't seem to know which permission is neccessary for the command. There's however a way to fix that. You need to manually set permission for every command that has permission set to 'null' or hasn't got the line with permission node. Check page Overriding commands' info. There's everything you need to know to do that.
-
View User Profile
-
Send Message
Posted Aug 30, 2012@tomsik68
I use PermissionsEx and know fully well on how to use permissions and such.Also,the perms are set on SP.The players still get all commands shown.Any help?
-
View User Profile
-
Send Message
Posted Aug 29, 2012@Calenria Your problem is, that some data, which plugin is trying to store to database are too long. Could you please paste/e-mail me your config.yml with commands? I could do that for you. Please don't paste it to your comment. Use something like pastebin.com, pastie.org or dev.bukkit.org/paste and put the link to the comment. @sehunpark
What you want is a good (or maybe better ;) ) permission plugin. The "ranks" you mentioned are called "permission groups". Each group has its permissions. You should look at few of them and decide which fits you mostly. I've been looking at some of them and this one looks mostly maintained and easy: http:dev.bukkit.org/server-mods/bpermissions/ . And HelpPlus only needs change in config file. Set perms to SP (must be UPPERCASE). So again: You need to get a plugin which handles the ranks or groups. Create rank "New" and give it permission your spawn plugin uses for /spawn command(e.g. spawnx.spawn). In helpplus's config file, set perms to "SP" and that's it for one command. You really need to play with permission for long. If you have any problems, just ask ;).
-
View User Profile
-
Send Message
Posted Aug 29, 2012@tomsik68
Sorry but that's not what I meant.I should've made it clearer.I mean if you can make it so that it has "rank support." For example:New has permissions to use /spawn , /help , /tpa ,etc. I want them to be able to use the command /hp or /help but ONLY see the commands they are allowed to use.Instead of seeing every single command that is available to the server.
-
View User Profile
-
Send Message
Posted Aug 28, 2012there is no [server folder]/plugins/HelpPlus/HelpPlus.db it is mysql
Bukkit database config:
database:
username: minecraft
isolation: SERIALIZABLE
driver: com.mysql.jdbc.Driver
password: 12345 ;)
url: jdbc:mysql://localhost:3306/minecraft
-
View User Profile
-
Send Message
Posted Aug 28, 2012@sehunpark
There's already a permission support. Setup: set "help.perm" to "true" in config file, and set perms to OP. That makes only OPs see the help.
@Calenria
Try to delete [server folder]/plugins/HelpPlus/HelpPlus.db . It may help.
-
View User Profile
-
Send Message
Posted Aug 28, 2012Startup, mysql db:
https://gist.github.com/3505600
-
View User Profile
-
Send Message
Posted Aug 28, 2012The essentials /help command is glitched and will not allow any of my players to use the permission so I cam to see and use this plugin..It's great but I have just 1 request.May you be able to add permission support?It would be nice since even my default players can see the same amount of pages as Ops.
-
View User Profile
-
Send Message
Posted Aug 27, 2012@Gunnerrrrr
I know exactly where the problem is. The fix will be very quick.
-
View User Profile
-
Send Message
Posted Aug 27, 2012on startup:
03:37:24 [INFO] [HelpPlus] Error trace:
03:37:24 [SEVERE] org.bukkit.command.CommandException Unhandled exception executing command 'buycraft:ec' in plugin Buycraft v4.6
03:37:24 [SEVERE] at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
03:37:24 [SEVERE] at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:168)
03:37:24 [SEVERE] at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:492)
03:37:24 [SEVERE] at org.bukkit.Bukkit.dispatchCommand(Bukkit.java:199)
03:37:24 [SEVERE] at sk.tomsik68.helpplus.HelpPlus$1.run(HelpPlus.java:121)
03:37:24 [SEVERE] at org.bukkit.craftbukkit.scheduler.CraftWorker.run(CraftWorker.java:34)
03:37:24 [SEVERE] at java.lang.Thread.run(Unknown Source)
03:37:24 [SEVERE] Caused by: java.lang.NullPointerException
03:37:24 [SEVERE] at net.buycraft.BukkitInterface.onCommand(BukkitInterface.java:114)
03:37:24 [SEVERE] at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
03:37:24 [SEVERE] ... 6 more
-
View User Profile
-
Send Message
Posted Aug 23, 2012Can you make it so that the plugin has rank support?The rank "New" is able too see all the commands that OP has.
-
View User Profile
-
Send Message
Posted Aug 18, 2012@KiloWhiskey It seems like your database setup in bukkit.yml is incorrect(My guess is based on "Access denied for user 'username'@'localhost'"). Try checking it. If you don't know how to set it up, just check bukkit.yml @ bukkit wiki. It's described pretty good there. If it's not the problem, try loading HelpPlus via reload command.
-
View User Profile
-
Send Message
Posted Aug 18, 2012So I tried to run this plugin for the first time (never installed before) and I'm getting this http://pastebin.com/HPdqUU5m and when I tried to load the .jar with PlugMan it says that it's not a valid plugin file. Any help would be great.
-
View User Profile
-
Send Message
Posted Aug 14, 2012@breezeyboy
Github => https://github.com/tomsik68/HelpPlus
-
View User Profile
-
Send Message
Posted Aug 12, 2012source code?
-
View User Profile
-
Send Message
Posted Aug 4, 2012@donbuster66
The listing file is possible, however, as I say probably every time, it doesn't have to work correctly with every command or permission node. Since the permission resolver doesn't know which permission does the plugin come from, most of the permissions wouldn't get listed correctly. Command listing doesn't have to fail that much, but commands may also not be indexed correctly. All of your features will be implemented. I've just wanted you to know that they doesn't have to work great everytime ;) .
-
View User Profile
-
Send Message
Posted Aug 4, 2012Feature request: I'm not sure if this will be easy, but I'm sure it's possible, you should add a section in the folder that lists all commands, nodes, what plugin they are from and, if there are multiple plugins using the same command, allow you to change which one has dominance, like if you have 2 plugins that do /butcher, you can choose witch one actually executes the command.
-
View User Profile
-
Send Message
Posted Jul 1, 2012@AcidSikeO
Ok, I'll add it. However, I'll also include option to disable that, since I think most users will want it like: if you can use the command, you can also get help for it and see it in commands listing. EVERYONE ELSE: ANY FURTHER IDEAS TO INCLUDE IN PLUGIN? :)
-
View User Profile
-
Send Message
Posted Jul 1, 2012Could you maybe add a permission or a config option allowing us to limit who can use the /help command? If my users need help with a specific command, that's what my admins are for.
-
View User Profile
-
Send Message
Posted Jun 19, 2012Ah, after fixing some things, it appears everyone sees the 57 pages of commands OPs see..