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

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