Creating Enchantments

Homepage Purchase AdvancedEnchantments Join Discord

Search…

Basic guide on creating enchantments

​Click here to create enchantments via Web Panel! No configuration required.
The enchantment creation process may seem difficult to begin with, but once you get the hang of it, it will become miraculously easy to do so. Firstly practice making simple enchants before getting into more complex creations.
Starting out
Firstly, a basic understanding of the enchantment template is required to start creating enchantments. Here's a run over the simple formatting:
<enchantment name>:
  display: "<enchantment display>"
  description: "<enchantment description>"
  applies-to: "<applies to>"
  type: "<enchantment type>"
  group: "<group>"
  applies:
    - <material>
  levels:
    <level number>:
      effects:
       - "<effects>"
This will be the basic template to use/learn when creating enchantments. Let's run over each of the required settings:
<enchantment name>
This will be the "back end" enchantment name, used in all commands/admin processes
Enchantment name must be written using lowercase​
display
This will be displayed in item lore, chat messages, and book formats
Color codes can be used with the display
Special placeholders:
%group-color% - Use group's global color code
description
This will be the enchantment's description, used in various Menu's and book formats
Supports "\n" character to split to the new line. Requires double-quotes symbol (") instead of single (')
Color codes can be used with the display
applied-to
This will be used in Menu's, book formats, and chat messages
Tells user which item category it may apply to (for instance: 'Armour', 'Weapons', etc.)
applies-to is visual only, meaning it won't have effect on what items it can actually be added onto
type
Defines what triggers this enchantment
Enchantment types can be found here​
group
This sorts enchantment into specified groups from groups.yml file [TODO: create groups.yml page]
This will also hint at the plugin what global color should be used for display
Group name needs to be all UPPER-CASE
applies
Sets a specified list of items which this enchantment can be added onto
Supports plugin shortcuts such as:
ALL[material]_ - Sets all specified material items ([Wooden, Stone, Iron, Diamond, Gold, Chain], e.g.: 'ALL_SWORD' will allow all types of swords)
_[material]ARMOR - Supports all type of specified armor (Can also be used with the previous shortcut to create ALL_ARMOR item type, which will allow all possible armor pieces)
Other Options
There are a few other options that can be used when creating enchantments for more customization. These options are not required to create a basic enchant
<enchantment name>:
  display: "<enchantment display>"
  description: "<enchantment description>"
  applies-to: "<applies to>"
  type: "<enchantment type>"
  group: "<group>"
  applies:
    - <material>
  settings:
    <setting>: <value>
  levels:
    <level number>:
      cooldown: <number>
      chance: <number>
      condition:
        - "<condition>"
      effects:
        - "<effects>"
settings
Used to dictate special things for that specific enchantment
Full list of settings can be found here​
cooldown
The length between enchantment activations
Time is measured in seconds
By default, if no cooldown is specified, is 0 seconds
chance
The chance of the enchantment activating when the type is triggered
Measured from 0-100
By default, if no chance is specified, is 100%
condition
Require a certain placeholder to be parsed for enchant to activate
Supports PAPI placeholders
Have as many conditions as you want
In depth guide on conditions can be found here​

Cosmic Enchants (200+)

Type List

Last modified 5mo ago

Copy link

On this page

Click here to create enchantments via Web Panel! No configuration required.

Other Options

​Click here to create enchantments via Web Panel! No configuration required.

Starting out

Other Options