ItemData

Well, I want the users of this plugin to be able to create all kinds of existing items, including enchantments, potion effects, durability etc.

In order to do this I thought about something completely new: ItemData. It is very easy to work with ItemData.


All you need is a list of attributes of the item you want to create. The order of the attributes does not matter at all. If your ItemData contains mistakes BossShopPro will log them in the "BugFinder.yml" file.

ItemData should contain at least two things: material type and amount.

- 'type:STONE'
- amount:10


Having problems reproducing an item?
Simply type "/bs read" ingame while holding an item. BossShopPro will show you how the item is built up in chat and additionally save the itemdata of the item in the "plugins/BossShopPro/ItemDataStorage.yml" file. new!


There are many different kinds of attributes you can use:


type:<type>
This defines the material of the item. You can for example use 'type:1' or 'type:stone' in order to make your item stone.

• You can find a list of types here: Link
• The setup tool auto-completes material names

amount:<number>
This should be clear.


durability:<number>
Durability does different things. For example it defines the damage of Armor/Weapons/Tools and it defines the color of wool.

custommodeldata:<number>
Custom Model Data allows you to change the texture of an item (using a resource pack) based off the number you provide in the config. This is great if you have a resource pack for your server because you can design each item to have multiple different looks!

name:<name>
This is the displayed name of the item.

• Supported placeholders and symbols: Link

You want an empty item name? A dirty workaround would be using color codes only: "name:&1".


lore:<line1#line2#line3>
This is the lore of the item.
You can use color codes like &4 (=DARK_RED) or &l (= BOLD).
You can "switch" to the next line using "#".

• Supported placeholders and symbols: Link

All following ways allow you to create lores:

enchantment:<enchantment name>#<level>
Use this attribute to enchant your item.
Example: 'enchantment:damage_all#5' or 'enchantment:16#5' <- This would add Sharpness V to your item.

• Here you can find a list of Enchantments: Link
• The setup tool auto-completes enchantment names
  
  Spoiler: Enchantment List (1.13.1) (BSP v2.0.0 [BETA])

  Code (YAML):

  ###################################################
  ## For The Use of BossShopPro and 1.13.1 Updates ##
  ##             BSP v2.0.0 [BETA])                ##
  ###################################################
  
  #Armor Enchants
  ID:0 | MINECRAFT:PROTECTION
  ID:1 | MINECRAFT:FIRE_PROTECTION
  ID:2 | MINECRAFT:FEATHER_FALLING
  ID:3 | MINECRAFT:BLAST_PROTECTION
  ID:4 | MINECRAFT:PROJECTILE_PROTECTION
  ID:5 | MINECRAFT:RESPIRATION
  ID:6 | MINECRAFT:AQUA_AFFINITY
  ID:7 | MINECRAFT:THORNS
  ID:8 | MINECRAFT:DEPTH_STRIDER
  ID:9 | MINECRAFT:FROST_WALKER
  ID:10 | MINECRAFT:BINDING_CURSE
  #Sword Enchants
  ID:16 | MINECRAFT:SHARPNESS
  ID:17 | MINECRAFT:SMITE
  ID:18 | MINECRAFT:BANE_OF_ARTHROPODS
  ID:19 | MINECRAFT:KNOCKBACK
  ID:20 | MINECRAFT:FIRE_ASPECT
  ID:21 | MINECRAFT:LOOTING
  ID:22 | MINECRAFT:SWEEPING
  #Tools Enchants
  ID:32 | MINECRAFT:EFFICIENCY
  ID:33 | MINECRAFT:SILK_TOUCH
  ID:34 | MINECRAFT:UNBREAKING
  ID:35 | MINECRAFT:FORTUNE
  #Bow Enchants
  ID:48 | MINECRAFT:POWER
  ID:49 | MINECRAFT:PUNCH
  ID:50 | MINECRAFT:FLAME
  ID:51 | MINECRAFT:INFINITY
  #Fishing Rod Enchants
  ID:61 | MINECRAFT:LUCK_OF_THE_SEA
  ID:62 | MINECRAFT:LURE
  #Trident Enchants
  ID:65 | MINECRAFT:LOYALTY
  ID:66 | MINECRAFT:IMPALING
  ID:67 | MINECRAFT:RIPTIDE
  ID:68 | MINECRAFT:CHANNELING
  #Most Items Enchants
  ID:70 | MINECRAFT:MENDING
  ID:71 | MINECRAFT:VANISHING_CURSE

