- Native Minecraft Version:
- 1.18
- Tested Minecraft Versions:
- 1.13
- 1.14
- 1.15
- 1.16
- 1.17
- 1.18
- Source Code:
- https://github.com/zivoric/ZEnchantmentCore
![]()
ZEnchantmentCore is a base API for building custom enchantments. It allows developers to create plugin addons relatively easily that function off of events. The heavy lifting is done for you -- building an enchantment addon only requires a few steps. Some of the main functionalities include:
There is a sample addon, ZEnchantments-Basic, provided in the Useful Links section that has many different enchantments to test out. If you don't want to program your own implementing plugin or would rather save time, you can just use that plugin and have fun with it.
- Creating custom enchantments triggered by various events (such as block breaking, dealing damage, taking damage, fishing, etc.)
- Customizable enchantment names show up in item description
- Enchantments work with vanilla Minecraft features, including loot generation, enchantment tables, and anvils.
- Uses a custom enchantment generator that can be customized in configuration
- Enchantments can be selectively disabled in configuration
- And more!
Note: Anything that does not work as intended should be reported to either here or GitHub.
Support
Currently supports Minecraft versions 1.13-1.18.
New versions of Minecraft will be supported as they release. Since version 2.0, support for future versions will be much faster and easier as it no longer requires NMS. Versions before 2.0 only support 1.16 and should not be used.
Commands
/ze or /ze help - Gets information on the plugin.
/ze list - Lists all added enchantments from all addons.
/ze check - Checks all enchantments on main hand item.
/ze reload - Reloads the plugin configuration.
/ze info - Gets information about a specified enchantment.
/ze enchant - Enchants the currently held item a specified custom enchantment.
/enchant - Override of the vanilla enchant command that supports custom enchantments.
Permissions
zenchantmentcore.help - Allows player to use /ze help.
zenchantmentcore.util - Allows player to use /ze utility commands (such as /ze list).
zenchantmentcore.reload - Allows the player to reload the plugin's configuration.
zenchantmentcore.enchant - Allows the player to use the enchantment command provided by the plugin.
Useful Links
Source Code - https://github.com/zivoric/ZEnchantmentCore
Javadocs - https://zivoric.github.io/ZEnchantmentCore
Wiki - https://github.com/zivoric/ZEnchantmentCore/wiki
Example Enchantment Addon - https://www.spigotmc.org/resources/zenchantments-basic.95984/

ZEnchantmentCore v2.1.1
Event-based API for creating custom enchantments.
Recent Updates
- ZEnchantmentCore v2.1.1 Jan 7, 2022
- ZEnchantmentCore v2.1.0 Jan 4, 2022
- ZEnchantmentCore v2.0.0 - Full Release Sep 5, 2021