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:
1
<enchantment name>:
2
display: "<enchantment display>"
3
description: "<enchantment description>"
4
applies-to: "<applies to>"
5
type: "<enchantment type>"
6
group: "<group>"
7
applies:
8
- <material>
9
levels:
10
<level number>:
11
effects:
12
- "<effects>"
Copied!
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
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
1
<enchantment name>:
2
display: "<enchantment display>"
3
description: "<enchantment description>"
4
applies-to: "<applies to>"
5
type: "<enchantment type>"
6
group: "<group>"
7
applies:
8
- <material>
9
settings:
10
<setting>: <value>
11
levels:
12
<level number>:
13
cooldown: <number>
14
chance: <number>
15
condition:
16
- "<condition>"
17
effects:
18
- "<effects>"
Copied!
settings
Used to dictate special things for that specific enchantment