Skip to content

Player Death Drop

Zazsona edited this page Jul 22, 2021 · 5 revisions

About

Heads with this source type can drop whenever a player dies.

Specification

Source Type Key: PLAYER_DEATH_DROP
Required Permissions: decorheads.dropheads

Example

  myhead:
    name: My Head
    texture: eyJ0ZXh0dXJlcyI6eyJTS0lOI...
    sources:
      my-drop-source:
        source-type: PLAYER_DEATH_DROP
        drop-rate: 50

Required Filters

Drop Rate

Tag: drop-rate
Description: Sets the drop rate (as a percentage) for the head to drop. Supports decimal values.
Example: drop-rate: 1.5

Optional Filters

Killed Player Ids

Tag: killed-player-ids
Description: Sets the players, by UUID, that must be killed/die for a head to drop.
Example:

killed-player-ids:
- c06f8906-4c8a-4911-9c29-ea1dbd1aab82
- daca2c3d-719b-41f5-b624-e4039e6c04bd

Blocks

Tag: blocks
Description: Sets the block the player must die on to drop a head. Example:

blocks:
- Dirt
- Gravel
- Sand

Tools

Tag: tools
Description: Sets the tools / items that must be used to kill the player for a head to drop. Any item can be used here, including blocks. Example:

tools:
- Iron_Axe
- Wooden_Axe
- Oak_Planks

Biomes

Tag: biomes
Description: Sets the biomes the player must die in for a head to drop. Example:

biomes:
- Desert
- Desert_Hills
- Desert_Lakes

Weather

Tag: weather
Description: Sets the weather the player must be in for a head to drop. Example:

weather:
- CLEAR
- RAIN
- THUNDER
- SNOW

Worlds

Tag: worlds
Description: Sets the worlds the player must be in for a head to drop. These are identified by level name (normally the same as the folder and case-sensitive)
Example:

worlds:
- world
- world_nether
- world_the_end

Event Invoker

Tag: event-invoker
Description: Sets the whether the kill should be performed by a player or the environment
Example: event-invoker: Player or event-invoker: Environment