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

• 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