EnchantmentLimiter

EnchantmentLimiter is a lightweight and configurable Minecraft plugin that allows server owners to limit the maximum level of specific enchantments.

It helps balance gameplay by preventing enchantments from going above configured levels, such as limiting Sharpness, Protection, Efficiency, or any other enchantment.

The plugin is designed to be simple, fully configurable, and server-friendly, while still supporting common enchanting workflows like enchanting tables, anvils, and enchanted books.

---

Key Features

Enchantment Level Limits

Each configured enchantment can have a maximum allowed level.

If a player attempts to receive an enchantment above that level:

• the enchantment will be automatically lowered
• the player will receive a customizable feedback message

Example use cases:

• Limit Sharpness to 3
• Limit Protection to 3
• Limit Efficiency to 4
• Limit Unbreaking to 2

---

Enchanting And Anvil Support

EnchantmentLimiter supports multiple ways players receive enchantments:

Source	Description
Enchanting table	Lowers enchantments from normal enchanting results
Anvils	Lowers enchantments created through anvil combining
Enchanted books	Supports stored enchantments on enchanted books

This helps prevent players from bypassing configured enchantment limits through different vanilla mechanics.

---

Bypass Permission

Specific players or groups can be given a bypass permission.

Players with this permission will completely bypass enchantment limits:

enchantmentlimiter.bypass

By default, this permission is not granted automatically.

---

Fully Configurable

The plugin uses simple enchantment names and JSON configuration.

Example config:

{
  "enchantments": {
    "sharpness": 3,
    "protection": 3,
    "efficiency": 3,
    "unbreaking": 3
  }
}

You can use simple names like:

sharpness
aqua_affinity
fire_aspect

Minecraft namespaced keys such as minecraft:sharpness are also still supported.

---

Customizable Messages

All plugin messages can be edited through the translations file.

Structure:

plugins/EnchantmentLimiter/

config.json

translations/
  messages.json

Example feedback message:

{
  "enchantment_lowered": "%prefix%§f%enchantment% §ehas been lowered from §f%old_level%§e to §f%level%§e!"
}

Example in-game message:

Sharpness has been lowered from 5 to 3!

---

Hot Reload Support

You can reload the configuration and translation files without restarting the server.

/enchantmentlimiter reload

If configuration files are missing, the plugin will automatically recreate them.

---

Commands

Command	Description
/enchantmentlimiter help	Displays all plugin commands
/enchantmentlimiter list [page]	Lists configured enchantment limits
/enchantmentlimiter info <enchantment>	Shows information about an enchantment
/enchantmentlimiter add <enchantment> <level>	Adds a new enchantment limit
/enchantmentlimiter edit <enchantment> <level>	Edits an existing enchantment limit
/enchantmentlimiter remove <enchantment>	Removes an enchantment limit
/enchantmentlimiter reload	Reloads plugin configuration

Alias:

/elim

---

Permissions

Permission	Description	Default
enchantmentlimiter.help	Allows /enchantmentlimiter help	true
enchantmentlimiter.list	Allows /enchantmentlimiter list	op
enchantmentlimiter.info	Allows /enchantmentlimiter info	op
enchantmentlimiter.reload	Allows /enchantmentlimiter reload	op
enchantmentlimiter.add	Allows adding enchantment limits	op
enchantmentlimiter.edit	Allows editing enchantment limits	op
enchantmentlimiter.remove	Allows removing enchantment limits	op
enchantmentlimiter.bypass	Bypasses all enchantment limits	false
enchantmentlimiter.update.notify	Allows receiving update notifications	op

---

Why Use EnchantmentLimiter?

Many servers want to keep enchantments balanced without disabling enchanting completely.

Common examples include:

• Preventing overpowered PvP enchantment levels
• Limiting Protection stacking
• Reducing Sharpness damage scaling
• Keeping tools useful without making them too strong
• Balancing custom survival or PvP progression

EnchantmentLimiter provides a clean way to control enchantment power while keeping vanilla enchanting mechanics available.

---

Compatibility

• Minecraft 1.21+
• Spigot / Paper
• Lightweight with minimal performance impact

---

Example Use Cases

Common enchantments servers limit:

sharpness
protection
efficiency
unbreaking
power
punch
fire_aspect
aqua_affinity
fortune
looting
mending

---

Configuration Philosophy

EnchantmentLimiter is designed to be:

• Simple
• Readable
• Server-friendly

You decide which enchantments are limited and what maximum level each enchantment may reach.

---

Support

If you encounter issues or have feature requests, feel free to open a ticket in the Discord server.

Enjoy a balanced and controlled enchanting system for your server.