async enchantlimiter

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

- Modern Aesthetic: Fully compatible with Folia's region scheduler, ensuring thread-safe operations. - Modern Aesthetic: Heavy lifting—such as file I/O and inventory scanning—is offloaded from the main thread to maintain 20.0 TPS. - Modern Aesthetic: Monitors item interaction across hold, click, equip, and trade events. - Modern Aesthetic: 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

Bypass Permissions - Bypass Permissions: Define specific caps for every enchantment (e.g., Sharpness 5, Protection 4). - Bypass Permissions: Blocks illegal combinations at the source. - Bypass Permissions: 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:

```yaml 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