BetterBowTrails - GUI - Shop - Customizable - BetterBowTrails - 自定义GUI商店与粒子箭尾

BetterBowTrails 是一款功能强大的粒子特效插件，允许玩家为射出的箭矢自定义拖尾效果，可使用任何方块或粒子，并配有高度可自定义的GUI菜单和商店系统。

💡重要须知

• 本插件已在我的服务器 mc.RonanCraft.net 上线！输入 /cosmetica 即可体验。
• 不支持 Minecraft 1.7 和 1.8 版本，因为插件核心方法 spawnParticle 从 1.9 版本才开始实现。

支持与统计

• 需要帮助或支持？请点击此处加入我们的 Discord 服务器！

- Discord 邀请链接：http://discord.gg/8Kt4wKm

- 或使用代码：`8Kt4wKm`

• 本插件使用 bStats 收集匿名统计数据（如服务器数量、核心数、在线玩家等）。你可以在 bStats 配置文件中选择退出，但请勿禁用，因为这能激励我发布更多更新！

✨核心特性

• 可将任何方块或粒子设置为箭矢的飞行轨迹。
• 无需任何外部 API 即可运行，所有功能开箱即用。
• 拥有完全可自定义的 GUI 菜单，支持分页（当物品超过45个时）。
• 支持添加、移除或更改任何粒子效果，包括所有 block_break 粒子。
• 内置快速商店系统，支持经济挂钩（Vault）和玩家数据保存，无需外部权限系统即可运行。
• 全新的更新检查器，当有新版本可用时会发送美观的提示消息。

🔧安装与使用

安装步骤

• 下载 BetterBowTrails.jar。
• 安装下方列出的任何软依赖（SoftDependencies），以确保首次安装顺利。
• 将所有文件放入服务器的 /plugins 文件夹。
• 重载或重启服务器，配置后执行 /arrow reload 即可。

命令列表

命令别名：arrowtrails 和 bowtrails

• /arrow - 显示菜单文件中列出的所有箭矢轨迹选项。
• /arrow set <blockID/预设名称> [粒子名称] - 将有效方块/粒子或菜单文件中的预设设置为你的轨迹。
• /arrow type - 切换粒子模式（飞行中显示 或 直到箭矢消失）。
• /arrow amount <+/-> - 每游戏刻增加或减少一个粒子（数量受配置文件限制）。
• /arrow remove - 移除当前的粒子轨迹。
• /arrow reload - 重载插件配置。
• /arrow help - 显示所有命令帮助。

🎮依赖项

软依赖（可选）

• PlaceholderAPI - 用于为其他插件提供自定义占位符，或用于 CustomGUI、AnimatedMenu 等自定义菜单。
• Vault - 仅在使用插件的经济系统时需要，非插件运行必需。

PlaceholderAPI 占位符

（需要已安装 PlaceholderAPI）

• %betterbowtrails_amount% - 返回玩家当前每游戏刻的粒子数量。
• %betterbowtrails_type% - 返回玩家当前的轨迹类型（"Flight" 或 "Despawn"）。
• %betterbowtrails_particle% - 返回玩家当前使用的粒子。

⭐权限节点

以下是插件的权限结构概览

• betterbowtrails.* - 包含所有子权限。
• betterbowtrails.use - 使用插件的基础权限（默认：true）。
• betterbowtrails.use.menu - 使用菜单的权限（默认：op）。
• betterbowtrails.set - 设置任何粒子的权限（默认：op）。
• betterbowtrails.amount - 更改每刻粒子数量的权限（默认：op）。
• betterbowtrails.type - 切换粒子类型的权限（默认：op）。
• betterbowtrails.remove - 移除粒子的权限（默认：op）。
• betterbowtrails.explosion - 切换爆炸效果的权限（默认：op）。
• betterbowtrails.donator - 允许使用更多带粒子箭矢的权限（在配置中定义）（默认：op）。
• betterbowtrails.reload - 重载插件的权限（默认：op）。
• betterbowtrails.updater - 接收新版本更新消息的权限（默认：op）。
• betterbowtrails.all.menu - 包含所有菜单相关子权限。

🔧配置文件详解

主要配置文件为 config.yml，以下为关键设置：

Settings 部分

• UseGUI: true - 设为 false 将完全禁用经济系统和菜单文件，仅使用命令。
• TickDelay: 1 - 粒子之间的延迟刻数（1-20），1为最流畅。
• DisabledWorlds - 在此列表中的世界将禁用插件功能。
• MaxGlobalTrails: 1028 - 服务器全局最大带轨迹箭矢数量，-1 为禁用。

Player 与 Donator 部分

• Player.MaxTrails - 每位玩家最大带轨迹箭矢数。
• Donator.MaxTrails - 拥有 betterbowtrails.donator 权限的玩家的最大箭矢数。

Messages 部分

所有消息前缀、设置成功、权限不足等提示信息均可在此自定义。

Defaults 部分

• ParticleTrail - 所有玩家的默认粒子轨迹（设为 null 则无默认）。
• tillDespawn - 默认轨迹类型（false 为仅飞行中，true 为持续至箭矢消失）。
• ParticlesPerTick - 默认每刻粒子数（推荐5）。
• Explosion - 箭矢击中地面时是否播放爆炸效果（仅飞行模式有效）。

Economy 部分

• 需要 Vault 才能启用经济功能。
• 可设置默认物品价格、购买确认GUI等。

🔧菜单文件详解

菜单文件 menu.yml 用于配置GUI外观和可用的轨迹选项。

Settings.Menu 部分

• 可设置菜单标题、大小、分页按钮位置等。
• 可为有权限和无权限的玩家设置不同的物品和描述（Lore）。

Menu 部分

此处定义所有可选的轨迹。每个条目需要

• Name - 显示名称。
• Item - 在菜单中显示的物品。
• ParticleID - 实际使用的粒子ID（可以是方块ID或粒子名称）。
• Permission - （可选）使用该轨迹所需的权限。
• Price - （可选）购买价格。

重要提示：如果将 ParticleID 设置为没有破碎方块实体（breaking tile entity）的物品，其粒子纹理将默认为破碎的纹理。

❓常见问题与声明

• 你可以分发此插件，但下载链接必须指向本页面。
• 禁止复制、重命名或反编译此代码并声称是自己的作品。
• 如果你喜欢这个插件，请留下五星评价！
• 请在讨论区报告错误或提出改进建议。
• 欢迎为项目做出贡献或自行修改。

感谢支持辛勤工作的开发者！