EnchantmentPlus 4.0.1

High performance fork of Zenchantments, a CustomEnchantments plugin

  1. Geol
    Native Minecraft Version:
    1.17
    Tested Minecraft Versions:
    • 1.16
    • 1.17
    Source Code:
    https://github.com/Geolykt/EnchantmentsPlus
    Contributors:
    zedly, rfrowe, kyematzen, Throneos, HiImMrSalty, levtey, 2008Choco
    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
    Anrehah, ENCOM, arixgry and 1 other person like this.

Recent Reviews

  1. 0verzealous
    0verzealous
    4/5,
    Version: 4.0.1
    wont let me combine to efficiency 5 and in some cases add mending and other enchantments otherwise amazing plugin
    1. Geol
      Author's Response
      It's best if you were to create an issue over at github, that being said this doesn't look like something I'd be able to reproduce alone, so best also add a step by step instruction list on how to reproduce it.
      Enchantment merging has been kindof strange for many lately and I have been completely unable to reproduce it
  2. llamamonium11
    llamamonium11
    5/5,
    Version: 4.0.1
    Awesome but you can't see the enchantment descriptions on each enchant on a item to show what they do.
  3. Chrismwiggs
    Chrismwiggs
    5/5,
    Version: 3.1.4
    Found this fork a few months ago and was so glad to see someone breathing new life into it! It's a great enchantment plugin that integrates really fluidly into the vanilla enchanting system.

    The dev has been great working on fixes as issues come up and is surprisingly fast to fix things! Great work :D
  4. 01113wood
    01113wood
    4/5,
    Version: 2.2.2
    Friend I have a problem some enchantments are not working well on my paper spigot 1.16.4 server, why is this problem?
    1. Geol
      Author's Response
      it could be anything honestly as this is pretty indescriptive.
      However It's likely that you are using the enchantments wrong. (Lumber for example requires you to sneak in order to work)
  5. vanhoekje
    vanhoekje
    5/5,
    Version: 2.2.1
    good, but why the enchantments still Enchantement if the plugin is removed? :D
    I'm confused D:
    1. Geol
      Author's Response
      I'm also a bit confused, but if you were to remove the plugin (which is what you seem to mean) the enchantments stay within the lore, however do nothing. This could confuse players which is why I don't recommend to remove this plugin and any other CE plugin.
  6. Silverbulletgms
    Silverbulletgms
    5/5,
    Version: 2.2.1
    This is my favorite custom enchantments plugin out there and I am eternally grateful that there is a fork being maintained and updated for the future! We have used it on my server for many years now!
  7. Minestick
    Minestick
    5/5,
    Version: 2.1.5c
    I'm so glad to see this plugin reborn, in a more stable and efficient fashion. Please keep up the good work!
  8. dinoboss2001
    dinoboss2001
    5/5,
    Version: 1.2.1
    me gusta wapo esta bueno onque no enitneod que es zenchants pero lo demas esta super good
    1. Geol
      Author's Response
      Any chance you can reword your review in English? That would help a lot