AsyncEnchantLimiter | 高性能附魔限制器
专为 Folia 和现代 Paper 服务器打造——彻底告别因过度附魔物品导致的卡顿。

AsyncEnchantLimiter 是一款强大的插件,可防止玩家使用超过定义限制的附魔物品。它从底层开始为速度而构建,专门针对 Folia 和高性能 Paper 环境设计,在这些环境中,传统的限制器通常会导致线程争用或 TPS 下降。

技术特性
直观的管理界面
直接在游戏内管理所有附魔限制。分页式 GUI 确保更改能即时同步到整个服务器。

简化的通知机制
不再刷屏聊天。当物品被降级时,玩家只会收到一条简洁的通知,让他们在了解执行结果的同时,不会让聊天窗口变得杂乱无章。

核心优势
- 原生 Folia 支持:完全兼容 Folia 的区域调度器,确保操作线程安全。
- 异步处理:将繁重的工作(如文件 I/O 和库存扫描)从主线程卸载,以维持 20.0 TPS。
- 全方位执行监控:监控持有、点击、装备和交易等交互事件中的物品。
- 村民交易修正:生成时自动扫描并修复村民交易中非法的附魔等级。
- 现代美学风格:采用清新的粉色与灰色主题,搭配自定义的小型大写字母排版,呈现高端视觉效果。
文档
控制与实用功能
- 自定义最大等级:为每种附魔定义特定的上限(例如:锋利 V,保护 IV)。
- 铁砧智能拦截:在源头阻止非法的组合附魔。
- 全局战利品扫描:自动验证来自钓鱼、怪物掉落和世界宝箱中的物品。
- 绕过权限:授予特定组超越限制的能力,用于测试或特殊角色。
命令注册表
| 命令 |
别名 |
描述 |
权限 |
/enchantlimiter |
/el |
打开主菜单。 |
enchantlimiter.admin |
/el gui |
|
打开限制编辑器。 |
enchantlimiter.admin |
/el reload |
|
重新加载所有配置。 |
enchantlimiter.admin |
快速入门
将 JAR 文件放入 plugins 文件夹并重启服务器。配置设计注重可读性,便于快速调整:
settings:
enforce-on-hold: true # 检查玩家手持的物品
fix-villager-trades: true # 自动修复损坏的村民交易
notify-player: true # 在物品被修复时告知玩家
silent-mode: false # 设置为 true 可在不发送任何消息的情况下修复物品
limits:
sharpness: 5
efficiency: 5
protection: 4
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