Enchantments
Information about pickaxe enchantments
Enchantments can be added through the Pickaxe GUI. Enchantments must all have a defined cost, slot of where they are displayed in the GUI, max level, and display information. Enchantments can also have other settings within the enchants.yml depending on what they inherit. All enchantments have a minimum level of 1 and must have a unique name.
Custom enchantments that extend the VanillaEnchantment class add a vanilla enchantment to the item based upon what level the custom enchantment is. This is based upon a setting called
levelsPerVanillaLevel. The level of the vanilla enchantment is calculated as follows:
Example:
levelsPerVanillaLevel: 30
Custom enchant level = 65
65/30 = 2.17 -> 2
Always rounded down as an integerEfficiency increases the speed at which the tool can mine. The mining speed is fully based upon that of the vanilla enchantment and does not use unique attributes, packets, etc.
Default Max Level | Default levels/vanilla level |
100 | 20 |
Fortune increases the number of drops that a player can get from certain ores and materials. The vanilla fortune calculation is actually canceled and PrisonPick does its own calculation that is the exact same. This is because Spigot API was not consistent across versions, so I had to create my own loot table. All calculations are the exact same as those on this page.
The custom calculation of Fortune will not affect the calculation of non-custom items.
Ore |
Coal Ore |
Nether Quartz |
Diamond Ore |
Emerald Ore |
Nether Gold Ore |
Lapis Lazuli |
Redstone |
Default Max Level | Default levels/vanilla level |
100 | 20 |
Potion enchantments give a particular potion effect when the custom item is held. All potion effects given by an enchantment have an unlimited duration. The level of the potion also depends on the level of the custom enchantment. This is calculated by a setting called
levelsPerPotionLevel. The level of the potion is calculated as follows:
Example:
levelsPerPotionLevel: 2
Speed enchant level = 3
3/2 = 1.5 -> Speed 1
Always rounded down as an integerPotion effects are added when a player switches their current item to the pickaxe. So if you just upgraded the enchantment and you don't have the effect, try switching items.
The custom enchantment of Haste gives the potion effect Haste. This will increase how fast the player digs.
Default Max Level | Default levels/potion level |
5 | 1 |
The custom enchantment of Speed gives the potion effect Speed. This will increase how fast the player runs.
This enchantment may not be a potion enchantment in the future, but rather, it may change the attribute of the player's walking speed. - This will depend on user feedback.
Default Max Level | Default levels/potion level |
5 | 1 |
The custom enchantment of Jump Boost gives the potion effect Jump Boost. This will change how fast the player can jump.
Default Max Level | Default levels/potion level |
4 | 1 |
The custom enchantment of Night Vision will give the potion effect Night Vision. This will change how easily the player can see in the dark.
Setting the max level of this enchantment to higher than 1 will do nothing unless you also change the default levels/potion level. Doing this would mean the player needs to upgrade the enchantment enough times to actually get the potion effect; however, this is not recommended. It is recommended that you instead, increase the price of this enchantment and keep the default max level as 1.
Default Max Level | Default levels/potion level |
1 | 1 |
Last modified 1yr ago