原创 娱乐 WarZFeet —— 超轻量脚印粒子特效插件｜全版本兼容｜原生支持 Folia｜高性能移动检测【1.8 - 1.21+】 1.2.1

• 修复 particles.amount、particles.offset、particles.speed 在游戏内不生效的问题。
• 修复部分旧版本服务端的粒子处理器识别逻辑，提升 1.12.2 Paper 兼容性。
• 修复 /warzfeet reload 后粒子相关配置未同步刷新的问题。
• 修复 min-move-dist 未实际参与触发判断的问题，移动触发灵敏度现已按配置生效。

[MD] ### 📦 更新内容总结 1. ✨ 新增：特效数量限制 (Max Effects Limit) - 在 config.yml 中新增了 max-effects 配置项，默认值为 2 。 - 现在可以限制玩家同时开启的特效数量。当玩家尝试开启超过限制数量的特效时，会收到提示信息并阻止开启。 - 移除旧版 only-one-effect 配置，由更灵活的数量限制替代。 2. 🧩 新增：PlaceholderAPI 变量支持 - 现在可以在菜单（如 DeluxeMenus）、计分板或聊天栏中使用变量显示特效状态。 - 可用变量 ： - %warzfeet_status_<effect>% ：显示指定特效的状态（如 已开启 / 已关闭 ）。例如 %warzfeet_status_fire% 。 - %warzfeet_active_count% ：显示玩家当前开启的特效总数。 - %warzfeet_limit% ：显示服务器允许的最大特效数量。 3. 📝 配置文件更新 - config.yml ：新增 max-effects 选项。 - messages.yml ： - 新增 max-effects-reached ：达到数量限制时的提示信息。 - 新增 status-enabled / status-disabled ：用于变量显示的文本内容。 [/MD]

修改内容：
1. 配置文件 ( config.yml )

- 新增了 only-one-effect 选项。
- 默认为 false （保持原有行为）。
- 如果设置为 true ，当玩家开启一个新的特效时，会自动关闭该玩家当前已开启的所有其他特效。
2. 命令处理器 ( FeetCommand.java )

- 在 toggleEffect 方法中添加了逻辑判断。
- 在开启新特效前，会检查配置文件中的 only-one-effect 设置。
- 如果开启了互斥功能，会先调用 disableAll(target) 清除该玩家的所有特效，然后再开启新选定的特效。

报错信息 java.lang.IllegalArgumentException: missing required data class java.lang.Float 发生在 playPearl 方法中，调用 Particle.DRAGON_BREATH 时。在较新版本的 Minecraft/Paper (1.20+) 中，某些粒子（如 DRAGON_BREATH 或 REDSTONE ）在通过 spawnParticle 生成时，可能需要特定的数据参数（例如颜色或大小数据），而代码中未提供，导致了参数缺失的异常。

修复措施：

1. 修改 Pearl 特效 ：将 Particle.DRAGON_BREATH 替换为 Particle.END_ROD 。 END_ROD 也是一种白色/发光的粒子，非常符合“末影/珍珠”的主题，且它不需要额外的数据参数，能够安全地在所有版本中生成。
2. 优化 Redstone 特效 ：检查了 playRedstone 方法，虽然之前使用了 VILLAGER_ANGRY 作为替代，为了保险起见，确认了其不需要额外数据，保持了该安全实现。

修复：权限默认值问题
问题描述 ：普通玩家默认拥有部分脚印特效（如爱心、音乐等）的权限。 原因分析 ：原 plugin.yml 文件中仅定义了 fire , smoke , magic , pearl 四种特效的权限。代码中虽然检查了其他特效的权限（如 warzfeet.heart ），但由于这些权限节点未在 plugin.yml 中明确注册并声明默认值，导致权限系统（取决于服务端实现）可能将其视为开放权限。

具体变更内容 1. 配置文件更新 ( plugin.yml )
补全了所有遗漏的特效权限节点，并将默认值统一设置为 op （仅管理员可用）。

新增权限节点：

- warzfeet.heart (爱心特效)
- warzfeet.music (音乐特效)
- warzfeet.cloud (云朵特效)
- warzfeet.redstone (红石特效)
- warzfeet.snow (雪花特效)
新增管理权限节点 (用于给他人开关特效)：

- warzfeet.heart.other
- warzfeet.music.other
- warzfeet.cloud.other
- warzfeet.redstone.other
- warzfeet.snow.other