Skip to content

File objects

srnyx edited this page Jun 2, 2023 · 20 revisions

Table of contents

Bold keys are REQUIRED, everything else is optional!

Sound ↑

Examples

sound: # This is just the parent node, it won't always be 'sound'
  sound: ENTITY_GENERIC_EXPLODE # https://helpch.at/docs/MC_VERSION/org/bukkit/Sound.html
  volume: 0.5
  pitch: 1.5
  category: BLOCKS # https://helpch.at/docs/MC_VERSION/org/bukkit/SoundCategory.html
sound: # This is just the parent node, it won't always be 'sound'
  sound: ENTITY_EXPERIENCE_ORB_PICKUP # https://helpch.at/docs/MC_VERSION/org/bukkit/Sound.html

Attribute modifier ↑

This is only available for 1.9 and higher!

The attribute the modifier will affect is not included here, as it is usually the name of the key like in Item stacks

Examples

attribute-modifier: # This is just the parent node, it won't always be 'attribute-modifier'
  name: health_boost
  operation: ADD_NUMBER # https://helpch.at/docs/MC_VERSION/org/bukkit/attribute/AttributeModifier.Operation.html
  amount: 5
  slot: HEAD # 1.13.2+, https://helpch.at/docs/MC_VERSION/org/bukkit/inventory/EquipmentSlot.html
attribute-modifier: # This is just the parent node, it won't always be 'attribute-modifier'
  name: health_boost
  operation: MULTIPLY_SCALAR_1 # https://helpch.at/docs/MC_VERSION/org/bukkit/attribute/AttributeModifier.Operation.html

Item stacks ↑

Examples

item: # This is just the parent node, it won't always be 'item'
  material: DIAMOND_PICKAXE # https://helpch.at/docs/MC_VERSION/org/bukkit/Material.html
  count: 1
  damage: 561 # Since Diamond Pickaxes have 1,561 durability, the new durability will be 1,000
  name: "&c&lGOD PICKAXE"
  lore:
    - "&7The most epic pickaxe in the game!"
    - "&7&oMake sure not to drop it..."
  enchantments: # https://helpch.at/docs/MC_VERSION/org/bukkit/enchantments/Enchantment.html
    DIG_SPEED: 5 # Efficiency 5
    LOOT_BONUS_MOBS: 2 # Looting 2
  flags: # https://helpch.at/docs/MC_VERSION/org/bukkit/inventory/ItemFlag.html
    - HIDE_UNBREAKABLE
    - HIDE_ENCHANTS
  data:
    owner: srnyx
    instakill: true
    points: 5
  unbreakable: true # 1.11+
  attribute-modifiers: # 1.13.2+, https://helpch.at/docs/MC_VERSION/org/bukkit/attribute/Attribute.html
    GENERIC_ATTACK_DAMAGE:
      name: attack_boost
      operation: ADD_NUMBER
      amount: 20
    GENERIC_MAX_HEALTH:
      name: health_boost
      operation: ADD_SCALAR
      amount: 5
  custom-model-data: 4508 # 1.14+
item: # This is just the parent node, it won't always be 'item'
  material: APPLE # https://helpch.at/docs/MC_VERSION/org/bukkit/Material.html
  count: 32

Recipes ↑

  • ingredients: The character aliases and their corresponding materials (key is the character, value is the material) https://helpch.at/docs/MC_VERSION/org/bukkit/Material.html
  • shape: The shape the recipe should take, or, if shapeless, it will be used to get the amount of each ingredient. This should use the characters listed in ingredients and only be 3 rows
  • result: The end result of the recipe (see Item stacks above for more info)
  • shapeless: Whether the recipe requires a specific shape

Example

recipe: # This is just the parent node, it won't always be 'recipe'
  ingredients: # https://helpch.at/docs/MC_VERSION/org/bukkit/Material.html
    A: APPLE
    G: GOLD_BLOCK
  shape:
    - "GGG"
    - "GAG"
    - "GGG"
  shapeless: false
  result:
    material: ENCHANTED_GOLDEN_APPLE

Clone this wiki locally