Skip to content

Items

Jump to bottom
Esophose edited this page Jun 27, 2022 · 40 revisions

Introduction

Items determine what things will drop from the loot tables, though it is not limited to only item drops. Each type of item has its own special kind of syntax and parameters and will be listed below.

Key

Below you can find links to each type of loot item on this page:

Items

This is probably the most common type of item that you will be wanting to drop: actual items! Making basic items is very simple, but you can do way more than that. Below is the most simple example of how to drop an item.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: item
            item: emerald
            amount: 1

Items have so many settings that they are going to be put onto a separate page which can be found here.

Custom Items

Support for dropping items from custom item plugins can be found here.

Item Tags

It is possible to drop a random item from a specific tag group. A list of possible tags can be found here.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:creeper'
  - 'death-cause:lightning'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: tag
            tag: creeper_music_disc_drops
            amount: 1

Tags support the same parameters as Items.

Entity Equipment

If an entity is capable of holding equipment or has an inventory, you can use this to drop those items. All armor chance parameters are optional and will default to their normal drop chances if not provided. drop-inventory will default to false if not provided.

type: ENTITY
overwrite-existing: items
conditions:
  - 'entity-type:skeleton'
  - 'required-tool:sword,stone'
  - 'enchantment:fire_aspect,2'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: entity_equipment
            helmet-drop-chance: 0.15
            chestplate-drop-chance: 0.07
            leggings-drop-chance: 0.1
            boots-drop-chance: 0.12
            main-hand-drop-chance: 0.16
            off-hand-drop-chance: 0.11
            drop-inventory: false

Experience

Just as it says in the name, this will allow you to drop experience. You can optionally drop bonus experience based on how much equipment the mob that was killed has. To do this, create an equipment-bonus section with a numerical value of how much experience to add per piece of equipment.

type: ENTITY
overwrite-existing: experience
conditions:
  - 'entity-type:skeleton'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: experience
            amount: 5
            equipment-bonus:
              min: 1
              max: 3

Commands

You can run commands for those more exotic actions you want to perform from loot tables.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:villager'
  - 'dimension:normal'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: command
            value: 'say %player% killed a villager at %x% %y% %z% in %world%!'

You can find valid placeholders to be used within commands on the Context Placeholders page.

Loot Tables

Yes, it is possible to run a loot table within another loot table. If you're interested, the vanilla loot table for fishing uses nested loot tables like this. You can find the vanilla loot table in RoseLoot's format in the default examples.

type: ENTITY
conditions:
  - 'entity-type:glow_squid'
  - 'glow-squid-dark'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: loot_table
            value: 'fishing/treasure'

Explosions

Want to have some fun? Cause an explosion! You can configure the explosion power and whether or not the explosion damages blocks or creates fire. The fire and break-blocks parameters are optional and will default to false and true respectively, while power indicates the strength of the explosion.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:bee'
  - 'bee-angry'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: explosion
            power: 5
            fire: false
            break-blocks: true

Sounds

Notify players of special loot being generated! This item type is capable of playing sounds of any volume, pitch, category, and can even play custom sounds from resource packs! You can find a list of valid sound values here. volume and pitch will default to 1, category will default to master (values can be found here), and player-only will default to true if not provided.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:axolotl'
  - 'axolotl-variant:blue'
  - 'axolotl-playing-dead'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: sound
            sound: 'entity.firework_rocket.twinkle'
            volume: 1.0
            pitch: 1.0
            player-only: true

Economy

Want to reward players with money for killing mobs or mining blocks? Supported economy types are currently vault, treasury, playerpoints, and tokenmanager. If you would like direct support for another economy plugin, please request it in our Discord server.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:spider'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: economy
            economy: vault
            amount: 12.5

Messages

It is possible to send messages to the player that caused the loot to be generated. Chat message types include chat_raw, chat, hotbar, title, and subtitle. The title and subtitle types can have 3 optional numerical values (measured in ticks) which all have defaults if not provided. fade-in defaults to 20, duration defaults to 60, and fade-out defaults to 20. Examples of all message types can be found below.

