✅ BetterHeads [1.8-1.19] • +40k heads! Vault/Level/Item support! Categories! icon

✅ BetterHeads [1.8-1.19] • +40k heads! Vault/Level/Item support! Categories! -----

Give your players/builders access to amazing heads for a price.



[​IMG]
[​IMG]
This plugin requires NBTAPI installed!
Plugman or similar plugins ARE NOT SUPPORTED!

Respect my work. You are not allowed to redistribute this plugin in any setup.
Tested on 1.8.8, 1.9.2, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.4, 1.17.1, 1.18.1
You are not allowed to post/move/copy this on mcbbs.net or similar. Don't insist.
If you want to contribute with a translation in your native language, feel free to dm me the translation.

[​IMG]
[​IMG] [​IMG] [​IMG] [​IMG] [​IMG]

[​IMG] [​IMG] [​IMG] [​IMG]

[​IMG][​IMG]

Need cool heads for your Build Team?
Do your players ask for custom heads to decorate their houses?
Tired of using give commands to get nice looking heads?

Well, I am! I created this plugin because of that.

What makes this plugin different from others?
First, it's made with love for everyone looking for a quality head plugin;
second, it has a cool API for developers; third it's easy to use and fourth, it's free!

Why should I use this, instead of the others? Is it better?
I'm not telling you to use this over others. I can't tell you if it's better.
That's something you must decide, try this plugin one day, you'll see the differences.

What else do i need to know about this plugin?
Keep reading Features list!

Fun fact: You are reading this ;)


[​IMG]
[​IMG]
  • Multi-version support! BETA!
    • Supports 1.8.8 - Latest
  • More than 40k heads! BETA!
    • A huge amount of custom heads to use.
  • Charge for heads! BETA!
    • Level experience supported!
    • Vault supported!
    • Material supported! Charge for materials! NEW! BETA!
  • Creative server friendly! BETA!
    • Charge players in creative mode to get heads too!
  • Team Builder friendly! BETA!
    • Disable charge for players in creative.
  • Give random command! BETA!
    • Give random heads from category to players.
    • Easy to use command, console compatible!
  • Free permission. BETA!
    • Bypass head price with a permission. (Operators don't have this permission by default)
  • Cooldowns! BETA!
    • Prevent your players from getting hundreds of heads too fast!
    • Permission to bypass cooldown! (Not default for operators)
    • Disable cooldown for players in creative! (Useful for Build Teams)
  • Hidden categories. BETA!
    • Show categories only the player has permission for.
    • Display unknown head for locked categories.
  • Get command. BETA!
    • Get custom head using head id.
    • Useful for builders.
  • Open command.
    • Open categories GUI for player with a command. (Works in console too)
  • Build command. BETA!
    • Give custom head with texture directly to players inventory. (Requires texture input)
  • Direct access to GUI.
    • Type /betterheads to access categories GUI without a subcommand!
  • Toggle head update check. BETA!
    • Option to disable new heads check on start up.
  • Quick pages. BETA!
    • If total amount of pages is too high. Quick pages will be added.
    • Quick access to first and last page.
  • Heads tags. BETA!
    • Heads have tags to easy search!
  • SEARCH FUNCTION! BETA!
    • You can search heads by name!
    • You can search heads by tag!
    • To search only using name add (-name) at the end.
  • Permission per head. BETA!
    • You can now set permissions for each head.
    • A simple format was added which you can edit.
    • Permissions will depend on head ID.
  • Head subcommand. BETA!
    • You can now get your own head. (Cost/cooldown support)
    • You can now get other players head. (Cost/cooldown support)
    • You can now give other players head to players. (Cost/cooldown NOT SUPPORTED)
  • ALIASES! BETA!
    • Yes, you can set different aliases for main command!
    • You MUST restart the server to apply changes!
    • This is BETA, report bugs as soon as you can!
  • Reload command. BETA!
    • Reload some configurations. (Restart is recommended when making changes)
  • Powerful developer API! BETA!
    • DeveloperAPI has many methods for developers to use.
    • You can listen to custom event when players attempt to purchase a head.
  • Configuration auto update.
    • Configuration will be updated on plugin update.
    • Comments will be removed on config update.
  • Update checker.
    • Be notified when there is a new update.
[​IMG]
config.yml

[​IMG]
Command autocomplete.
[​IMG]

Sorted by categories.
[​IMG]

Displayed in pages.
[​IMG]
Can't see the gif? Click here

Back to categories buttom.
[​IMG]
Can't see the gif? Click here

GUI easy to use. Click to get head.
[​IMG]
Can't see the gif? Click here

Charge players for getting heads. (Level, Vault and material support) BETA!
[​IMG]

Option to hide categories based on permissions.
[​IMG]

Charge players in materials!
[​IMG]
[​IMG]

Give random heads from category!
[​IMG]

Quick access pages!
[​IMG]

Search function!!
[​IMG]

[​IMG]
Installing the plugin in your server:
  • Download the plugin from SpigotMC.org
  • Copy the jar file into you plugins folder.
  • Restart the server.
  • Edit what you want in configuration files.
  • Restart the server.
[​IMG]
Permissions are configurable in configuration files.

/betterheads - Open categories GUI.
Permission:
none (Configurable)

/betterheads get <id> - Get head with specified id.
Permission:
betterheads.admin

/betterheads open <player> - Open categories GUI for player.
Permission:
betterheads.admin

/betterheads build <player> <texture> - Give player head with custom texture.
Permission:
betterheads.admin

/betterheads search <words> (-name) - Search heads.
Permission:
betterheads.search

/betterheads giverandom <category> <player> <amount> - Give random head from category.
Permission:
betterheads.admin

/betterheads giverandom <random|all> <player> <amount> - Give random head from random/all category.
Permission:
betterheads.admin​

/betterheads head - Get your own head.
Permission:
betterheads.player-head​

/betterheads head <player-head-name> <player> - Give player head to player.
Permission:
betterheads.admin

/betterheads reload - Reload some configurations. (Restart is recommended)
Permission:
betterheads.admin

Get free heads from GUI. (Don't pay anything for heads. Operators DON'T have this by default)
Permission: betterheads.free

Ignore cooldown to get heads. (Operators DON'T have this by default)
Permission: betterheads.cooldownbypass

[​IMG]
None yet. You can send me your reviews :D

[​IMG]
This is a simple plugin, i don't think it requires more features.
However if you consider your suggestion should be added, let me know in discussion tab.

[​IMG]
[​IMG]
[​IMG]
Let us know if your server is using it! ;)

[​IMG]
1) Why is this BETA? That means it has bugs?
Answer:
No, plugin should not have bugs. I use BETA because I like the word, I guess.

