EnchantLimitRemover
A lightweight, configurable Minecraft plugin that lifts vanilla enchantment level caps — while keeping you in full control of who can go how far.
Key Features
- Enchant far beyond vanilla caps, with a hard safety ceiling you set
- Per-rank limits through
elr.level.<n>permissions - Per-item, per-enchantment limits (a netherite sword can allow more than a diamond one)
- Limits enforced everywhere: commands, enchanting table, anvil, item pickup, and on join
- Block specific enchantments server-wide, with a bypass permission
- Optional command cooldowns
- Fully customisable messages
- Tab completion on every argument
- Debug mode for troubleshooting
Commands
All commands require elr.admin. Aliases: /elr, /elre, /enchantlimit
| Command | What it does |
|---|---|
/elrenchant add <enchant> <level> |
Add an enchantment to the held item |
/elrenchant remove <enchant> |
Remove one enchantment |
/elrenchant clear |
Remove every enchantment from the held item |
/elrenchant list |
List all enchantments with your personal cap |
/elrenchant info |
Show the held item's enchantments and your limits |
/elrenchant reload |
Reload the configuration |
Configuration
max-enchant-level: 10 # Baseline cap for everyone
use-permission-levels: true # Let elr.level.<n> raise it per rank
disabled-enchantments: [] # Block enchantments server-wide
show-messages: true # Tell players when a level is adjusted
debug: false # Verbose console logging
security:
absolute-max-level: 1000 # Hard ceiling nothing can exceed
log-activities: true # Log enchants to console
Per-item limits and cooldowns
Give different gear different ceilings:
item-specific-limits:
enabled: true
items:
DIAMOND_SWORD:
sharpness: 10
looting: 5
NETHERITE_SWORD:
sharpness: 15
looting: 8
Rate-limit the command:
cooldowns:
enabled: true
duration: 60 # seconds; elr.bypass.cooldown skips it
Enchanting table behaviour:
enchanting-table:
fix-book-enchanting: true # Books become enchanted books correctly
consume-resources: true # Still charge XP and lapis
Permissions
| Permission | Grants | Default |
|---|---|---|
elr.admin |
All commands | op |
elr.use |
Limit enforcement and enchanting | op |
elr.level.<n> |
Raises your cap to <n> |
false |
elr.bypass.limits |
Ignore all limits, use absolute-max-level |
false |
elr.bypass.disabled |
Use blocked enchantments | op |
elr.bypass.cooldown |
Skip command cooldowns | op |
can be 1–5, 10, 15, 20, 25, 30, 50, 100, 255, 500 or 1000.
Preset permission groups
Ready-made bundles you can grant instead of wiring nodes individually:
| Group | Cap | Extras |
|---|---|---|
elr.user |
5 | — |
elr.helper |
30 | list, info, cooldown bypass |
elr.vip |
20 | list, info |
elr.moderator |
50 | all item commands, cooldown bypass |
Requirements
| Server | Paper (or a Paper fork) |
| Minecraft | 1.21.1 – 26.2 |
| Java | 21 or newer |
Installation
- Download the jar
- Drop it into your server's
pluginsfolder - Restart the server
- Adjust
plugins/EnchantLimitRemover/config.yml, then/elrenchant reload
Support Development
If this plugin is useful to you:
- Follow us on Modrinth
- Rate the plugin
- Share it with other server owners
Need help? Join our Discord
Made with ❤️ for the Minecraft community
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
|
B
1.0
|
10h ago | 1 |
| Requirement | Supported |
|:---|:---|
| Paper | **1.21.1 – 26.2** |
| Java | **21 or newer** |
A single jar covers the whole range — tested end to end on both Paper 1.21.1
and Paper 26.2. No separate downloads, no version-specific builds.
## Fixed
elr.bypass.limitsdid nothing.** The permission was listed in
plugin.yml but never actually checked in code, so granting it had noeffect. It now works.
- Enchantments were stripped while browsing chests.** Limits were enforced
chest. They are now only enforced when an item really enters your own
inventory.
- Permission changes needed a relog.** The permission cache was not cleared
/elrenchant reload, so new levels were ignoreduntil the player reconnected.
- Invalid enchantment names could throw an error.**
/elrenchant add
- [BETA]**:
- ### Warning this plugin are port to minceraft version paper 1.20.1 maybe not stable in this version please do try and report it if you find a bug or something wrong.
1. Player now can't bypass the specific-item-limits config if set true
2. Fix If player have item in inventory that bypass the specific-item-limit
Enjoy ❤️
## 🔥 Critical Bug Fixes
- FIXED:** Config enchantment level limits now work properly across all systems
- FIXED:** Item-specific limits were being ignored in enchanting tables - now fully functional
- FIXED:** Permission level checking was inefficient causing server lag - optimized with caching
- FIXED:** Absolute maximum level security was being bypassed - now properly enforced
- FIXED:** Configuration validation was incomplete - now comprehensive with auto-repair
- FIXED:** Inconsistent limit calculation between commands and enchanting table - now unified
## ✨ Revolutionary Limit System
- Layered Priority System:** Base Config → Permission Level → Item-Specific → Absolute Maximum
- Smart Permission Caching:** Efficient permission checking with automatic cache management
- Unified Calculation Engine:** Same limit logic applied everywhere for consistency
- Security-First Design:** Absolute maximum level prevents dangerous enchantment levels
- Real-Time Validation:** Live config validation with automatic error correction
## 🎯 Enhanced Enchantment Management
- Multi-Layer Limit Control:** Configure limits at global, permission, and item-specific levels
- Bypass System:** Admin permissions to override any restrictions
- Dynamic Level Calculation:** Intelligent max level detection based on player permissions
- Item-Aware Limits:** Different enchantment caps for different items (swords vs armor vs tools)
- Disabled Enchantment Control:** Block specific enchantments with bypass permissions
## 🔧 Advanced Commands System
/elrenchant add <enchant> <level>- Add enchantments with intelligent limit checking/elrenchant remove <enchant>- Remove specific enchantments safely/elrenchant clear- Remove ALL enchantments from items/elrenchant info- View detailed limits and current enchantments/elrenchant list- Browse all enchantments with your personal max levels/elrenchant reload- Hot-reload configuration without restart- Smart Tab Completion:** Context-aware suggestions based on your permissions
## ⚙️ Comprehensive Configuration System
``
yaml
# Base enchantment level (minimum for all players)
max-enchant-level: 10
# Permission-based level system
use-permission-levels: true
# Item-specific enchantment limits
item-specific-limits:
enabled: true
items:
DIAMOND_SWORD:
sharpness: 10
looting: 5
unbreaking: 10
NETHERITE_PICKAXE:
efficiency: 15
fortune: 8
unbreaking: 15
# Security and safety
security:
absolute-max-level: 1000
log-activities: true
prevent-exploits: true
# Enhanced enchanting table behavior
enchanting-table:
fix-book-enchanting: true
consume-resources: true
enhanced-options: true
# Cooldown and economy integration
cooldowns:
enabled: false
duration: 60
economy:
enabled: false
cost-per-level: 100.0
`
## 🔒 Sophisticated Permission System
elr.admin - Complete access to all plugin functionalityelr.use - Basic enchantment table usage without vanilla limitselr.level.X - Tiered max levels (5, 10, 20, 50, 100, 255, 500, 1000)elr.bypass.cooldown - Skip command cooldownselr.bypass.disabled - Use disabled enchantmentselr.bypass.limits - Override all limits (uses absolute-max-level)Permission Groups:** Pre-configured user, vip, moderator roles
## 💡 Intelligent Features
- Dynamic Level Display:** Shows your personal max levels in
/elrenchant listContext-Aware Info:** /elrenchant info displays limits specific to held itemSmart Tab Completion:** Only suggests levels you can actually use Automatic Config Repair:** Fixes invalid configurations on startup Performance Optimization:** Cached permission checks for zero lag
## 🎨 User Experience Enhancements
- Colorful Messages:** Beautiful, consistent formatting with customizable text
- Detailed Feedback:** Clear explanations when limits are reached
- Debug System:** Comprehensive logging for troubleshooting
- Multi-Format Support:** Works with Enchanted Books and regular items
- Activity Logging:** Optional detailed logging for server monitoring
## 🔧 Technical Improvements
- Unified Limit Engine:** Single calculation system used everywhere
- Memory Optimization:** Efficient caching with automatic cleanup
- Error Recovery:** Graceful handling of configuration errors
- Thread Safety:** Concurrent access protection for stability
- Code Modernization:** Clean, maintainable codebase following best practices
## 📊 Advanced Monitoring & Debug
`yaml
# Debug mode for troubleshooting
debug: true
# Activity logging
security:
log-activities: true
# Performance monitoring
performance:
cache-checks: true
async-processing: false
`
- Debug Output Example:**
`
[DEBUG] Base max level from config: 10
[DEBUG] Applied permission level 50, new max: 50
[DEBUG] Applied item-specific limit for DIAMOND_SWORD.sharpness: 15, new max: 15
[DEBUG] Final max level for PlayerName: 15
``## 🎯 Perfect For Server Administrators
- Granular Control:** Configure different limits for different player groups
- Security Focused:** Multiple layers of protection against exploits
- Performance Optimized:** Minimal server impact with intelligent caching
- Easy Management:** Hot-reload configs without server restart
- Comprehensive Logging:** Track all enchantment activities
## 🌟 Quality Assurance Features
- Input Validation:** Prevents invalid enchantments and levels
- Config Verification:** Automatic validation and repair on startup
- Permission Verification:** Validates permission nodes and structure
- Material Validation:** Ensures item-specific configs use valid materials
- Enchantment Validation:** Verifies all enchantment names are legitimate
## 📈 Compatibility & Support
- API Version:** 1.21+ (fully compatible with latest Minecraft)
- Permission Plugins:** LuckPerms, PermissionsEx, GroupManager
- Economy Plugins:** Vault integration ready
- Performance:** Optimized for large servers with hundreds of players
## 🙏 Community & Support
Having issues? Need help with configuration? Join our community for support and share your feedback to help make this plugin even better!
- Experience truly unlimited enchanting with professional-grade limit control!** ✨
## 🔥 Critical Bug Fixes
- FIXED:** Book enchanting bug that created enchanted Books instead of proper Enchanted Books
- FIXED:** Enchanting table now properly converts Books to Enchanted Books with stored enchantments
- FIXED:** Experience and lapis consumption now works correctly when using custom enchantment limits
- FIXED:** Enchantment level bypass issues with permission system
## ✨ New Features
- Permission-Based Max Levels:** Players can have different max enchantment levels based on permissions (
elr.level.X) - Enhanced Command System:** Complete overhaul with new subcommands and better functionality
- Item-Specific Limits:** Configure different max levels for specific items (Diamond Sword, Netherite Pickaxe, etc.)
- Cooldown System:** Prevent command spam with configurable cooldowns
- Economy Integration:** Optional Vault integration for enchantment costs
- Advanced Config Validation:** Automatic config fixing and validation on startup
## 🔧 Enhanced Commands
/elrenchant add <enchant> <level>- Add enchantments to items (supports Enchanted Books!)/elrenchant remove <enchant>- Remove specific enchantments from items/elrenchant clear- Remove ALL enchantments from an item/elrenchant info- Display detailed enchantment information for held item/elrenchant list- View all available enchantments with their max levels/elrenchant reload- Reload plugin configuration without restart- New Aliases:**
/elr,/elre,/enchantlimitfor easier access
## ⚙️ Advanced Configuration
``
yaml
# Permission-based max levels
use-permission-levels: true
max-enchant-level: 10
# Item-specific enchantment limits
item-specific-limits:
enabled: true
items:
DIAMOND_SWORD:
sharpness: 10
looting: 5
# Cooldown system
cooldowns:
enabled: false
duration: 60
# Economy integration
economy:
enabled: false
cost-per-level: 100.0
# Enhanced enchanting table behavior
enchanting-table:
fix-book-enchanting: true
consume-resources: true
enhanced-options: true
`
## 🔒 Enhanced Permissions System
elr.admin - Full access to all plugin featureselr.use - Basic enchantment table usageelr.level.X - Max enchantment level permissions (e.g., elr.level.50)elr.bypass.cooldown - Bypass command cooldownselr.bypass.cost - Bypass economy costselr.bypass.disabled` - Use disabled enchantments## 🎯 Smart Tab Completion
- Dynamic Level Suggestions:** Shows appropriate levels based on player permissions
- Enchantment Filtering:** Hides disabled enchantments from suggestions
- Context-Aware:** Different completions for different commands
- Performance Optimized:** Fast and responsive tab completion
## 💻 Technical Improvements
- Complete Code Refactor:** Cleaner, more maintainable codebase
- Enhanced Error Handling:** Better error messages and graceful failure handling
- Performance Optimizations:** Reduced memory usage and faster processing
- Plugin Stability:** Improved startup/shutdown procedures
- Debug System:** Comprehensive debug logging for troubleshooting
- Config Migration:** Automatic config updates for future versions
## 🌟 Quality of Life Features
- Colored Messages:** Beautiful, consistent message formatting
- Smart Validation:** Prevents invalid enchantments and levels
- Resource Management:** Proper cleanup and memory management
- Multi-Language Ready:** Foundation for future language support
- Extensive Logging:** Detailed activity logging for server administrators
## 🙏 Feedback & Support
Report bugs and suggest features on our Discord server. Your feedback helps make this plugin better!
- Enjoy unlimited enchanting with proper Book support!** ✨
### ✨ New Features
- Added config system for better customization
- Introduced max enchantment level control
- Added disabled enchantments list functionality
- Added debug mode for server administrators
- New message toggle system for cleaner gameplay
- Change name from SuperEnchant -> EnchantLimitRemover
### 🔧 Commands
/elrenchant add <enchant> <level>- Add enchantments to items/elrenchant remove <enchant>- Remove specific enchantments/elrenchant list- View all available enchantments/elrenchant reload- Reload plugin configuration- Added shorter aliases:
/elrand/elre
### ⚙️ Configuration
``
yaml
# Control maximum enchantment level
max-enchant-level: 10
# Disable specific enchantments
disabled-enchantments: []
# Toggle success messages
show-messages: true
# Enable detailed logging
debug: false
`
### 🔒 Permissions
elr.admin - Access to all plugin commandselr.use` - Permission to use unlimited enchantments### 🐛 Bug Fixes
- Fixed enchantment level bypass issues
- Improved command tab completion
- Enhanced error handling for invalid enchantments
### 💻 Technical Updates
- Improved code structure and efficiency
- Added proper config validation
- Enhanced plugin stability
### 📝 Notes
- Configuration file will be generated on first run
- Server restart required after config changes
- Compatible with Paper/Spigot servers
- Backup your config before updating
Remember to report any bugs!