XenDrops MAJOR UPDATE - CustomDrops 自定义掉落

请提供您需要翻译的 Minecraft 插件文档原文，我将为您转换为清晰、结构化的简体中文版本。

CustomDrops 插件文档

CustomDrops 是一款功能强大的 Minecraft 插件，允许服务器管理员完全自定义生物、方块和玩家的掉落物。通过它，你可以精细地控制掉落物品、经验值、金钱，并设置复杂的触发条件与随机概率，为你的服务器创造独特的经济系统和游戏体验。

💡核心功能

• 完全自定义掉落物：为任何生物、方块或玩家击杀设置独特的掉落列表。
• 灵活的条件系统：基于世界、权限、生物名称、玩家手持物品、天气、区域等多种条件触发掉落。
• 强大的变量支持：在物品名称、描述、命令中使用 PlaceholderAPI 变量，实现动态内容。
• 多类型奖励：支持掉落物品、经验值、金钱（Vault）、执行控制台或玩家命令。
• 精细的概率控制：为每个掉落项设置独立概率，支持全局概率修改器。
• 多层嵌套系统：可以创建“子掉落”列表，当父掉落触发时，再从其子列表中随机选取。
• 简易配置：通过直观的 YAML 文件进行配置，支持配置自动重载。

🎮命令与权限

主要命令

• /customdrops reload - 重载插件配置。
• /customdrops list - 显示所有已配置的掉落组。
• /customdrops info <组名> - 显示特定掉落组的详细信息。
• /customdrops give <玩家> <组名> [数量] - 手动给予玩家某个掉落组的物品。
• /customdrops stats - 查看插件性能统计（如检查次数、触发次数）。

权限节点

• customdrops.use - 使用所有命令的基础权限。
• customdrops.reload - 允许使用 /customdrops reload 命令。
• customdrops.give - 允许使用 /customdrops give 命令。
• customdrops.bypass.* - 绕过特定条件检查的权限（如 customdrops.bypass.world 可绕过世界限制）。

🔧配置指南

配置文件位于 plugins/CustomDrops/drops.yml。一个基本的掉落组结构如下：

zombie_drops: # 掉落组名称
  enabled: true
  entities: # 触发实体
    - ZOMBIE
  conditions: # 触发条件
    world: world
  drops: # 掉落列表
    - type: ITEM
      item: DIAMOND
      amount: 1
      chance: 0.5 # 50% 几率

条件配置详解

conditions 部分支持多种条件，可组合使用：

• world: 限定生效世界。
• permission: 玩家需拥有特定权限。
• entity-name: 实体需匹配特定名称（支持颜色代码）。
• held-item: 玩家主手需持有特定物品。
• weather: 当前天气（CLEAR, RAIN, THUNDER）。
• region: 位于特定 WorldGuard 区域（需要 WorldGuard）。
• gamemode: 玩家游戏模式。
• and, or, not: 逻辑运算符，用于组合复杂条件。

掉落项类型

• ITEM: 掉落物品。可配置材质、数量、名称、附魔等。
• COMMAND: 执行命令（支持控制台命令和玩家命令）。
• EXPERIENCE: 给予经验值。
• MONEY: 给予金钱（需要 Vault 经济支持）。
• GROUP: 引用另一个掉落组，实现嵌套掉落。
• MESSAGE: 向玩家发送消息。
• SOUND: 播放音效。
• PARTICLE: 生成粒子效果。
• POTIONEFFECT: 给予药水效果。
• DROP_GROUP: 触发一个子掉落组列表。

✨变量与占位符

在物品名称、描述、命令、消息中，可以使用丰富的变量：

• 内置变量：如 %player%, %killed%, %world%, %x%, %y%, %z%。
• PlaceholderAPI 变量：如果安装了 PlaceholderAPI，可以使用 %placeholderapi_变量名% 格式。
• 数学运算：支持在变量中进行加减乘除运算，例如 %player_health-5%。

❓常见问题

如何为特定名称的僵尸设置特殊掉落？

在 conditions 中使用 entity-name 条件，并确保实体名称匹配（包括颜色代码）。例如，名为“&4精英僵尸”的实体，条件应写为 entity-name: "§4精英僵尸"。

掉落没有生效，如何排查？

• 确认插件已正确加载，无报错。
• 使用 /customdrops list 确认掉落组已启用。
• 使用 /customdrops info <组名> 检查配置细节。
• 检查玩家/实体是否满足所有配置的条件。
• 查看服务器日志，插件可能会输出调试信息。

如何设置“有 10% 几率掉落一个宝箱，宝箱内再随机开出一件奖品”？

这需要使用 DROP_GROUP 类型。首先创建一个包含各种奖品的掉落组（如 chest_loot），然后设置一个掉落项，类型为 DROP_GROUP，指向 chest_loot，并设置 chance: 0.1。

支持哪些经济插件？

支持所有通过 Vault 接口连接的经济插件，如 EssentialsX、CMI、PlayerPoints 等。确保已安装 Vault 和经济插件。

⭐依赖与兼容性

• 必需依赖：无（核心功能独立运行）。
• 可选依赖：

- **Vault**：用于经济（Money）奖励和部分权限功能。

- **PlaceholderAPI**：用于在物品名、命令中使用丰富的变量。

- **WorldGuard**：用于 `region` 条件。

• 兼容版本：支持 Spigot/Paper 1.13.x 及以上版本。建议使用最新稳定版服务端以获得最佳性能。