EnchantingLimiter

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:

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

Alias:

/elim

Permissions

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.