✅ BetterHeads [1.8-1.16] • +21k heads! Vault/Level/Item support! Categories! 0.4-BETA

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

  1. AlonsoAliaga
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Languages Supported:
    Customizable in config.yml
    This plugin requires NBT API installed!
    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.2
    You are not allowed to post/move/copy this on mcbbs.net. 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]
    • More than 21k 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!
    • 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
    Code (YAML):
    #              ___      _   _           _  _             _
    #            | _ ) ___| |_| |_ ___ _ _| || |___ __ _ __| |___
    #           | _ \/ -_)  _|  _/ -_) '_| __ / -_) _` / _` (_-<
    #          |___/\___|\__|\__\___|_| |_||_\___\__,_\__,_/__/
    #
    #                           by AlonsoAliaga
    #          https://www.spigotmc.org/resources/authors/281176/
    #

    Messages
    :
      No-permission
    : "&cYou don't have permission to do this."
      Reloaded
    : "&aSome messages and options have been reloaded. Other may require a restart!"
      Invalid-player
    : "&cPlayer is not online!"
      Invalid-head-id
    : "&cInvalid head id provided!"
      Not-enough-levels
    : "&cYou don't have enough levels to purchase this head! You need {COST} level(s)."
      Not-enough-money
    : "&cYou don't have enough money to purchase this head. You need ${COST}."
      Purchased-levels
    : "&eYou purchased &b{NAME}&e head using {COST} level(s)."
      Purchased-money
    : "&eYou purchased &b{NAME}&e head using ${COST}."
      Build
    :
        Head-name
    : "&eBetterHead"
        Success
    : "&aYou built a custom head for {TARGET}."
        Success-other
    : "&6You received a custom head!"
        Success-other-extra
    : "&aYou received a custom head. You didn't have enough space, some items were thrown in the floor!"
      Get
    :
        Success
    : "&eYou received &b{HEAD}&e head!"
      Cooldown
    :
        Please-wait
    : "&cYou are getting heads too fast! Please wait {TIME} to get more."

    Permissions
    :
      Admin
    : "betterheads.admin"
      Free
    : "betterheads.free"
      Cooldown-bypass
    : "betterheads.cooldownbypass"
      #Heads permission can be "none" to not require permission to use /bheads to open categories GUI.
      #"none" can be used inside categories.yml file to remove permission for categories.
      Heads
    : "none"

    Options
    :
      Gui
    :
        Main-title
    : "&8Available heads"
        Category-title
    : "&8Category: {CATEGORY} ({PAGE}/{MAX})"
        #This option hides category if player doesn't have permission.
        Hide-locked
    : true
        #Fills empty slots with frames.
        Fill-with-frame
    : true
        Items
    :
          Previous
    :
            Texture
    : "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzdhZWU5YTc1YmYwZGY3ODk3MTgzMDE1Y2NhMGIyYTdkNzU1YzYzMzg4ZmYwMTc1MmQ1ZjQ0MTlmYzY0NSJ9fX0="
            Displayname
    : "&9Previous page"
            Lore
    :
           - "&7Return to previous page."
          Next
    :
            Texture
    : "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjgyYWQxYjljYjRkZDIxMjU5YzBkNzVhYTMxNWZmMzg5YzNjZWY3NTJiZTM5NDkzMzgxNjRiYWM4NGE5NmUifX19"
            Displayname
    : "&9Next page"
            Lore
    :
           - "&7Move to next page."
          Unknown
    :
            Texture
    : "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNDZiYTYzMzQ0ZjQ5ZGQxYzRmNTQ4OGU5MjZiZjNkOWUyYjI5OTE2YTZjNTBkNjEwYmI0MGE1MjczZGM4YzgyIn19fQ=="
            Displayname
    : "&4&lUnknown category"
            Lore
    :
           - "&7You haven't unlocked"
            - "&7this category."
          Close
    :
            Texture
    : "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmViNTg4YjIxYTZmOThhZDFmZjRlMDg1YzU1MmRjYjA1MGVmYzljYWI0MjdmNDYwNDhmMThmYzgwMzQ3NWY3In19fQ=="
            Displayname
    : "&4&lClose"
            Lore
    :
           - "&7Close Heads GUI."
          Back
    :
            Texture
    : "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmViNTg4YjIxYTZmOThhZDFmZjRlMDg1YzU1MmRjYjA1MGVmYzljYWI0MjdmNDYwNDhmMThmYzgwMzQ3NWY3In19fQ=="
            Displayname
    : "&4&lBack"
            Lore
    :
           - "&7Back to GUI."
          Category
    :
            Displayname
    : "&b&l{CATEGORY}"
            Lore
    :
           - "&7{AMOUNT} heads!"
      Head
    :
        Displayname
    : "&e{NAME}"
        Displayname-id
    : "&e{NAME}&r &8{ID}"
        Lore
    :
       #- "&7This lore will be added to"
        #- "&7all heads in the GUI."
        #- "&7Cost: &a${PRICE}" #Change to this if you select economy as payment method. (Requires vault and economy plugin)
        - "&7Cost
    : &a{PRICE} level(s)" #Change to this if you select experience as payment method.
      Head-cost:
        Enabled: true
        Cost-on-creative: false
        #If disabled, cost will take levels. YES, LEVELS, not experiences, LEVELS.
        #If enabled and Vault is available and hooked, cost will take money from balance, otherwise it will take LEVELS.
        #This is an experimental feature, please report bugs on discussion tab.
        Vault: false
        Cost: 1
      #Add a delay to prevent players get/buy heads to fast.
      #Cooldown does NOT persist on restart. So make sure you choose short cooldown interval.
      Cooldown:
        Cooldown-on-creative: false
        #Time is in SECONDS. (Default: 5 seconds)
        #Example: 60 = 1 minute, 300 = 5 minutes.
        #Set to 0 to disable cooldown.
        Time: 5

    Updates:
      #Auto update configuration? Enabling will delete comments.
      Auto-update-configuration: true
      #Check for updates? Recommended to keep it enabled.
      Check-updates: true
      #Notify updates when player with permission joins the server?
      Notify-updates: true
      #Permission required to receive update message.
      Permission: "
    betterheads.update"
      #Message to send when update is found.
      Message: "
    &3[BetterHeads] &eA new update has been found! You are using version {CURRENT}. Download version {NEW} here &c{LINK}"
    [​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 and Vault support) BETA!
    [​IMG]

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

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

    Give random heads from category!
    [​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 giverandom <category> <player> <amount> - Give random head from category.
    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]
    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.

    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]


      • Search feature in GUI. (DeveloperAPI provides a method for that)
      • 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]
    fierceeo and FlekMoon like this.

