Item IDs

Item ID Formatting

In your rituals configuration file (rituals.yml), you can specify different types of items as part of rituals and offerings. This includes vanilla items, and custom items from other plugins (support for custom items is planned but not yet implemented). Below are the formats for specifying item IDs:

Vanilla Items

For vanilla Minecraft items, use the following format:

item: "VANILLA:<ITEM_TYPE>:<ITEM_DATA>"

Replace <ITEM_TYPE> with the type of the item (e.g., "POTION", "GOLD_INGOT", "IRON_BLOCK", "NETHER_STAR", etc.), and <ITEM_DATA> with any additional data required for the item (e.g., potion effects for potions).

Saved Items (Work in progress, not supported yet)

Use the SAVED type. The format for Saved IDs is:

item: "SAVED:<ITEM_ID>"

Example Reference

Here's a reference for items being used in both Rituals and Offerings:

purification_ritual:
  display_name: "Ritual of Purification"
  description: "Purify the lands by vanquishing dark entities"
  favor: 40
  item: "VANILLA:POTION_SPEED"

offerings:
  - "VANILLA:GOLD_INGOT:5:command1;command2" # TYPE:ITEM:FAVOR:COMMANDS
  - "VANILLA:IRON_BLOCK:20:give {player} diamond 1"
  - "VANILLA:NETHER_STAR:50:give {player} diamond 5;say Thanks for the offering!"
  - "VANILLA:POTION_STRENGTH:25:give {player} gold_ingot 3"