WederEnchantFixer

• High-Level Enchantment Display Fix
  Replaces Minecraft's default high-level enchantment display with clean,
  readable custom lore.
  
• Spanish Enchantment Names
  Automatically translates vanilla enchantment names into Spanish.
  
• Minecraft 1.21+ Enchantments
  Includes newer enchantments such as Density, Breach, Wind Burst and Lunge.
  
• Automatic Fallback
  If the server registers an enchantment without a predefined translation,
  WederEnchantFixer automatically falls back to its NamespacedKey.
  
• Roman & Arabic Levels
  Choose how enchantment levels are displayed directly from config.yml.
  
  Roman:
  
  Code (Text):

  
  I II III IV V X XX
   
  Arabic:
  
  Code (Text):

  
  1 2 3 4 5 10 20
   
• Packet-Based System
  Uses ProtocolLib to intercept inventory packets such as
  SET_SLOT and WINDOW_ITEMS.
  
• Does Not Modify Real Items
  Only the ItemStack representation sent to the client is changed.
  The real item stored in the inventory or world remains untouched.
  
• Registry-Based Enchantment Resolution
  Enchantments are resolved using Registry and NamespacedKey.
  
  If an enchantment does not exist on the running Minecraft version,
  it is safely ignored instead of breaking plugin startup.
  
• Hot Configuration Reload
  Change the level format and apply it without restarting the server:
  
  Code (Text):

  
  /wederenchantfixer reload
   
  or:
  
  Code (Text):

  
  /wef reload
   
• Lightweight
  Focused entirely on fixing enchantment visualization without adding
  unnecessary gameplay systems or background features.

WederEnchantFixer does not permanently modify your items.

ProtocolLib intercepts inventory packets before they reach the Minecraft client.


The server continues storing the original ItemStack while the player receives
a modified visual representation.

This allows WederEnchantFixer to change how enchantments appear without
changing the actual enchantment data.


The enchantment level format can be configured inside:

For Roman numerals:
Example:
For Arabic numbers:
Example:
After changing the configuration, apply it immediately with:
or:
No server restart is required.

WederEnchantFixer translates vanilla Minecraft enchantments into Spanish.

This includes classic enchantments and newer enchantments introduced
in Minecraft 1.21+.

Examples include:

• Protección
• Filo
• Eficiencia
• Irrompibilidad
• Fortuna
• Poder
• Infinidad
• Reparación
• Densidad
• Fisura
• Ráfaga de viento
• Estocada

The plugin uses the server's enchantment Registry and NamespacedKey system
instead of assuming that every enchantment exists on every Minecraft version.

If an enchantment is unavailable on the current version, it is skipped safely.

If a registered enchantment does not have a predefined translation,
its key is used as a fallback.


ProtocolLib 5.4.0 or newer is required.

WederEnchantFixer uses ProtocolLib to intercept and modify the ItemStacks
contained inside inventory packets.
If ProtocolLib is not installed, WederEnchantFixer automatically disables
itself during startup and displays a message in the console.

VERY NEW MINECRAFT VERSIONS

ProtocolLib relies on internal CraftBukkit/Paper implementation details
to read and write ItemStacks contained in packets.

Because of this, when a new Minecraft version is released, ProtocolLib may
require an update before fully supporting it.

ProtocolLib may display a message similar to:
If packet rewriting fails because ProtocolLib does not yet support the
Minecraft version, WederEnchantFixer detects the failure and stops attempting
to rewrite enchantment lore for the remainder of that server session.

Only one warning is logged instead of repeatedly filling the console with errors.

In this situation, install a ProtocolLib build compatible with your exact
Minecraft version.

Command	Alias	Permission	Description
/wederenchantfixer reload	/wef reload	wederenchantfixer.reload	Reloads config.yml without restarting the server.

The permission defaults to:

Dependency	Version	Required
Spigot / Paper	1.20+	Yes
ProtocolLib	5.4.0+	Yes
Java	21 - 26	Yes

WederEnchantFixer supports Minecraft 1.20 and newer versions supported
by Spigot/Paper.

Compatibility with extremely new Minecraft versions may temporarily depend
on ProtocolLib providing support for that specific version.

1. Download WederEnchantFixer.jar.
   
2. Install ProtocolLib 5.4.0 or newer.
   
3. Place both plugins inside your server's:
   
   Code (Text):

   
   plugins/
    
4. Start or restart the server.
   
5. WederEnchantFixer will automatically generate:
   
   Code (Text):

   
   plugins/WederEnchantFixer/config.yml
    
6. Choose your preferred enchantment level format:
   
   Code (Text):

   
   level-format: ROMAN
    
   or:
   
   Code (Text):

   
   level-format: ARABIC
    
7. Apply configuration changes with:
   
   Code (Text):

   
   /wederenchantfixer reload
    
   or:
   
   Code (Text):

   
   /wef reload
    

BEFORE & AFTER

BEFORE
Default high-level enchantment display:


AFTER
High-level enchantments displayed with WederEnchantFixer: