Creating Enchantments

How to create your own enchantments

Creating enchantments is a simple process, and you can customize each one to your likings. You can create enchantments via the YAML file or the Web Panel.

Using the Web Panel will require you to generate a link in-game via /ee upload

  headless: #[Name (Lowercase)]
    name: "Headless" #[Display Name]
    description: #[Description]
      - 'Victims have a chance of'
      - 'dropping their head on death.'
    group: "SIMPLE" #[Group]
    applies: "SWORD" #[Application Group]
    type: "KILL" #[Type]
    levels: 
      1: #[Level Number]
        souls: 20 #(OPTIONAL)
        chance: 2.5 #[Chance] (OPTIONAL)
        cooldown: 5 #[Cooldown] (OPTIONAL)
        condition: "isHolding BOW" #(OPTIONAL)
        effects:
          - 'DROP_HEAD:TARGET' #[Effect]

NEW: You can now add multiple types and execute different effects depending on the effect type you have triggered

  test:
    name: "Test"
    description:
      - 'Test enchantment to show the'
      - 'multiple type feature'
    group: "SIMPLE"
    applies: "SWORDS"
    type: "KILL,ATTACK"
    levels:
      1:
        chance: 15
        effects:
          - 'ATTACK;HEAL:ADD:1:3' # Activate on Attack
          - 'KILL;DROP_HEAD:TARGET' # Activate on Kill
          - 'MESSAGE:Can be activated on both:PLAYER'

Value	Description
Name (Lowercase)	This is the id you will use to fetch the enchantment via commands and how the plugin will fetch the enchantment backend.
Display Name	This is the name that gets displayed on the enchantment item and when the enchantment is applied to an item.
Description	This is the text used on the enchantment item.
Group	This is the enchantment group, This can control the color, position, and activation depending on the values you set in the groups.yml.
Applies	These are the items that the enchantment can be applied to. This can be overridden by any user with permission to apply the enchantment using a command.
Type	This is the trigger event, meaning when this happens, the enchantment will activate if all conditions are met.
Effect	These are the custom abilities triggered by the enchantment.