items.yml

Configure Custom Items

The plotsystem allows you to customise almost every single item that you see. So for example if you want to change the item for the Companion, which on default is a NETHER_STAR, you can do so with the items.yml.

Default for the companion item:

companion-item:
  material: NETHER_STAR
  modelId: ''

Suppose we want to change the companion item to be a TOTEM_OF_UNDYING, we would configure the companion-item entry as such:

companion-item:
  material: TOTEM_OF_UNDYING
  modelId: ''

Note

The name for the material needs to match a bukkit material name. A list of all possible values can be found here

Custom heads

You can also use a custom player head using a HeadDatabase ID.

For this you need to set the material entry to be head(<ID>) where <ID> would be replaced with your ID of course.

companion-item:
  material: head(26174)
  modelId: ''

Custom Model Data

The PlotSystem also allows defining a custom model data ID or String. This is useful for custom resource packs.

Example with a string:

companion-item:
  material: PAPER
  modelId: 'ui_companion'

Example with a classic integer ID:

companion-item:
  material: PAPER
  modelId: 5001