MeowsEnchants

中文

新特性

• 新增 /enchants 附魔查询 GUI，支持物品筛选、查询槽 Shift 快速放入/取回。
• 为全部内置附魔配置新增 description 字段，支持 Bukkit 颜色代码和 MiniMessage。
• velocity 动作新增 onGround 配置，默认启用，限制玩家需在地面或接近支撑方块时执行。
• 击退效果根据目标的击退抗性线性减免最终动量，击退抗性 0-1 对应 0%-50% 减免。
• 完善村民附魔书交易：支持按配置生成自定义附魔交易，并处理不允许的自定义附魔书交易。

Bug 修复

• 修复右键触发器对副手事件、方块交互和保护插件取消状态判断不准确的问题，提升闪现、跃击等附魔的触发稳定性。
• 修复'multishot'无法可靠响应弩射击、额外箭矢缺失原箭属性的问题。
• 修复传送安全落点检查，避免落入不可站立方块或头部空间不足的位置。
• 触发器统一跳过已取消事件，避免受保护区域中附魔仍执行伤害、吸血、偏转或反伤效果。
• 修复 PlugmanX 热重载后遗留查询 GUI 无法交互、查询物品可能遗失的问题。

代码优化

• 抽取统一的附魔配置加载器，供 bootstrap 与插件启用阶段共用，确保热重载后重新恢复附魔配置和特效数据。
• 查询 GUI 使用 Folia 实体调度器刷新界面，并按玩家所属区域安全清理遗留容器。
• 插件禁用时释放 GUI、静态配置表及相关引用，降低热重载时的类加载器泄漏风险。
• PlaceholderAPI 改为运行时软连接，减少可选依赖造成的类加载器持有问题。

English

New Features

• Added the /enchants browser GUI with item filtering and Shift quick-move support for the query slot.
• Added the description field to all bundled enchantment configs, supports Bukkit colour codes and MiniMessage.
• Added the onGround option to the velocity action, enabled by default; execution requires the player to be on or near supporting ground.
• Shockwave now linearly reduces final impulse based on target knockback resistance: 0-1 resistance produces 0%-50% reduction.
• Improved villager enchanted-book trades with configurable custom enchantments and invalid custom-trade handling.

Bug Fixes

• Fixed unreliable right-click trigger detection caused by off-hand events, block interactions, and protection-plugin cancellation.
• Fixed teleport safe-landing checks to prevent destinations without standable ground or sufficient headroom.
• Trigger listeners now skip cancelled events, preventing damage, lifesteal, deflection, and reflection effects in protected areas.
• Fixed stale browser inventories and possible query-item loss after PlugmanX hot reloads.

Code Optimizations

• Extracted a shared enchantment configuration loader for bootstrap and enable phases, restoring config and effect data after hot reloads.
• Uses Folia entity schedulers for GUI refreshes and safely cleans stale inventories on each player's owning region.
• Releases GUI and static configuration references during disable to reduce class-loader retention during hot reloads.
• Switched PlaceholderAPI to a runtime soft hook to avoid retaining an optional plugin class loader.