# EnchantmentLimiter<\/p>\n
**EnchantmentLimiter** is a lightweight and configurable Minecraft plugin that allows server owners to **limit the maximum level of specific enchantments**.<\/p>\n
It helps balance gameplay by preventing enchantments from going above configured levels, such as limiting **Sharpness**, **Protection**, **Efficiency**, or any other enchantment.<\/p>\n
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.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Enchantment Level Limits<\/p>\n
Each configured enchantment can have a **maximum allowed level**.<\/p>\n
If a player attempts to receive an enchantment above that level:<\/p>\n
– the enchantment will be **automatically lowered**
\n– the player will receive a **customizable feedback message**<\/p>\n
Example use cases:<\/p>\n
– Limit **Sharpness to 3**
\n– Limit **Protection to 3**
\n– Limit **Efficiency to 4**
\n– Limit **Unbreaking to 2**<\/p>\n
—<\/p>\n
### Enchanting And Anvil Support<\/p>\n
EnchantmentLimiter supports multiple ways players receive enchantments:<\/p>\n
| Source | Description |
\n|——–|————-|
\n| Enchanting table | Lowers enchantments from normal enchanting results |
\n| Anvils | Lowers enchantments created through anvil combining |
\n| Enchanted books | Supports stored enchantments on enchanted books |<\/p>\n
This helps prevent players from bypassing configured enchantment limits through different vanilla mechanics.<\/p>\n
—<\/p>\n
### Bypass Permission<\/p>\n
Specific players or groups can be given a bypass permission.<\/p>\n
Players with this permission will completely bypass enchantment limits:<\/p>\n
“`text
\nenchantmentlimiter.bypass
\n“`<\/p>\n
By default, this permission is **not granted automatically**.<\/p>\n
—<\/p>\n
### Fully Configurable<\/p>\n
The plugin uses simple enchantment names and JSON configuration.<\/p>\n
Example config:<\/p>\n
“`json
\n{
\n “enchantments”: {
\n “sharpness”: 3,
\n “protection”: 3,
\n “efficiency”: 3,
\n “unbreaking”: 3
\n }
\n}
\n“`<\/p>\n
You can use simple names like:<\/p>\n
“`text
\nsharpness
\naqua_affinity
\nfire_aspect
\n“`<\/p>\n
Minecraft namespaced keys such as `minecraft:sharpness` are also still supported.<\/p>\n
—<\/p>\n
### Customizable Messages<\/p>\n
All plugin messages can be edited through the translations file.<\/p>\n
Structure:<\/p>\n
“`text
\nplugins\/EnchantmentLimiter\/<\/p>\n
config.json<\/p>\n
translations\/
\n messages.json
\n“`<\/p>\n
Example feedback message:<\/p>\n
“`json
\n{
\n “enchantment_lowered”: “%prefix%\u00a7f%enchantment% \u00a7ehas been lowered from \u00a7f%old_level%\u00a7e to \u00a7f%level%\u00a7e!”
\n}
\n“`<\/p>\n
Example in-game message:<\/p>\n
“`text
\nSharpness has been lowered from 5 to 3!
\n“`<\/p>\n
—<\/p>\n
### Hot Reload Support<\/p>\n
You can reload the configuration and translation files without restarting the server.<\/p>\n
“`text
\n\/enchantmentlimiter reload
\n“`<\/p>\n
If configuration files are missing, the plugin will **automatically recreate them**.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Alias:<\/p>\n “`text —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Why Use EnchantmentLimiter?<\/p>\n Many servers want to keep enchantments balanced without disabling enchanting completely.<\/p>\n Common examples include:<\/p>\n – Preventing overpowered PvP enchantment levels EnchantmentLimiter provides a clean way to control enchantment power while keeping vanilla enchanting mechanics available.<\/p>\n —<\/p>\n ## Compatibility<\/p>\n – Minecraft **1.21+** —<\/p>\n ## Example Use Cases<\/p>\n Common enchantments servers limit:<\/p>\n “`text —<\/p>\n ## Configuration Philosophy<\/p>\n EnchantmentLimiter is designed to be:<\/p>\n – **Simple** You decide **which enchantments** are limited and **what maximum level** each enchantment may reach.<\/p>\n —<\/p>\n ## Support<\/p>\n If you encounter issues or have feature requests, feel free to open a ticket in the Discord server.<\/p>\n Enjoy a balanced and controlled enchanting system for your server.<\/p>\n","protected":false},"excerpt":{"rendered":" A simple and lightweight EnchantingLimiter plugin!<\/p>\n","protected":false},"featured_media":63354,"template":"","meta":{"_minecraft_slug":"enchantinglimiter","_minecraft_project_id":"yA3iEw5r","_minecraft_author":"nieuwjaar","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":21,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"enchantinglimiter.zip","_minecraft_size_bytes":303323,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:42:32.799662Z","_minecraft_date_created":"2026-05-08T19:33:34.669680Z","_minecraft_date_modified":"2026-05-08T17:47:49.093696Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/enchantinglimiter","_minecraft_icon_attachment_id":63354,"_minecraft_imported_at":"2026-06-03T15:49:11+00:00","_minecraft_import_hash":"f5832b78f7b6378d7bdec7c53e350dc8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-63353","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|——–|————-|
\n| `\/enchantmentlimiter help` | Displays all plugin commands |
\n| `\/enchantmentlimiter list [page]` | Lists configured enchantment limits |
\n| `\/enchantmentlimiter info
\n| `\/enchantmentlimiter add
\n| `\/enchantmentlimiter edit
\n| `\/enchantmentlimiter remove
\n| `\/enchantmentlimiter reload` | Reloads plugin configuration |<\/p>\n
\n\/elim
\n“`<\/p>\n
\n|———–|————-|———|
\n| `enchantmentlimiter.help` | Allows `\/enchantmentlimiter help` | true |
\n| `enchantmentlimiter.list` | Allows `\/enchantmentlimiter list` | op |
\n| `enchantmentlimiter.info` | Allows `\/enchantmentlimiter info` | op |
\n| `enchantmentlimiter.reload` | Allows `\/enchantmentlimiter reload` | op |
\n| `enchantmentlimiter.add` | Allows adding enchantment limits | op |
\n| `enchantmentlimiter.edit` | Allows editing enchantment limits | op |
\n| `enchantmentlimiter.remove` | Allows removing enchantment limits | op |
\n| `enchantmentlimiter.bypass` | Bypasses all enchantment limits | false |
\n| `enchantmentlimiter.update.notify` | Allows receiving update notifications | op |<\/p>\n
\n– Limiting Protection stacking
\n– Reducing Sharpness damage scaling
\n– Keeping tools useful without making them too strong
\n– Balancing custom survival or PvP progression<\/p>\n
\n– Spigot \/ Paper
\n– Lightweight with minimal performance impact<\/p>\n
\nsharpness
\nprotection
\nefficiency
\nunbreaking
\npower
\npunch
\nfire_aspect
\naqua_affinity
\nfortune
\nlooting
\nmending
\n“`<\/p>\n
\n– **Readable**
\n– **Server-friendly**<\/p>\n