2) Will you add new heads?
Answer:
Afaik the API being used for this plugin adds new heads.

3) How often do we get new heads?
Answer:
Being honest, I don't know.

4) Why is this free?
Answer:
Why not?

5) Do i need to update to get new heads if available?
Answer:
You shouldn't. BetterHeads system handle new heads automatically.
However, it's always recommended to keep it up to date for possible bugs fixes.

6) Can i post this in mcbbs.net?
Answer:
No.

7) Are you sure?
Answer:
Yes, I'm sure. You are not allowed to post it.

8) Help me, it's not working in my server!
Answer:
Before reviewing the resource. Make sure you have installed all dependencies.
It the error persists. Paste startup console log in https://sourceb.in/ and post it in discussion tab or join my server.

[​IMG]
NBT API - This plugin works with NBT Tags.

[​IMG]
Access the API package:
com.alonsoaliaga.betterheads.api.BetterHeadsAPI
Code (Java):
Available methods :
List <String > getCategories ( )
> Returns list of available categories.
ItemStack getHead ( int id )
> Returns head with the id associated. Returns null if not valid head id.
boolean openCategories (Player player )
> Opens categories GUI for player. Returns whether success or not.
boolean openHeads (Player player, String category, int page )
> Opens heads gui for player with the selected category and page. Return whether success or not.
ItemStack getRandomHead ( )
> Returns a random head.
ItemStack getRandomHead ( String category )
> Returns random head in category. Returns null if category is not valid.
List <Integer > getHeadsIds ( )
> Returns list of heads ids.
List <Integer > getHeadsIds ( String category )
> Returns list of heads ids in category. Returns null if category is not valid.
List <Integer > searchHeads ( String search )
> Returns list of heads ids that includes search term in name.
List <Integer > searchHeads ( String search, boolean includeTags )
>  Returns list of heads ids that includes search term in name and tags.
boolean searchHeads (Player player, String search, boolean includeTags )
> Open search GUI for player. (Returns false if error or matches not found )

Available events :
HeadPurchaseEvent
> When player purchases /get a head from heads GUI.
If you find any bugs, errors or want to request a feature.
Join my discord or use our issue tracker.

Review section is not place to report errors.


[​IMG]
  • Price/Lore per head.
[​IMG]
By downloading this resource you agree all following terms and conditions:
  • You are not permitted to redistribute the plugin in any form, including as a part of any software package.
  • You are not permitted to decompile or modify the plugin in any form.
  • You are not permitted to claim this resource as your own creation.

[​IMG]
[​IMG]
Resource Information
Author:
----------
Total Downloads: 7,362
First Release: Aug 23, 2020
Last Update: Aug 1, 2021
Category: ---------------
All-Time Rating:
31 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings