MineableGems - 自定义矿物掉落

MineableGems 是一款允许你为每个 Minecraft 方块创建高度自定义掉落物的插件。它提供了大量条件选项，如概率、生物群系过滤等，并包含自动拾取、时运附魔支持、自定义名称与描述、附魔、物品标签、控制台命令等诸多功能。

💡核心功能

• 高度自定义掉落：为任何方块设置自定义掉落物。
• 物品定制：设置自定义名称、描述、附魔、物品标签、自定义模型数据等。
• 条件控制：通过概率、生物群系、高度、世界、区域、权限、所需工具等多种条件精确控制掉落。
• 兼容性：原生支持 Oraxen、MMOItems 和 HeadDatabase 的自定义物品。
• 自动化：启用“自动拾取”可将物品直接放入玩家背包。
• 原版控制：可完全控制方块的原版掉落物是否保留。

🎮命令与权限

命令

• /mineablegems reload 或 /mg

- 重载插件配置文件。

- **所需权限**：`mineablegems.reload`

权限

• mineablegems.reload：允许使用重载命令。
• mineablegems.notify：允许玩家在加入服务器时接收插件更新通知。

✨配置选项详解

配置节区分大小写。以下是创建自定义掉落时可用的所有选项。

基础设置

• Material: <material_id>

- 自定义掉落物的材料（例如：`IRON_INGOT`）。

- **Oraxen 物品**：格式为 `Oraxen:物品ID` (v1.4+)

- **MMOItems 物品**：格式为 `MMOItem:类型ID;物品ID` (v1.5+)

- **HeadDatabase 头颅**：格式为 `HeadDatabase:头颅ID` 或 `hdb:头颅ID` (v1.7+)

物品自定义

• Name: <name>

- 物品的显示名称，支持颜色代码和格式。

• Lore: <list..>

- 物品的描述文本列表，支持颜色代码和格式。

• Enchantments: <list..>

- 为物品添加附魔。格式为 `附魔ID:等级`（例如：`DURABILITY:3` 即耐久 III）。

- 附魔ID列表：

- 新版 Minecraft: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html

- 旧版 Minecraft: https://helpch.at/docs/1.8.8/index.html?org/bukkit/enchantments/Enchantment.html

• Unbreakable: <true/false>

- 设为 `true` 可使物品无法损坏（仅对具有耐久度的物品有效）。(v1.3+)

• Hide-Enchantments: <true/false>

- 设为 `true` 可隐藏附魔光效，常用于创建发光物品。(v1.1+)

• Hide-Unbreakable: <true/false>

- 设为 `true` 可隐藏“无法损坏”的标签。(v1.3+)

• Hide-Attributes: <true/false>

- 设为 `true` 可隐藏属性修饰符（仅对武器、盔甲和工具有效）。(v1.3+)

• Custom-Model-Data: <num>

- 设置物品的自定义模型数据（此功能于 Minecraft 1.14 添加）。(v1.8+)

掉落条件

• Chance: <0-100>

- 获得自定义掉落物的概率（百分比）。

• Find-In: <everywhere/underground/height/heightLow-heightMax>

- 决定在何处可找到掉落物。选项：`Everywhere`（任意位置）、`Underground`（地下，Y<50）、具体高度值或高度范围（如 `20-100`）。

• Biome-Filter: <list..>

- 允许掉落物出现的生物群系列表。

• Filter-as-Blacklist: <true/false>

- 设为 `true` 时，上述生物群系列表将变为黑名单（即在这些群系中不掉落）。

• Required-Items: <list..>

- 玩家必须使用列表中的工具（材料）挖掘方块才能触发自定义掉落（例如：`DIAMOND_PICKAXE`）。(v1.6+)

• Enabled-Worlds: <list..>

- 自定义掉落物生效的世界列表。(v1.6+)

