Referencing Things

Reference Lists

Minecraft Item List
Minecraft Entity Type List
Minecraft Potion Type List
Minecraft Enchantment List
Minecraft Biome List

Referencing Items

For custom items, use the custom item's unique id (yml file name).

For Minecraft items, use the Minecraft item name (preferably prefixed with "minecraft:"). See Minecraft Item List.

For example,

items:
  - "minecraft:DIAMOND"
  - "minecraft:GOLD_INGOT"
  - "myCustomItemID"
  - "anotherCustomItemID"

If you want to reference an item that has some special characteristics but isn't a default Minecraft item or a CustomItem, Check out ItemBridge, which lets you save items, and later reference them in CustomItem using "saved:item"

Referencing Colors

On any "color" attribute, you can provide a six-character hexadecimal color code like "00AAFF" or "E41517". Google "hex color code picker".

Referencing Enchantments

To reference enchantments, set create a key in the YAML file with the enchantment's name, and set it to the level of the enchantment. This also works with custom enchantments from other plugins:

enchantments:
  # Unbreaking 3
  "minecraft:DURABILITY": 3
  # Thorns 2
  "minecraft:THORNS": 2

See Minecraft Enchantment List for the names of the Minecraft enchantments

Referencing Potions

To reference just the effect (for string parameters), use the potion's Minecraft name (you can find a list of names in the reference list above)

To reference potions (for potion parameters), use the following keys:

type: [string - "NIGHT_VISION" for example]
time: (number - seconds | default: 20)
strength: (number | default: 1)
particles: (true/false | default: true)
ambient: (true/false | default: true)
showIcon: (true/false | default: true)

See Minecraft Potion Type List for the names of the Minecraft potion effects

For example,

potions:
  -
    type: "NIGHT_VISION"
    time: 20
    strength: 1
    particles: true
    ambient: true
    showIcon: false