Damage

Determines how much durability damage items take on death.

effects:
  damage:
    mode: "PERCENTAGE"
    min: 10.0
    max: 25.0 # Between 10% and 25%
    dont_break: true
    use_enchantments: true
    filters:
      items:
        - "SHEARS"
        - "G:RESOURCES"
      slots:
        - "ALL"

mode

mode: "PERCENTAGE"

• SIMPLE: Damages for a random amount of durability points between min and max
• PERCENTAGE: Damages for a percentage of max durability between min and max for the stack
• ALL: Damages for a percentage of current durability between min and max for the stack

min

min: 10.0

the minimum bounds for the operation

max

max: 10.0

the max bounds for the operation

dont_break

dont_break: true

If true, items will not be allowed to break from damage. Defaults to false.

use_enchantments

use_enchantments: true

If true, the item's enchantments (like Unbreaking) will be taken into account when applying damage. Defaults to false.

Filters:

filters:
  items:
    - "SHEARS"
    - "G:RESOURCES"
  slots:
    - "ALL"

Allows you to make sure the effect only applies to certain items based on various criteria.

Filter options

Items

items:
  - "SHEARS"
  - "G:RESOURCES"

A List of items that are affected by this effects. Defaults to all items.

Supports Resource Lists for item groups.

Slots

slots:
  - "ALL"

A list of slots that are affected by this effect. Defaults to all slots.

Name

name:
  - '!*Crate Key*'

A string or list of strings matched against the item's custom name. Items without a custom name are matched as an empty name.

• An item is affected if its name matches any entry.
• Entries must match the whole name and are case-sensitive. Use * as a wildcard, e.g. *Key* matches any name containing Key.
• ! at the start matches names that do not match the rest, e.g. !*Soulbound* affects every item without Soulbound in its name.

note

Because an item only has to match one entry, several ! entries don't stack: ['!*Key*', '!*Soulbound*'] still affects a Crate Key, since it doesn't contain Soulbound. Unlike item lists, there's no * then ! pattern here.

Lore

lore:
  - '!*Soulbound*'

A string or list of strings matched against each line of the item's lore, using the same matching as name.

• An item is skipped if any of its lore lines doesn't match an entry.
• Items without lore are always affected.

This makes it most useful for protecting items: !*Soulbound* affects every item, except ones with a lore line containing Soulbound.