type: LOOT_TABLE
conditions: []
pools:
  0:
    conditions: []
    rolls: 1
    bonus-rolls: 0
    entries:
      0:
        items:
          0:
            type: message
            message-type: chat_raw
            value: '{"text":"Sample chat_raw message","color":"yellow"}'
          1:
            type: message
            message-type: chat
            value: '&eSample chat message. Hello %player%!'
          2:
            type: message
            message-type: hotbar
            value: '&c&o&lSample hotbar message'
          3:
            type: message
            message-type: title
            value: '<r:0.5>Sample title message'
            fade-in: 20
            duration: 60
            fade-out: 20
          4:
            type: message
            message-type: subtitle
            value: '<g:#ff00ff:#00ffff>Sample subtitle message'
            fade-in: 20
            duration: 60
            fade-out: 20

Particles

Make the loot generation a little special with particles! All particle types are supported, you can find a list of them here. Since particles have so many settings depending on the particle type used, details can be found in a collapsed section below the example provided.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:villager'
pools:
  0:
    conditions: []
    entries:
      0:
        conditions: []
        items:
          0:
            type: particle
            particle: end_rod
            amount: 20
            offset-x: 1.0
            offset-y: 1.0
            offset-z: 1.0
            player-only: false
            long-distance: true
Particle Type Values
Particle Data Type Value Name Valid Values Description
All particle Particle The type of particle to display
amount Number Provider The amount of particles to display
offset-x, offset-y, offset-z Number Provider The distance to randomly offset the particles between on each axis
extra Number Provider An extra value normally used for particle random movement, does not work for all particle types
player-only true or false If the particles should only be displayed to the player who caused the loot generation
long-distance true or false If the particles should be visible from any distance. Only applies if player-only is false
DustOptions red, green, blue Number Provider value between 0-255 The display color values of the REDSTONE particles
size Number Provider How large the particles should be displayed. The normal REDSTONE particle size is 1
DustTransition All values from DustOptions plus red-fade, green-fade, and blue-fade Number Provider The color values to fade DUST_COLOR_TRANSITION particles to
ItemStack and BlockData material Material The item/block to display as the particle texture
Vibration time Number Provider How long to display the particles for

Fireworks

Fireworks can be spawned to show that rare or special loot has been dropped. This follows the same format as Firework Effect Meta with a couple extra options. power can be set to a value between -1 and 127, with a negative value making the firework explode instantly. The firework can be set to not deal damage by setting deal-damage: false.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:wither'
pools:
  0:
    entries:
      0:
        items:
          0:
            type: firework
            power: 1
            deal-damage: false
            flicker: true
            trail: true
            type: large_ball
            colors:
              - '#FF00FF'
              - 'orange'
            fade-colors:
              - 'red'
              - '#00FFFF'

Potion Effects

Potion effects can be applied to the looter using the same options as the custom-effects section of Potion Meta.

type: ENTITY
overwrite-existing: none
conditions:
  - 'entity-type:spider,cave_spider'
pools:
  0:
    entries:
      0:
        items:
          0:
            type: potion_effect
            custom-effects:
              0:
                effect: poison
                duration: 100
                amplifier: 1
                ambient: false
                particles: true
                icon: true

Change Tool Durability

Allows adding or removing durability from a tool. amount is a number provider, negatives values will damage the tool, positive values will repair it. Setting ignore-unbreaking to true will make the tool take damage ignoring the unbreaking enchantment. The below example damages a hoe when used to break crops and drops a piece of bonemeal with it.

type: BLOCK
overwrite-existing: none
conditions:
  - 'required-tool:hoe'
  - 'block-type:#crops'
pools:
  0:
    entries:
      0:
        items:
          0:
            type: change_tool_durability
            amount: -1
            ignore-unbreaking: false
          1:
            type: item
            item: bonemeal
            amount: 1

General

Loot Tables

API Usage

Support

Join our Discord Server!

Clone this wiki locally