AsyncEnchantLimiter | High-Performance Enchantment Enforcement
Built for Folia & modern Paper servers - No more lag from over-enchanted items.
AsyncEnchantLimiter is a powerful plugin that prevents players from utilizing items with enchantments exceeding defined limits. Engineered from the ground up for speed, it is specifically designed for Folia and high-performance Paper environments where traditional limiters often cause thread contention or TPS drops.
Technical Features
Intuitive Management Interface Manage every enchantment limit directly in-game. The paginated GUI ensures changes stay synchronized across the server instantly.
Streamlined Notifications No chat spam. Players receive a single, clean notification when an item is downgraded, ensuring they understand the enforcement without cluttering their view.
Core Advantages
- Native Folia Support: Fully compatible with Folia's region scheduler, ensuring thread-safe operations.
- Asynchronous Processing: Heavy lifting—such as file I/O and inventory scanning—is offloaded from the main thread to maintain 20.0 TPS.
- Ubiquitous Enforcement: Monitors item interaction across hold, click, equip, and trade events.
- Villager Trade Correction: Automatically scans and fixes illegal enchantment levels in villager trades upon generation.
- Modern Aesthetic: Features a clean pink and gray theme with custom small-caps typography for a premium look.
Documentation
Control & Utility
- Custom Max Levels: Define specific caps for every enchantment (e.g., Sharpness 5, Protection 4).
- Anvil Intelligence: Blocks illegal combinations at the source.
- Global Loot Scanning: Automatically validates items from fishing, mob drops, and world chests.
- Bypass Permissions: Grant specific groups the ability to exceed limits for testing or special roles.
Command Registry
| Command | Alias | Description | Permission |
|---|---|---|---|
/enchantlimiter |
/el |
Open the main menu. | enchantlimiter.admin |
/el gui |
Open the limit editor. | enchantlimiter.admin |
|
/el reload |
Reload all configs. | enchantlimiter.admin |
Getting Started
Drop the JAR into your plugins folder and restart. The configuration is designed for readability and quick adjustments:
settings:
enforce-on-hold: true # Check items as players hold them
fix-villager-trades: true # Auto-fix broken villager trades
notify-player: true # Let players know when an item is fixed
silent-mode: false # Set to true to fix items without any messages
limits:
sharpness: 5
efficiency: 5
protection: 4
