Head Items 1.1.0

​

HeadItems lets you create new custom items in Minecraft thanks to the 1.8 update and player heads! Since heads can store custom textures in them, you can create an unlimited amount of new items that you can either craft, apply food or potion boosts upon use.

Features

• Add new items with any custom texture
• Items can be used with right click, placable on the ground or both.
• Items can restore food or apply any various number of potion effects
• Items can be crafted (with optional permissions)
• Items can to be spawned with commands
• Item Recipes can be viewed
• Play optional sound effects upon use

Installation

1. To install, place HeadItems.jar in your plugin folder and restart your server.
2. By default, HeadItems includes 4 items: Donut, Cupcake, Popcorn, and Coffee. These starting items should give you enough templates to create your own items. Please see the config file for details on adding new items.

Adding Textures

You can add textures to your items by visiting THIS website. There are a large variety of existing heads in the Main Collection. You can also add your own heads and generate textures this way. Once you have a head you would like to add as the item COPY the Texture's VALUE from the give command. This should be entered under Texture in the config.

Commands
All commands can be executed from in game or the console. Permissions are required if the player is not OP.

/hi - Base command for HeadItems
/hi list - List all current items
/hi item [NAME]:[OptionalAmount [OptionalPlayer] - give yourself the item based on the item name and optional amount. You can also give items to other players

Spoiler: Examples

(Example 1: /hi item donut - this will give you 1 donut)
(Example 2: /hi item donut:10 - this will give you 10 donuts)
(Example 3: /hi item donut:64 jeb - this will give jeb 64 donuts)

/hi recipe [NAME] - view recipe for the item
/hi reload - Reload the config file

Permissions
headitems.* - Access to all headitem commands
headitems.list - Access to /hi list command
headitems.item - Access to /hi item command (Give self items only)
headitems.item.others - Access to /hi item command (For others only)
headitems.item.* - Complete access to /hi item
headitems.recipe - Access to /hi recipe [name]
headitems.reload - Access to /hi reload
headitems.craft.ITEMNAME - Ability to craft the item (Requires CraftingRequiresPerms to be enabled in config. By default this feature is disabled).

Support
If you have any issues please post them in the discussion thread. I would like to keep this plugin FREE, so if you feel this plugin has benefited your server, please donate above. Thank you!

Spoiler: Screenshots

Spoiler: Default Config

Code (Text):

#Head Items Version 1.1.0 by Dan

#Config - various config options for the plugin
#CraftingRequiresPerms - Set to true if you want to require permissions to craft items (headitems.craft.ITEMNAME) (Default: false)
#CleanOldIdsOnReload - Clean up old UUIDs for old heads if they are removed from the config (Default: false)
#ConfigVersion - DO NOT TOUCH

#Items - Place each new item that you would like to add in here
#DisplayName - Name of the item as it appears in game
#DisplayLore - Line by line lore for the item
#isFoodORPotion - Set if item restores food or applies potion effects (True/False)
#FeedAmount - Amount of food to restore (0-20)
#RightClickToUse - Can the user right click the item to use it (True/False)
#UseWithFoodAtMax - Can the user use the item even if they are at max food level (True/False)
#Placable - Can the item be placed on the ground (True/False)
#Sound - Should the item make a sound on use: (NONE or from Sound Event column on Wiki: http://minecraft.gamepedia.com/Sounds.json)
#Recipe:Enabled - Should there be a craftable recipe for the item?
#Recipe:Pattern - Pattern of the crafting recipe, a=AIR, other letters map the ingredients below
#Recipe:Ingredients - Which Ingredients map to the pattern above, you can use IDs or Material names. If you need to specify data for an item use the #. Ex: INK_SACK#3 will require cocoa-beans
#Potions - Optional, add line by line the Potion(s) you want in the following format: POTIONNAME#LengthInSeconds#Amplifier
#Texture: The texture data for the head. See http://heads.freshcoal.com/ for existing head textures or generate your own. Paste in the VALUE for texture.

Config:
  CraftingRequiresPerms: false
  CleanOldIdsOnReload: false
  ConfigVersion: 2

Items:
  Donut:
    DisplayName: Donut
    DisplayLore:
    - 'Sugary and delicious!'
    isFoodORPotion: true
    FeedAmount: 5
    RightClickToUse: true
    UseWithFoodAtMax: false
    Placable: true
    Sound: random.eat
    Recipe:
      Enabled: true
      Pattern:
      - ggg
      - gsg
      - ggg
      Ingredients:
        g: WHEAT
        s: SUGAR
    Texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODM3YzliODJiMTg2NjU2ZTlmNjM2M2EyYTFjNmE0YjViOTNjZmE5ZWY0ZGFkNmYxNmI5NGViYjVlMzYyNjc4In19fQ==
  Cupcake:
    DisplayName: Cupcake
    DisplayLore:
    - 'Cake for one'
    FeedAmount: 6
    isFoodORPotion: true
    RightClickToUse: true
    UseWithFoodAtMax: false
    Placable: true
    Sound: random.eat
    Recipe:
      Enabled: true
      Pattern:
      - aea
      - awa
      - asa
      Ingredients:
        e: EGG
        s: SUGAR
        w: WHEAT
    Texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjkxMzY1MTRmMzQyZTdjNTIwOGExNDIyNTA2YTg2NjE1OGVmODRkMmIyNDkyMjAxMzllOGJmNjAzMmUxOTMifX19
  Popcorn:
    DisplayName: Popcorn
    DisplayLore:
    - 'Perfect for a movie!'
    FeedAmount: 3
    isFoodORPotion: true
    RightClickToUse: true
    UseWithFoodAtMax: false
    Placable: true
    Sound: random.eat
    Recipe:
      Enabled: true
      Pattern:
      - aaa
      - gwg
      - aga
      Ingredients:
        g: PAPER
        w: WHEAT
    Texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTQ5N2IxNDdjZmFlNTIyMDU1OTdmNzJlM2M0ZWY1MjUxMmU5Njc3MDIwZTRiNGZhNzUxMmMzYzZhY2RkOGMxIn19fQ==
  Coffee:
    DisplayName: Cup of Coffee
    DisplayLore:
    - 'Contains high amounts of caffeine'
    FeedAmount: 0
    isFoodORPotion: true
    RightClickToUse: true
    UseWithFoodAtMax: true
    Placable: false
    Sound: random.drink
    Recipe:
      Enabled: true
      Pattern:
      - yyy
      - xwx
      - zzz
      Ingredients:
        w: POTION
        x: MILK_BUCKET
        y: INK_SACK#3
        z: SUGAR
    Potions:
    - SPEED#60#2
    Texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGYxMzIzYzlmZWYyMDY5Y2I0NWE0OTE0M2IzZjI1ZDg4NjRhYTY0YTQ5OTgxOWIxZjQyZDkzMzY3YTU5MzNlIn19fQ==