Zenchantments
Thanks for joining the Zenchantments Tech Support Discord and reporting bugs.
Try out the 1.20.4 version on the official test server:
Zenchantments is a custom enchantment plugin adds 70+ new enchantments 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. A complete list of all these enchantments can be found below.
Gameplay
Zenchantments seamlessly expands the possible range of enchantments available using the enchanting table. Their appearance is made to match that of the original enchantments as closely as possible!
A freshly enchanted pickaxe with new enchantments
Zenchantments can be merged between tools in the Anvil and removed using the Grindstone.
Using the anvil to apply more Zenchantments to a tool
Once applied, Zenchantments can have effects when a tool is used, when you are under attack or continuously depending on how you deck out your gear.
Pierce mining a tall shaft, Fire smelting logs while being broken
Customization
The displayed name of each Zenchantment can be edited in each world's config file. Before you start editing those though, we will add proper multi language support in the coming weeks.
Because of the way Zenchantments recognizes enchantments on your tools, you must not change the enchantment display names after you have created enchanted items. Items with the old name for an enchantment will cease to work!
Each Zenchantment has a short description which can be enabled towards the bottom of the config file. If you change this setting after creating a few items with Zenchantments, the description will appear/disappear on each tool when it is repaired in the anvil. The enchantments will continue to work regardless of the descriptions setting.
Descriptions allow new players to quickly undersatand the function of the enchantments on their tools
World Safety
Zenchantments does its best to respect protection and logging plugins and is confirmed to work reliably with WorldGuard as well as HawkEye or CoreProtect. Most other protection/claims plugins such as Factions should work and no particular dependencies exist.
A shovel with Shred V is sparing somebody's plot protected by WorldGuard
Installing and Configuration
If you still have a Zenchantments config from an older version, we strongly recommend you to delete the old files, let it generate a fresh set, and re-apply any changes you made.
To install Zenchantments, simply add it to your plugins folder. Zenchantments creates one config file for each world active on your server. In it, you can disable enchantments individually, change their abundance, maximum available level and, for some of them, fine tune their power. To be fair though, the config file is pretty ugly. We can help you set it up if you contact us.
Out of the box, Zenchantments is configured to add a distinctly more powerful late-game experience without ruining the fun of the daily grind. Check out the list of available enchantments to see if there are any deal-breakers in it, then just set their probability to 0.0!
Adding new enchantment configuration manually:
If you don't want to redo your changes to the default Zenchantments config, simply add these items to the end of the list of enchantments in each .yml file:
- Blanket: probability: 3.0 tools: Axe, Shovel, Sword, Pickaxe, Hoe name: Blanket max-level: 3 cooldown: 0 power: 1.0 - Caffeine: probability: 4.0 tools: Helmet name: Caffeine max-level: 3 cooldown: 0 power: 1.0 - Chitin: probability: 5.0 tools: Elytra name: Chitin max-level: 4 cooldown: 0 power: 1.0 - HelpingHand: probability: 3.0 tools: Chestplate name: Helping Hand max-level: 1 cooldown: 0 power: 1.0 - MasterKey: probability: 4.0 tools: Chestplate name: Master Key max-level: 1 cooldown: 0 power: 1.0 - Trough: probability: 5.0 tools: Chestplate, Leggings name: Trough max-level: 1 cooldown: 0 power: 1.0
If you get errors while loading the config file, make sure your text editor didn't accidentally add any Tab characters to any .yml files, because servers are highly allergic to those.
See also
Bug Reporting & Suggestions
Contact us on Discord, here on CurseForge, on GitHub or send an email to [email protected] for any suggestions or bug reports. Don't forget to include Plugin version and a Console error if there is one. Thank you!
Hey always love this pluggin, so tried using it on 1.21 and it keeps breaking, for example it lets me switch modes on pierce but won't let me use it. Limited to 1 enchantment and the other regular enchants aren't there. I hope this gets fixed soon.
Hello, great plugin. I very much enjoy using it on my 1.20.4 server. However, I have encountered many bugs while using this plugin. And yes, I have confirmed I am using the correct 1.20.4 version of the plugin. I hope you can take a look into the following bugs:
1. Speed enchantment doesn't give a speed potion effect. Instead, it gives a Speed Attribute on the item which makes the speed effect extremely high for some reason. Level 1 speed enchantment is basically equivalent to a Speed 5 potion effect.
2. In the config files I should be able to change how the enchant name appears in game. However, this function does not work.
3. Combining enchants in an anvil doesn't work if the book has a custom enchant that doesn't work on the item. For example, if I have an axe and I try to anvil it with a book with "Efficiency 5" and "Jump 3", instead of giving it only the Efficiency, the anvil won't add the book at all to the axe.
4. An Infinity bow with the Burst enchantment will shoot extra arrows, but you can pick them up into your inventory, so it generates extra arrows.
5. Setting the probability to -1 in the config files breaks the entire plugin.
6. Not a bug, but it would be amazing if you could implement custom enchant books into villager trades.
In reply to tofumang_:
Thanks for your feedback! I can address most things immediately:
1. I'll look at the Speed enchantment, personally I always go for Meador. Weird how my favorite enchantments are the ones that work best, right?
2. Changing the display name for enchants was a feature we rushed to add early on before encountering technical issues and spending less time on Minecraft, so it's not currently supported. I hope to get proper i18n working *eventually*, but it hinges on Minecrfat having an ability I haven't tested yet. For now you'll sadly have to consider it non-existant.
3. The anvil is one of the most sensitive mechanics in Zen, because I had to drill deep into the server internals to fix a bunch of dupes. It breaks if you have the wrong server version, an unsupported server species such as Purpur or other plugins with comprehensive anvil logic such as CombatWeaponryPlus. Currently I don't see a way to make this less glitchy. Things used to be simpler..
4. That's a genuine bug and is now on my todo list.
5. You encountered a problem with the YAML parser, which I think is patched in the latest build, but you can avoid it by writing -1.0 instead of -1
6. This has been requested, but I don't plan to add more features for fear of overwhelming tech debt. You can use any custom villager trade plugin and add books with lore that looks like the Zen enchantments, i.e. "&7Shred V". The realization that we can make lore that looks like enchantments is basically what started the whole plugin.
If you want to know more, you're welcome to drop into the discord.
It is not allowing me to combine enchants in an anvil, and I have the enchant limit set to 5. Any ideas?
In reply to bananainabandana1:
Hi! The anvil completely breaking is a telltale sign that you have a build for the wrong NMS version. If you're playing on e.g. a 1.20.4 server, you definitely need the version that says 1.20.4. Hope this helps!
how to change language?
THNX IT REALLY WORK FINE AND CAN YOU MAKE THIS FOR VERSION 1.6
Hello.please fix 1.17.1
[18:42:30] [Server thread/ERROR]: Could not pass event EntityDamageByEntityEvent to Zenchantments v1.9.3[18:42:30] [Server thread/ERROR]: Could not pass event EntityDamageByEntityEvent to Zenchantments v1.9.3java.lang.IllegalArgumentException: Health must be between 0 and 20.0, but was 20.300006866455078. (attribute base value: 20.0, player: 4itek) at org.bukkit.craftbukkit.v1_17_R1.entity.CraftLivingEntity.setHealth(CraftLivingEntity.java:110) ~[patched_1.17.1.jar:git-Purpur-1271] at zedly.zenchantments.arrows.enchanted.SiphonArrow.onImpact(SiphonArrow.java:26) ~[?:?] at zedly.zenchantments.evt.WatcherArrow.entityHit(WatcherArrow.java:39) ~[?:?] at com.destroystokyo.paper.event.executor.asm.generated.GeneratedEventExecutor38.execute(Unknown Source) ~[?:?] at org.bukkit.plugin.EventExecutor.lambda$create$1(EventExecutor.java:69) ~[patched_1.17.1.jar:git-Purpur-1271] at co.aikar.timings.TimedEventExecutor.execute(TimedEventExecutor.java:76) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:70) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:624) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.craftbukkit.v1_17_R1.event.CraftEventFactory.callEvent(CraftEventFactory.java:242) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.craftbukkit.v1_17_R1.event.CraftEventFactory.callEntityDamageEvent(CraftEventFactory.java:1097) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.craftbukkit.v1_17_R1.event.CraftEventFactory.handleEntityDamageEvent(CraftEventFactory.java:981) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.craftbukkit.v1_17_R1.event.CraftEventFactory.handleEntityDamageEvent(CraftEventFactory.java:936) ~[patched_1.17.1.jar:git-Purpur-1271] at org.bukkit.craftbukkit.v1_17_R1.event.CraftEventFactory.handleLivingEntityDamageEvent(CraftEventFactory.java:1129) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.world.entity.LivingEntity.damageEntity0(LivingEntity.java:2083) ~[?:?] at net.minecraft.world.entity.LivingEntity.hurt(LivingEntity.java:1374) ~[?:?] at net.minecraft.world.entity.Mob.hurt(Mob.java:353) ~[?:?] at net.minecraft.world.entity.projectile.AbstractArrow.onHitEntity(AbstractArrow.java:408) ~[?:?] at net.minecraft.world.entity.projectile.Projectile.onHit(Projectile.java:195) ~[?:?] at net.minecraft.world.entity.projectile.Projectile.preOnHit(Projectile.java:186) ~[?:?] at net.minecraft.world.entity.projectile.AbstractArrow.tick(AbstractArrow.java:241) ~[?:?] at net.minecraft.world.entity.projectile.Arrow.tick(Arrow.java:112) ~[?:?] at net.minecraft.server.level.ServerLevel.tickNonPassenger(ServerLevel.java:1190) ~[?:?] at net.minecraft.world.level.Level.guardEntityTick(Level.java:1034) ~[?:?] at net.minecraft.server.level.ServerLevel.lambda$tick$7(ServerLevel.java:807) ~[?:?] at net.minecraft.world.level.entity.EntityTickList.forEach(EntityTickList.java:40) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.server.level.ServerLevel.tick(ServerLevel.java:788) ~[?:?] at net.minecraft.server.MinecraftServer.tickChildren(MinecraftServer.java:1629) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.server.dedicated.DedicatedServer.tickChildren(DedicatedServer.java:492) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.server.MinecraftServer.tickServer(MinecraftServer.java:1480) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1270) ~[patched_1.17.1.jar:git-Purpur-1271] at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:319) ~[patched_1.17.1.jar:git-Purpur-1271] at java.lang.Thread.run(Thread.java:831) [?:?]
In reply to karpiuk1986:
You do realize that NMS-less Zenchantments is deprecated for a good 8 months now?
Instead, use https://github.com/Geolykt/EnchantmentsPlus which is functionally pretty much the same but it is harder to confuse as being unmodified Zenchantments (and I know for a fact that it has this bug fixed).
In the future report issues to the proper repository, this would increase the chance of a bug being fixed.
It's been a while since I've come back. Don't you still support 1.16 and 1.17?
If possible, please let me know how. Not the last time I tried.
Also, when will it be officially released?
how to download 1.16 from github
someone have tutorial or somthing?
Is
May 4, 2020 1.15.2
work on 1.16?
In reply to Rozgran:
From my experience nyes. It does "work" (outside of a minor potential crash iirc) but enchantments weren't parsed correctly from my experience which resulted in the plugin not working as intended. In the end you need to build the plugin from source (which does support 1.16 natively)
Everything is working other than the enchantments themselves. The commands are working, the items get custom enchantments, but enchantments have no effect.
Some extra info:
I use a plugin manager, the plugin has been disabled and enabled quite a lot.
My server is 1.16
I have heavily altered the config of the plugin
I am op, it cannot be a perm problem
In reply to its_a_me_daniel:
The version of Zenchantments hosted here does not support Minecraft 1.16.2 and higher and does not support most Spigot (and forks) releases for Minecraft 1.16.1
In reply to wekabu_city:
Are there ones that do that are hosted elsewhere?
In reply to its_a_me_daniel:
Currently only https://github.com/Zedly/Zenchantments/tree/dev2 (you need to build it yourself though) or using forks, such as EnchantmentsPlus or https://github.com/syndek/zenchantments (which you also need to build yourself).
In reply to wekabu_city:
What do you mean by "build it yourself"?
In reply to its_a_me_daniel:
Install a Java development kit, clone or download the repository and then building it via "./gradlew build" or "./gradlew.bat build" for windows users.
hey! these enchants have been very useful for our smp, would there be any way to make enchants be able to apply on everything?
such as bind on tridents and whatnot.
we're trying to do some custom rp stuff and having some enchants being limited on specific weapons makes it super difficult to balance