Skip to content

Custom Item Plugins

Esophose edited this page Feb 26, 2022 · 23 revisions

Introduction

Are you using a custom items plugin and want to drop some custom items? If so, this is the place for you. Custom items support the same parameters as Items. If you would like direct support for another custom items plugin, please request it in our Discord server. You can find examples of how to drop items from these plugins below.

The following custom item plugins are currently supported (Click the name to jump to the wiki section):

CustomItems/ItemBridge

If you wish to drop items from the CustomItems plugin, you must also have ItemBridge installed. To drop an item from CustomItems, prefix the item ID with cui:.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: itembridge
            item: 'cui:emeraldHoe'
            amount: 1

ItemsXL

The item ID will be the .yml file name of the item.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: itemsxl
            item: 'your_item'
            amount: 1

ItemsAdder

Simply use the item ID as defined in the ItemsAdder configs. Some item IDs may require a prefix if they are added by an expansion.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: itemsadder
            item: 'ruby_ore'
            amount: 1

MMOItems

The item field must contain a : which separates the item type and the item ID. This field is case-sensitive, meaning it must match the item type and item ID exactly how it is in the MMOItems configs.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    rolls: 1
    bonus-rolls: 0
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: mmoitems
            item: 'BOW:MARKING_BOW'
            amount: 1

Knokko's CustomItems

The item ID will be the name of the item you defined in the editor.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: knokkocustomitems
            item: 'your_item'
            amount: 1

Oraxen

The item ID will be the name of the item in the .yml file.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: oraxen
            item: 'bedrock_pickaxe'
            amount: 1

ExecutableItems

Simply use the item ID as defined in the ExecutableItems configs.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: executableitems
            item: 'world_teleporter'
            amount: 1

EcoItems

The item field supports any item ID that EcoItems normally would. The general format for items created by EcoItems is ecoitems:item_id.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: custom_item
            plugin: ecoitems
            item: 'ecoitems:enchanted_ender_eye'
            amount: 1