转载 闭源 工具 异步附魔限制器 1.0.0

[MD]
# 异步附魔限制器（AsyncEnchantLimiter）

**专为 Folia 与现代 Paper 服务端构建——彻底告别过度附魔导致的卡顿。**


AsyncEnchantLimiter 是一款功能强大的插件，可阻止玩家使用超出预设限制的附魔物品。插件从零开始针对性能进行优化，专门面向 Folia 及高性能 Paper 环境——传统限制器在此类环境中往往会引发线程竞争或 TPS 下跌。


---

## 技术特性

**直观的管理界面**
所有附魔限制均可直接在游戏内管理。分页式 GUI 确保配置变更即时同步至全服。


**简洁的通知机制**
不刷屏。物品被降级时，玩家只会收到一条简洁提示，在了解执行结果的同时不干扰正常游戏体验。


---

## 核心优势

- **原生 Folia 支持**：与 Folia 区域调度器完全兼容，确保所有操作线程安全。
- **异步处理**：文件 I/O、物品栏扫描等耗时操作均从主线程卸载，持续维护 20.0 TPS。
- **全面的执法覆盖**：监控手持、点击、装备和交易等多类物品交互事件。
- **村民交易修正**：村民交易生成时自动扫描并修复非法附魔等级。
- **现代化外观**：采用粉灰配色主题与自定义小型大写字体排版，呈现精致的视觉效果。

---

## 功能文档

**控制与实用功能**

- **自定义最高等级**：为每种附魔单独设定上限（如锋利 5、保护 4）。
- **铁砧智能拦截**：在物品合成阶段即阻断非法附魔组合。
- **全局战利品扫描**：自动验证钓鱼、怪物掉落及世界箱子中的物品。
- **绕过权限**：可授予特定用户组超出限制的权限，用于测试或特殊角色。

**命令列表**

| 命令 | 别名 | 说明 | 权限节点 |
| :--- | :--- | :--- | :--- |
| `/enchantlimiter` | `/el` | 打开主菜单 | `enchantlimiter.admin` |
| `/el gui` | | 打开限制编辑器 | `enchantlimiter.admin` |
| `/el reload` | | 重载所有配置 | `enchantlimiter.admin` |

---

## 快速上手

将 JAR 文件放入 `plugins` 文件夹并重启服务器即可。配置文件结构清晰，便于快速调整：

```yaml
settings:
enforce-on-hold: true # 玩家手持物品时进行检测
fix-villager-trades: true # 自动修复非法村民交易
notify-player: true # 物品被修正时通知玩家
silent-mode: false # 设为 true 可静默修正，不发送任何消息
limits:
sharpness: 5
efficiency: 5
protection: 4
```

---

## 截图



[/MD]