FixVanillaEnchantments

Automatically fixes illegal enchantments — no lag, no manual commands.

Ever found a sword with Sharpness X? Full armor with multiple incompatible protection enchantments? Or an item carrying an enchantment it should never have?

Whether caused by an old exploit, a misconfigured plugin, or items imported from another server, illegal enchantments can eventually find their way into your economy.

FixVanillaEnchantments automatically detects and corrects them as soon as they appear.

No manual inspections. No repetitive admin commands. Just clean, vanilla-compatible items.

---

Features

• Configurable enchantment level limits for every vanilla enchantment

• Detects incompatible enchantments and resolves them automatically

  • Sharpness + Smite
  • Fortune + Silk Touch
  • Protection + Fire Protection
  • And more

• Configurable priority system to decide which enchantment should be kept

• Removes invalid enchantments from items that cannot normally receive them

  • Example: Aqua Affinity on a sword

• Scans Shulker Boxes, including the items stored inside them

• Scans containers when they are closed:

  • Chests
  • Barrels
  • Ender Chests
  • Dispensers
  • Droppers

• Automatic protection triggers:

  • Player join
  • Inventory clicks
  • Inventory drag
  • Picking up items
  • Hotbar switching
  • Offhand swapping
  • Inventory closing

• /fixmyitems allows players to manually scan and fix their own inventory

• Detailed correction messages showing exactly what changed

• Sharpness X → Sharpness V

• Silk Touch → removed

• Fully translatable

  • English included
  • Spanish included
  • All messages are configurable through language files

• Asynchronous correction logging

  • Logs are written asynchronously to minimize impact on server performance

• Individually configurable triggers and messages

  • Enable or disable each behavior independently

---

Commands & Permissions

Command	Permission	Default	Description
/fixmyitems	fixvanillaenchants.use	Everyone	Fixes the sender's own inventory
/fixenchants-reload	fixvanillaenchants.reload	OP	Reloads configuration and language files

Aliases:

• /fixme
• /fixitems
• /fereload

---

Example

An illegal item enters the server:

Diamond Sword
Sharpness X

FixVanillaEnchantments detects the invalid enchantment and automatically applies the configured limit:

Sharpness X → Sharpness V

The correction can also be reported to the player and recorded in the plugin's log.

---

Configuration

Everything is designed to be configurable.

You can control:

• Maximum level for each enchantment
• Enchantment compatibility
• Priority when conflicts occur
• Automatic correction triggers
• Player correction messages
• Logging
• Language
• And more

This allows you to make FixVanillaEnchantments as strict or as lightweight as your server requires.

---

Requirements

• Paper / Spigot 1.20+
• Java 17+
• No external dependencies