Hooks & Supported plugins - AlonsoAliaga/BetterHeads GitHub Wiki

BetterHeads currently supports some plugins.

If you are a developer and want to support BetterHeads,
take a look at the DeveloperAPI of our plugin.

💎 BetterCaptcha

Allows using heads in the captcha gui.

The Items section

The items section support using the format BETTER_HEADS|<ID>, works together with other types.
In the next example, the plugin will show three random heads from the list provided.

Captchas:
  example-of-random-better-head:
    Enabled: true
    Type: "RANDOM" //Any type you want.
    Title: "&8Click the {NAME}!"
    Amount: 3 //Any number greater than 1 and lower or equal than 54
    Time: 10
    Items:
    - "BETTER_HEADS|2547"
    - "BETTER_HEADS|586"
    - "BETTER_HEADS|15636"
    - "BETTER_HEADS|543"
    - "BETTER_HEADS|23"
    - "BETTER_HEADS|876"
    - "BETTER_HEADS|3567"
    - "BETTER_HEADS|187"
    - "BETTER_HEADS|764"

The Type option:

In the next example, the plugin will choose the specified amount of heads (random) and display them in the gui.

Captchas:
  example-of-ten-better-heads:
    Enabled: true
    Type: "BETTER_HEADS"
    Title: "&8Click the {NAME}!"
    Amount: 10 //Any number greater than 1 and lower or equal than 54

💎 DeluxeMenus (🔰 Since BetterHeads v2.0-BETA)

DeluxeMenus v1.14.0 and older

You can use the prefix in material line Material: "hdb-"
This is due to limited API available, I cannot add a custom one,
but use one that already exists and is not in use.

DeluxeMenus v1.14.1 and newer (Download from Jenkins)

You can use the prefix in material line Material: "betterheads-"

Available options are:

  • betterheads-ID
    Returns the head with specified ID.
    Example: betterheads-1000
  • betterheads-randomhead
    Returns a random head.
    Example: betterheads-randomhead
  • betterheads-randomheadincategory-
    Returns a random head in specified categories.
    Example #1: betterheads-randomheadincategory-humans
    Example #2: betterheads-randomheadincategory-blocks,decoration
  • betterheads-pickrandomhead-
    Returns a head with the randomly selected ID from the ones provided.
    Example: betterheads-pickrandomhead-100,124,153,1245,2525
  • betterheads-randomheadinrange-1000,1010
    Returns a random head in the provided range.
    Example: betterheads-randomheadinrange-1000,1010

💎 zMenu (🔰 Since BetterHeads v2.0-BETA)

You can use the prefix in material line material: "betterheads:"

Available options are:

  • betterheads:ID
    Returns the head with specified ID.
    Example: betterheads:1000
  • betterheads:randomhead
    Returns a random head.
    Example: betterheads:randomhead
  • betterheads:randomheadincategory-
    Returns a random head in specified categories.
    Example #1: betterheads:randomheadincategory-humans
    Example #2: betterheads:randomheadincategory-blocks,decoration
  • betterheads:pickrandomhead-
    Returns a head with the randomly selected ID from the ones provided.
    Example: betterheads:pickrandomhead-100,124,153,1245,2525
  • betterheads:randomheadinrange-1000,1010
    Returns a random head in the provided range.
    Example: betterheads:randomheadinrange-1000,1010

Additional features

💎 AlonsoLib (🔰 Since BetterHeads v2.0-BETA)

:warning: This plugin is NOT required if you are using a PaperMC (or fork) server.

Allows you to shift-click head to receive information and a direct link to view it in website.

💎 Vault + economy plugins

Allows you to purchase heads using your balance.