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]](//proxy.spigotmc.org/9cfbec3e76774ed0988749f8242fa9631aea661c/68747470733a2f2f692e696d6775722e636f6d2f6f4a4676436d742e706e67)
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]](//proxy.spigotmc.org/a4529504d39800e0a74f003951da8e85dcfd3728/68747470733a2f2f696d6775722e636f6d2f5335553341386d2e706e67)
- Multi-version support! BETA!
- 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.
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.
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
None yet. You can send me your reviews
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.
Let us know if your server is using it!
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.
NBT API - This plugin works with NBT Tags.
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]](//proxy.spigotmc.org/0a562dcd9d8c7c903a8178e8d4ce5daa47e233c9/68747470733a2f2f696d6775722e636f6d2f626668563878452e706e67)
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]](//proxy.spigotmc.org/c2cc2dcafb60b555ba007f8034447e7d2f58ab14/68747470733a2f2f692e696d6775722e636f6d2f45376659544e762e706e67)