Skip to content

Craft Drop

Zazsona edited this page Sep 18, 2021 · 7 revisions

About

Heads with this source type drop as a by-product when players craft items in their inventory, or using a crafting table.

Specification

Source Type Key: CRAFT_DROP
Required Permissions: decorheads.dropheads

Example

  myhead:
    name: My Head
    texture: eyJ0ZXh0dXJlcyI6eyJTS0lOI...
    sources:
      my-drop-source:
        source-type: CRAFT_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

Recipe Results

Tag: recipe-results
Description: Sets the resulting item that needs to be crafted for a head to drop
Example:

recipe-results:
- OAK_PLANKS
- OAK_STAIRS
- OAK_SLAB

Recipe Ingredients

Tag: recipe-ingredients
Description: Sets the ingredients required in a crafting recipe to drop heads. Example:

recipe-ingredients:
- BIRCH_PLANKS
- BIRCH_LOG

In the above example, all items crafted using either birch planks OR birch logs can drop the head.
However, it also also possible to set multiple items that must be included in a recipe's ingredients by providing a list in the list:

recipe-ingredients:
- - SPRUCE_PLANKS
  - SPRUCE_LOG

Now, a head will only drop if both spruce planks AND spruce logs are used.
You can combine these two systems for infinite combinations:

recipe-ingredients:
- BIRCH_PLANKS
- BIRCH_LOG
- - SPRUCE_PLANKS
  - SPRUCE_LOG 

Our head will now have a chance to drop when crafting with: birch planks OR birch logs OR spruce planks AND spruce logs.


Biomes

Tag: biomes
Description: Sets the biomes crafting must be done in for a head to drop. Example:

biomes:
- Desert
- Desert_Hills
- Desert_Lakes

Weather

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

weather:
- CLEAR
- RAIN
- THUNDER
- SNOW

Worlds

Tag: worlds
Description: Sets the worlds crafting must be done 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