AdvancedHelp is a total customizable '/help' command for your server! Best Custom help page plugin out there! Help your players by showing them the ropes of the server. Create categories to further help your players out! Sick of seeing the default essentials /help? Don't want to show what plugins you have through your /help? Want to customize your server more with an awesome /help command? Download AdvancedHelp today!
✼ Unlimited Pages/Text ✼ Create custom categories ✼ Supports JSON ✼ Supports every language ✼ Use /? to view Bukkit's help(with help.override perm) ✼ Create a custom GUI ✼ Create unlimited amount of GUIs ✼ Supports PAPI ✼ Supports HeadDataBase ✼ Works in 1.7+ ✼ Customize everything to your liking! ✼ Use the players head in the GUI! ✼ Bungee /server command Support! ✼ Tab Completion for categories!
What to know about the GUI: **You must use 1.13+ Block ID names** Different runs:
GUI - opens another AdvancedHelp GUI!
CATEGORY - displays an AdvancedHelp category!
PAGE - displays an AdvancedHelp help page!
PLAYER-CMD - run a command through the player!
CONSOLE-CMD - run a command through the console!
COSMETIC - just for looks!
SERVER - runs the /server bungee command!
run: MESSAGE
value:
- "This is where you write stuff"
- "You can have multiple lines of message"
- "Also supports JSON / PAPI / HEX"
Running a PAGE number
Code (Text):
run: PAGE
value: <page-number>
Running a PLAYER-CMD
Code (Text):
run: PLAYER-CMD
value:
- "feed"
Running a CONSOLE-CMD
Code (Text):
run: CONSOLE-CMD
value:
- "heal %player%"
Just for looks! COSMETIC
Code (Text):
run: COSMETIC
Running the bungee SERVER command
Code (Text):
run: SERVER
value: <SERVER-NAME>
- You must use 1.13+ block ID names, you cannot use numbers(example polished_granite not 1:2)
- 1.13+ block ID list can be found
here - Example2: instead of 160:5 use lime_stained_glass_pane
- If the item is not found it will default to a BARRIER block
**Please note this is still in BETA** Around 1000 items in Minecraft were coded to be converted to the 1.14 block id system. There is a high possibility I missed an item or typed it in incorrectly if you find a block that doesn't work please message me ASAP
You can now use a Players' head inside the GUI.
To show the player's head who is opening the GUI put "PLAYER" for the "item-material"
Code (Text):
item-material: PLAYER
To show a specific player put "PLAYER[<name>]" for the "item-material"
Code (Text):
item-material: PLAYER[Cmaaxx]
If you have
HeadDataBase installed on your server you can use any item on it!
Simply for the "item-material" use "HDB[<item-id>]"
Example:
Code (Text):
item-material: HDB[1138]
1138 is the item ID from the HeadDataBase plugin.
Want to be able to use other head plugins blocks? Send me a link to the plugin and I may add the ability!
You can set items to multiple slots instead of copying and pasting the item over and over again! To do this you will need to set the items 'item-slot' number inside brackets. Such as: [1,2,5,6]
Similar to categories, you can set a GUI 'default' to false to make the GUI private. This means the player needs the permission node "help.<gui-name>" to open the GUI.
To view this GUI above you will need the permission node "help.factions" because the 'default' is set to 'false'.
How to use categories:
Categories are very simple and easy to create! You start off first by creating a category you want. For this example, we will use "factions". Follow the format below when creating a category. When 'default' is set to true, this will allow any user to run the command /help factions. When set to false, they will need the permission help.factions in order to run the command. You may create as many line and pages as you need for categories! Keep the category name in the config.yml lowercase!
Format:
Code (Text):
categories:
factions:
default: true
1:
- "&e&m---&e Factions Help &e&m---"
- " Put multiple line or pages!"
- " &d&lAll &3&lcolor &c&lcodes &a&lwork&6! use &nO &oO &lO &rO &m0 &kO"
2:
- "&e&m---&e Factions Help Page2 &e&m---"
- " add as many pages as you need to categories as well!"
skyblock:
default: true
1:
- "This is the skyblock category"
Important! Make sure all the lines under page numbers line up even with each other!
AdvancedHelp supports
PAPI. This means you can use any placeholder from PAPI anywhere!
AdvancedHelp's built-in placeholders: %player% - returns player name
%time% - returns time
How to use placeholders from PlaceholdersAPI: 1. Download
placeholdersapi 2. Download the placeholders, /papi ecloud download <name>
3. Reload papi, /papi reload
4. Use the placeholders in AdvancedHelp!
JSON tellraw text lets you make custom chat messages that could include hoverable text, suggest command, link, colors, styles, and more! For help with JSON chat check out the link below! JSON Wiki Help
REMEMBER! When writing this info into the config file you must add a backward slash(\) before the quotes. Example below:
/help - opens help message.
/help <page number> - opens specific page number.
/help <categoryName> - opens specific category.
/help <categoryName> <page number> - opens specific category page number.
/help <gui-name> - opens specific GUI, only if 'cmd-priority.gui' is true.
/ahelp reload - reloads configs.
*You can also use /? or /ehelp to replace "help"*
Code (Text):
help.use - for normal players to use /help.
help.reload - for admins to reload config.
help.<categoryName> - allows players to view a specific category, only need this permission if the 'default' is set to false.
help.<guiName> - allows players to view a specific gui, only need this permission if the 'default' is set to false
help.override - when using /? it will show bukkit help pages not AdvancedHelp's help pages.
Code (Text):
pages:
'1':
- 'Add unlimited lines and pages!'
- '{"text":"Use JSON text as well!"}'
'2':
- "Second page"
Code (Text):
categories:
example:
default: true
'1':
- 'Customize categories anyway you would like!'
Code (Text):
messages:
category-not-found: '&bCategory not found!'
page-not-found: '&bPage not found!'
no-permission: '&cYou do not have permission to do this!'
prefix: '&7[&bAdvancedHelp&7]'
dateFormat: HH:mm:ss dd-MM-yyyy
gui:
enabled: true
hide-attributes: true
close-page:
enabled: true
item-name: '&c&lClose'
item-material: BARRIER
enchanted: false
lore:
- '&c&oClick to close!'
home-page:
enabled: true
item-name: '&c&lHome Page'
item-material: BARRIER
enchanted: false
lore:
- '&c&oClick to go back!'
cmd-priority:
gui: true
refresh-guis: false
Plugin doesn't work the way you want it to? Message me through discord, spigot, or on the discussion page before you leave a review. Leaving a review with error messages does not make me work any harder to solve the issue.
Q: CMI and AdvancedHelp isn't working together? A: Until we find a better way to work with each other you will need to create a custom alias through CMI. Replacing /ehelp with /help. First try running /ehelp on your server and if it works do the custom alias. If not, message me privately.
Q: My config isn’t saving/reloading, how do I fix this? A: If you are editing the config and nothing is changing in-game this means you have an error. The most common errors are forgetting a quote (“ ”) or having an extra quote. Also, check your spacing! Compare your config to the example config above. Use this link to test your yml spacing and more!
Q: The messages are not changing, how do I change them? A: (same as above) If you are editing the config and nothing is changing in-game this means you have an error. The most common errors are forgetting a quote (“ ”) or having an extra quote. Also, check your spacing! Compare your config to the example config above. Use this link to test your yml spacing and more!
Q: Why isn’t my category working? A: Categories can be compromised if you have incorrect spaces or quote errors, however, make sure you keep your category name lowercase in the config!
Q: How do I access bukkit/essentials /help? A: To access the original help you can do /?. You will need the permission node help.override