Recent Reviews

  1. hadzardoes
    hadzardoes
    5/5,
    Version: 0.4-BETA
    ugh hot plugin, but im hotter tho. Keep it up ;) best plugin for heads and this is free
    1. AlonsoAliaga
      Author's Response
      Glad to hear you like it! :D

      Thanks for your review!
  2. Dusk_Augustus
    Dusk_Augustus
    5/5,
    Version: 0.4-BETA
    Nice plugin,I like it.It's convenient to decorate my server!Also the gui is friendly!
    1. AlonsoAliaga
      Author's Response
      Glad you like it! :D

      Thanks for the review!
  3. yodaylay_22
    yodaylay_22
    5/5,
    Version: 0.3-BETA
    This is very nice plugin! i love it!

    pls, add cost in item:

    X itens for head!
    1. AlonsoAliaga
      Author's Response
      Glad you like our plugin!
      And update was released, hope you like it!

      Thanks for your review!
  4. Yosukp
    Yosukp
    5/5,
    Version: 0.2-BETA
    looks good and its free, adding it right now to my survival
    you have good plugins, niceee
    1. AlonsoAliaga
      Author's Response
      If its for a survival, you can enable the option to charge using vault :D

      Thanks for your review!
  5. MMcrafter2
    MMcrafter2
    5/5,
    Version: 0.2-BETA
    Collest plugin and a cool free alternetiv for HeadDataBase thx! One wich please make a search funktion. I use that on my server the IP is MinecraftClub.de please add it to the list thx!
    1. AlonsoAliaga
      Author's Response
      Search function is available for developers using the plugin API, however the function will not be added to the plugin as a command for now. I'm working on more plugins, probably later for future releases.

      I can't make the banner for your server. Seems not to be working with your ip.
      Please go to http://status.mclive.eu/index.php and fill information. If success, dm me so i can add the banner :D

      Thanks for the review!
  6. savenx
    savenx
    5/5,
    Version: 0.1-BETA
    Awesome plugin, working perfect! And awesome dev too, fast responses and very friendly.. Recommended
    1. AlonsoAliaga
      Author's Response
      Glad you like it! Feel free to ask if you have any problem :D

      Thanks for the review!