• Disabled-Worlds: `<list..>**

- 自定义掉落物**不**生效的世界列表。(v1.6+)

• Enabled-Regions: <list..>

- 自定义掉落物生效的 WorldGuard 区域列表。(v1.6+)

• Disabled-Regions: `<list..>**

- 自定义掉落物**不**生效的 WorldGuard 区域列表。(v1.6+)

• Required-Pickaxe-Power: <num>

- 获得自定义掉落物所需的镐子挖掘能力（此选项用于 MMOItems 兼容性）。(v1.7+)

• Required-Permission: <string>

- 玩家获得此自定义掉落物所需的权限。(v1.8+)

其他自定义项

• Console-Commands: <list..>

- 当玩家获得自定义掉落物时，在控制台执行的命令列表。可使用 `%player%` 代表玩家名。(v1.1+)

• Player-Commands: `<list..>**

- 当玩家获得自定义掉落物时，以该玩家身份执行的命令列表。(v1.5+)

• Experience: <num/min-max>

- 随自定义掉落物一起掉落的经验值。可设为固定值或随机范围（如 `2-30`）。(v1.2+)

• Fortune-Enchantment: <true/false>

- 设为 `false` 时，时运附魔将不会影响此自定义掉落物的数量。

• Prevent-Drops-If-Placed: <true/false>

- 设为 `true` 时，若被挖掘的方块是由玩家放置的，则不会掉落自定义物品。

• Auto-Inventory: <true/false>

- 设为 `true` 时，自定义掉落物将直接进入玩家背包（若背包已满则会正常掉落）。

• Vanilla-Drops: <true/half/false>

- 控制方块的原版掉落物。有三个选项：

- `true` 或 `All`：保留原版掉落物（不设置此选项时默认行为）。

- `Half`：仅当其他条件（概率、生物群系、高度等）**不满足**时，才掉落原版物品。

- `false` 或 `Disable`：完全禁用方块的原版掉落物。

🔧如何配置

单个方块的多重掉落

要为单个方块配置多个不同的掉落物，请使用数字小节（从 1 开始）来编写配置。

**示例配置 (YAML)**

GOLD_ORE:
  1:
    Material: GOLD_ORE
    Chance: 100.0
    Experience: 1-6
    Find-In: Everywhere
    Vanilla-Drops: false
    Auto-Inventory: false
  2:
    Material: STONE
    Chance: 20.0
    Experience: 1-3
    Find-In: Everywhere
    Vanilla-Drops: true
    Auto-Inventory: false
  3:
    Material: GOLD_INGOT
    Chance: 7.5
    Experience: 5-15
    Find-In: Everywhere
    Vanilla-Drops: half
    Auto-Inventory: false

配置示例摘要

• 基础掉落（红石矿石掉落自定义“红宝石”）：设置名称、描述、概率、地下限定、生物群系白名单、隐藏附魔（发光效果）、半保留原版掉落。
• 无名称/描述的简单掉落（浮冰掉落冰）：设置概率、特定海洋生物群系白名单、禁用时运、保留原版掉落（作为丝触镐的额外奖励）。
• 带附魔和命令的掉落（石头掉落铁镐）：设置极低概率、地下限定、附魔列表、控制台提示命令。
• 仅经验掉落（铁矿石）：不改变掉落物本身，仅为挖掘添加随机经验奖励。
• Oraxen 物品掉落 (v1.4+)：材料格式为 Oraxen:物品ID。
• MMOItems 物品掉落 (v1.5+)：材料格式为 MMOItem:类型ID;物品ID。
• HeadDatabase 头颅掉落 (v1.7+)：材料格式为 hdb:头颅ID 或 HeadDatabase:头颅ID。

❓支持与反馈

• 如果你有任何功能请求或想法，欢迎联系作者。
• 如需帮助、支持或发现任何漏洞，请在 Spigot 站内私信或通过 Discord 联系作者以获取快速支持。
• 作者 Discord: Mohamad82#1474
• 西班牙语教程由 Ajneb97 提供。

如果你喜欢这个插件，请考虑留下五星评价以支持开发者！