[SPIGOT-5336] 1.16.x Rename Enchantments Created: 21/Sep/19  Updated: 23/Apr/24  Resolved: 23/Apr/24

Status: Resolved
Project: Spigot
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: New Feature Priority: Minor
Reporter: Shane Bee Assignee: Unassigned
Resolution: Fixed Votes: 22
Labels: 1.16, enchantments, future

Version: n/a
Guidelines Read: Yes

 Description   

I would like to suggest the renaming of the Enchantments in Bukkit to match the Minecraft namespaces for enchantments, preferably done whilst Bukkit/Spigot/Craftbukkit is updated to 1.16

WHY:
The current names for many of the enchantments (Which Im assuming Bukkit did this years ago) make next to no sense at all.
Ex:
DAMAGE_ALL = sharpness.
The docs for this say "Increases damage against all targets"
For a developer who's been doing this for a while, its fairly simple to figure them out (looking at the source code) but for a developer whom is new the Spigot/Bukkit development, some of these might be hard to decipher.
In my opinion, these should have been updated in 1.13, when materials and biomes were done, to keep consistency with Minecraft.

HOW:
To help reduce the amount of breakage in current plugins, I would recommend maybe adding the new names to the enchantments list, and keeping the old names as deprecated, this way plugins using the old enchantments will still work, but also give them a warning in their IDE to update to the new enchantment names.
Obviously the returns (for ex: checking the enchants on an ItemStack) would have to return 1 of the 2. I would assume the new ones. I understand this could possibly break some plugins, but in retrospect, I think most plugins using enchantments, are using them to enchant an item vs actually checking if an item is enchanted.

WHEN:
This wouldn't make sense to do in 1.14.4, which is why I suggest doing this in 1.15.

This would be something good to do in 1.16. A lot of new things will be coming in 1.16 that will most likely massively change up the API so I think then is a great time to stir things up!

I totally understand this getting denied, as it could very possibly break plugins as well as diminish the possibility of backwards compatibility.
I do however hope it is taken into consideration to help with moving the Bukkit API forward into having better consistency with Minecraft.

I wanted to make this suggestion early before a lot of development is done on 1.16. Clearly it won't go public for MONTHS, but thought I'd get an early start.

Thank you for reading, and thank you for the consideration.

EXTRA:
I decided to create a thread on the forums to get a general consensus from the community
https://www.spigotmc.org/threads/1-15-renaming-enchantments.396853/



 Comments   
Comment by YourCoal [ 14/Feb/20 ]

There are also particles that need renaming... I don't have them on-hand unfortunately, but off the top of my head some of the villager ones are wrong.

hi-im-b In 1.16 PIG_ZOMBIE will be renamed to ZOMBIFIED_PIGLIN, just a FYI.

Comment by Josh Sperry [ 14/Feb/20 ]

In addition, a few entity type names are not the same as their mob egg material names.

Examples I've noticed:

MUSHROOM_COW -> MOOSHROOM

PIG_ZOMBIE -> ZOMBIE_PIGMAN

Comment by Yannick Lamprecht [ 13/Dec/19 ]

Or rename it to 1.15.x /1.16.x

Comment by Shane Bee [ 11/Dec/19 ]

I guess we can close this now, since it didn't get done.

Comment by Shane Bee [ 01/Oct/19 ]

It was brought to my attention earlier today on the thread on the forums, that potion effect types should also be done.
ex:
Bukkit SLOW = Minecraft "slowness"
Bukkit CONFUSION = Minecraft "nausea"
Bukkit SLOW_DIGGING = Minecraft "mining_fatigue"
etc...

I agree that along side updating the enchantment types that potion effect types should also be updated to bring consistency with the vanilla game.

Generated at Sat Dec 13 15:24:22 UTC 2025 using Jira 10.3.13#10030013-sha1:56dd970ae30ebfeda3a697d25be1f6388b68a422.