EnchantingLimiter

EnchantmentLimiter

limit the maximum level of specific enchantments 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 Efficiency, Efficiency, Efficiency, or any other enchantment.

The plugin is designed to be server-friendly, server-friendly, 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 customizable feedback message - the player will receive a customizable feedback message

Example use cases:

- Limit Unbreaking to 2 - Limit Unbreaking to 2 - Limit Unbreaking to 2 - 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:

```text enchantmentlimiter.bypass ```

By default, this permission is not granted automatically.

---

Fully Configurable

The plugin uses simple enchantment names and JSON configuration.

Example config:

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

You can use simple names like:

```text 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:

```text plugins/EnchantmentLimiter/

config.json

translations/ messages.json ```

Example feedback message:

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

Example in-game message:

```text Sharpness has been lowered from 5 to 3! ```

---

Hot Reload Support

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

```text /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:

```text /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:

```text sharpness protection efficiency unbreaking power punch fire_aspect aqua_affinity fortune looting mending ```

---

Configuration Philosophy

EnchantmentLimiter is designed to be:

- Server-friendly - Server-friendly - Server-friendly

You decide what maximum level 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.