color:<red number>#<green number>#<blue number>
Use this attribute to dye your item (works with leather armor, potions and other colorable material).
Example: 'color:110#10#140'
How does it work? Well, just define how red/green/blue the color shall be. You can find a list of RGB colors here: http://www.farb-tabelle.de/de/farbtabelle.htm


potion:<potion name>#<extended? true/false>#<upgraded? <true/false> new!
This allows you to add vanilla potion effects to items. Can be used on items which support potioneffects only!
Example: 'potion:MUNDANE#true#false' <- This would make the item a mundane I potion with extended duration.

• Here you can find a list of Potion types: Link
• The setup tool allows to choose between the existing potion types quickly

potioneffect:<potion name>#<level>#<time in seconds>
This allows you to add custom potion effects to items. Can be used on items which support potioneffects only!
Example: 'potioneffect:STRENGTH#1#600' <- This would add a strength II potion effect which would last 10 minutes.

• Here you can find a list of Potion effect types: Link
• The setup tool allows to choose between the existing potion effect types quickly

playerhead:<name>
This allows you to set the name of skulls. IMPORTANT: You can only use this attribute on skulls ("SKULL_ITEM").
Example: 'playerhead:Herobrine' <- This would transform the skull into a Herobrine head. IMPORTANT: In order to get Playerheads you need to set the material to SKULL_ITEM ("type:SKULL_ITEM"). Also, make sure to use "durability:3" if you use Spigot 1.13.* or below.


customskull:<texture/mojang skin url>
This allows you to give skulls custom and fix textures which do not change when a player changes his skin. Once loaded by the client of the player these textures will stay loaded and are instantly displayed whenever the player re-opens the shop. You can find textures here: Link, Link2. Simply click a head and copy the texture value that is contained in the resulting string.



mobspawner:<mob name>
Allows you to make your item a working mobpawner with a pre-set mobtype. Requires the plugin SilkSpawners or EpicSpawners.
If you use EpicSpawners use the spawner identifier (defined in your EpicSpawners/spawners.yml file) instead of the Spigot mob name. Note: do not change the name of the spawner, otherwise it will turn into a pig spawner.

• List of available entity names: Link

Dirty workaround without using SilkSpawners/EpicSpawners: Use commands to give the player a pre-set mobspawner.


monsteregg:<mob name>
Allows making items a working monsteregg with a pre-set mobtype. Requires the plugin SilkSpawners.

• List of available entity names: Link

Workaround without using SilkSpawners which might work when using older Spigot builds (Not guaranteed to work!): You can create working monstereggs without SilkSpawners aswell, however these only keep their entity-adapted color as long as they do not have a custom name or lore. In that case simply use "type:MONSTER_EGG" and "durability:<mob id>".


hideflags:<flag1#flag2#flag3>
Fast way to hide flags. Examples:

• hideflags:all
• hideflags:HIDE_ATTRIBUTES
• hideflags:HIDE_ATTRIBUTES#HIDE_ENCHANTS
• Here you get a list of available flag names: Link

unbreakable
Makes the item completely unbreakable. Useful for adventure maps for example. This feature only works on Spigot servers though.


book:<title>#<author>
Adds title and author name to a written book. Supports color codes and symbols.


bookpage:<page>#<text>
Adds text to the given book page. Can be used multiple times per page in order to force a new line.




Check out the default shops or the Configuration guide in order to find out more about ItemData.


Item Comparison: Limiting what items players can sell to receive a certain reward (when the price is items).