Items

This page is valid for all plugins using the template developed by maxlego08 and using the loader system for itemstacks.

Example:
Here is an example of an item in a yml file:
item:
  material: 3
  data: 0
  durability: 0
  amount: 1
  glow: true
  lore:
    - "line"
    - "&cred line"
    - "&fwhite line"
  name: "&eMy awesome name"
  enchants:
    - PROTECTION_ENVIRONMENTAL,4
  flags:
    - HIDE_ENCHANTS
Example potion:
test2:
  item:
    material: POTION
    potion: "SPEED"
    splash: true
    extended: true
    level: 1
  type: NONE
  slot: 33
Example player head:
test3:
  item:
    material: PLAYER_HEAD
    url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTM2ZTk0ZjZjMzRhMzU0NjVmY2U0YTkwZjJlMjU5NzYzODllYjk3MDlhMTIyNzM1NzRmZjcwZmQ0ZGFhNjg1MiJ9fX0="
  type: NONE
  slot: 34
Add player HEAD
You have to add HEAD in the item name to be able to display the head of the player who opened the GUI.
Example:
item:
    material: PLAYER_HEAD
    name: "HEAD&a%player_name%"
If you are below version 1.13 you have to do
item:
  material: SKULL_ITEM
  data: 3
  name: "HEAD&a%player_name%"
Head Database
item:
  material: hdb:<head id>
type: NONE
slot: 0
EpicHead
item:
  material: eh:<head id>
type: NONE
slot: 0
Now let's move on to the explanation of each element
​
material
You can put the item ID for versions lower than 1.13 and you can put the material name for higher versions. List of materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html​
data
The item data works only for versions lower than 1.13, the default value is 0.
amount
The number of items (from 1 to 64), the default value is 1.
durability
Allows you to change the durability of items, works only for armor and other items that use durability, the default value is 0.
name
Allows you to change the name of the item, by default the name is null.
glow
Allows to add an enchantment to the item and to add the HIDE_ENCHANTS flag
lore
Allows to change a lore of the item, by default the lore is null.
enchants
Allows you to add enchantments, you have to put the name of the enchantment then the level of the enchantment, like this: ENCHANT,ENCHANT_LEVEL List of enchantments available: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html​
flags
This option is available for servers greater than or equal to the 1.8. List of flags: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html​
modelID
Allows you to put a custom model data on an item
Developer - Loading and saving an itemtack
To save and load an item you will have to use the ItemStackLoader class
//Create class
ItemStackLoader loader = new ItemStackLoader();
​
//Load your confirguration
YamlConfiguration configuration = plugin.getConfig();
​
//You have to put a . at the end of your path to load the item.
String path = "item.";
​
//Load ItemStack
ItemStack itemStack = loader.load(configuration, path);
​
//Save ItemStack
loader.save(itemStack, configuration, path);

Inventories - Previous

Buttons

Next - Advanced configuration

Placeholder buttons

Last modified 1yr ago