EnchantmentsPlus

Bukkit Plugins
13,421 Downloads Last Updated: May 1, 2022 Game Version: 1.18.2   +4

Enchantments+

1.15.2 Support
Version 3.1.0 to 3.1.6 supports it natively, later versions do not include that support


1.16.5 Support
Following 4.0.0 the version is still supported codewise, however you need to severely tinker with the magicCompat.yml file in order to get full functionallity. Consider just copying it from your 3.1.6 install

Description

While we currently don't add or remove any enchantments (compared to Zenchantments), we will attempt to rebalance them and make them futureproof. In essence, we attempt to make this fork as stable as possible to support production-grade Servers. We also introduce the one or other twist, such as colourable lasers (pointless, I know)!
Now to copy the original plugin's description:

Zenchantments is a custom enchantment plugin that adds 70+ new enchantments (it doesn't feel like much, to be honest) to the game, covering a multitude of different uses. These include target-tracing arrows, lumber axes, block-breaking lasers, and much more. These custom enchantments are obtained through the normal enchantment process and act like regular enchantments, capable of being combined and merged. The plugin requires no client-side mods or resource packs. A comprehensive configuration file enables fine-tuning of individual enchantments to tailor them to every server's gameplay.​

We also provide a magicCompat.yml so you can be prepared for the future and a patches.yml so you can tailor said gameplay experience even more (as well as borking the plugin)!


FAQ
How do I get support?

You can get support through multiple ways, either through Spigotmc conversations, Internet Relay Chat or Github Issues and Discussions. I try to be as active as possible on all three, however Github and IRC is where I'm the most active on.

Lore getters or NBT getters? What's the difference anyway?

We currently support 4 differerent Enchantment getters, which can be split in 4 categories.

Category 1 (leightweight getters):
These getters are more performant than the others, includes lwNBT and PR47-lore, they lack some features though
Category 2 (heavyweight getters):
These getters include advLore and NBT, both are less performant than the leightweight getters and as such should only be used if you need one of their features, they are the same to their leightweight counterparts in the core though
Category 3 (lore getters):
I believe that lore getters are even faster than NBT getters, but this is disputed - it could've conincided with another optimisation I did at that time.
Lore getters have the pro that they are very versatile and can be used to accept your old Zenchantments enchantments.
They WILL however break if you choose to change the name of the lore or set the name of the lore to ""!
Category 4 (PDC getters):
The Persitent data container getters (often referred as to NBT getters) are the most stable ones and according to the spigot community are even faster than the lore getters.
They will accept "invisible" enchantments and the change of the name of enchantments, however cannot convert from other getters, in case you want to convert the enchantments, use an old 1.1.x version for the meantime.​
The biggest source of lag will be your Anticheat and Permission handle either way (depending on whether or not it listens to bukkit events), so if you want to save some CPU Power, then shut it off or configure it properly.


Does this work with 1.8.x/1.12.x/1.15.x?

These versions do not run well with Java 16, which this plugin requires


Why would I use this over any other CE plugins?

This plugin is focusing on stabillity, bug will exist, sure, but we attempt to introduce next to no bugs. Additionally, the plugin does not make use of NMS (net.minecraft.server) which makes it upwards-compatible. So as soon as a new Spigot version is released, we are supporting it, at a higher or lesser extend.
The plugin is also compatible with Zenchantments, provided that you are using a Lore Getter
In case you find a bug, report it to me and I'll do the best to fix it


Can you implement XYZ?


Permissions
enchplus.enchant.get - On player enchant event, allow player to have a chance at the enabled custom enchantments
enchplus.enchant.use - Allow player to use the given custom enchants on an item
enchplus.command.reload - Access to /ench reload, to reload the configuration (try not to use, may lead to memory leaks)
enchplus.command.give - Gives an enchanted item, while similar to enchant, it also gives the underlying material
enchplus.command.list - Lists all availiable enchantments
enchplus.command.info - Returns the info of an enchantments
enchplus.command.onoff - Abillity to turn on / turn off a certain enchantment
enchplus.command.enchant - Enchants a item without giving the underlying material. Also allows to enchant other people's stuff, so be cautious.
enchplus.command.lasercol - Enables the abillity to colo(u)r the laser of your item in hand. Purely cosmetic and a good way to get a few extra "donations".

Commands
/ench - General command where everything within the plugin is handled
/ench give <Player> <Material> <enchantment> <?level> ... - gives the target the given enchanted item
/ench version - shows the version info of the plugin
/ench lasercol - sets the colo(u)r of the item in hand
/ench <enchantment> <?level> <?modifier> <?doNotification> - enchants the item in hand of the given player
/ench help - lists all availiable commands

Enchantments
A list of enchantments can be found at https://github.com/Geolykt/EnchantmentsPlus/wiki/List-of-Enchantments albeit it's currently not complete due to my lazyness

Compatibility
The current version of this plugin is fully compatible with Spigot version 1.17 and 1.16.5. Versions above 1.17 may work, but that is not fully guaranteed

Changes performed in this fork
to view the changes that were performed, got o https://github.com/Geolykt/Enchantm...-this-fork-compared-to-nms-less-zenchantments

Comments

Posts Quoted: