CustomDrops [PENDING RECODE] - CustomDrops - 自定义生物掉落

CustomDrops 是一款功能强大的 Minecraft 插件，它允许服务器管理员完全自定义生物死亡和方块被破坏时的掉落物。通过详细的配置文件，你可以为每种生物或方块设置特定的物品、经验值、执行命令等，并支持附魔、自定义头颅、概率掉落等高级功能，极大地丰富了游戏的经济系统和玩法。

💡核心功能

• 完全自定义掉落：为任何生物或方块设置独特的掉落物品、数量和概率。
• 经验控制：为每种生物或方块自定义死亡时给予的经验值。
• 命令执行：当触发掉落时，可执行自定义命令（如广播消息、给予物品）。
• 高级物品支持：掉落物可包含自定义名称、描述（Lore）、附魔、不可破坏（Unbreakable）属性以及生物头颅。
• 概率与随机：每个掉落项都有独立的触发概率和随机数量范围。
• 原生掉落控制：可保留或禁用生物/方块原有的自然掉落物。
• 工具影响：支持“抢夺”附魔对生物掉落数量的加成，以及“时运”附魔对方块掉落数量的加成。
• 内置编辑器：提供图形化界面（GUI），方便管理员查看和编辑配置。

🎮配置文件详解

插件通过四个主要的 YAML 文件进行配置：config.yml, mobs.yml, blocks.yml, editor.yml。

config.yml - 主配置与全局设置

此文件包含插件的全局设置和默认值。

• AdditionalDisplayLore: 在 GUI 中为掉落项显示的额外信息行。
• CommandDisplay: 配置命令掉落项在 GUI 中的显示方式。
• Mobs 部分:

- `Looting`: 控制“抢夺”附魔的效果。

- `applyToDrops`: 是否启用抢夺加成。

- `increasePerLevel`: 每级抢夺增加的额外掉落次数。

- `All`: 应用于所有生物的全局默认掉落设置（当该生物没有独立配置时生效）。

• Blocks 部分:

- `Fortune`: 控制“时运”附魔的效果。

- `applyToDrops`: 是否启用时运加成。

- `increasePerLevel`: 每级时运增加的额外掉落次数。

- `All`: 应用于所有方块的全局默认掉落设置。

mobs.yml - 生物掉落配置

在此文件中为特定生物设置自定义掉落。配置基于 Spigot 的 EntityType。

**配置结构示例**

生物类型（如 COW）:
  NaturalDrops: true/false  # 是否保留原版掉落
  EXP: 10                   # 死亡时掉落的经验值
  '1':                      # 第一个自定义掉落项
    type: 物品类型（如 COOKED_BEEF）
    amount:
      min: 1
      max: 3
    chance: 100.0           # 掉落概率（百分比）
    name: '&e自定义名称'    # 可选，物品显示名
    lore:                   # 可选，物品描述
      - '&7第一行描述'
    enchants:               # 可选，附魔列表
      - 附魔类型: 等级
    commands:               # 可选，命令列表（替代物品掉落）
      - '命令内容'
    mob: 生物类型           # 可选，当type为SKULL_ITEM时指定头颅种类
    unbreakable: true       # 可选，物品是否不可破坏

blocks.yml - 方块掉落配置

在此文件中为特定方块设置自定义掉落。配置基于 Spigot 的 Material。

**配置结构示例**

方块类型（如 STONE）:
  NaturalDrops: true/false
  EXP: 150
  '1':
    type: 物品类型（如 STONE_BRICKS）
    # ... 其他参数与生物掉落配置相同

editor.yml - GUI 编辑器配置

此文件控制内置图形化编辑器的界面布局、按钮和显示，方便管理员在游戏内管理掉落配置。

🔧配置指南与示例

如何设置一个简单的掉落？

以让石头掉落 1-3 个石砖为例，在 blocks.yml 中配置：

STONE:
  NaturalDrops: false  # 禁用原版圆石掉落
  EXP: 0
  '1':
    type: STONE_BRICKS
    amount:
      min: 1
      max: 3
    chance: 100.0

如何设置概率掉落和命令？

以僵尸有 5% 概率触发命令为例，在 mobs.yml 中配置：

ZOMBIE:
  EXP: 10
  NaturalDrops: true
  '1':
    chance: 5.0
    amount:
      min: 1
      max: 1
    commands:
      - 'broadcast {p} 幸运地从一个僵尸获得了钻石剑！'
      - 'give {p} diamond_sword 1'

{p} 是占位符，会自动替换为触发事件的玩家名。

如何添加附魔和自定义物品？

以钻石镐为例

DIAMOND_ORE:
  '1':
    type: DIAMOND_PICKAXE
    name: '&e&l传说镐'
    lore:
      - '&7从钻石矿中稀有地发现'
    enchants:
      - 'Efficiency:5'
      - 'Unbreaking:3'
    amount:
      min: 1
      max: 1
    chance: 1.0

如何设置生物头颅？

GOLD_ORE:
  '1':
    type: SKULL_ITEM
    mob: BLAZE        # 指定为烈焰人头颅
    amount:
      min: 1
      max: 1
    chance: 10.0

✨重要提示与技巧

• 优先级：在 mobs.yml 或 blocks.yml 中对特定生物/方块的配置，优先级高于 config.yml 中的 All 全局设置。
• 物品类型格式：可以使用物品的英文名（如 DIAMOND）、字符串英文名（如 'DIAMOND'）或数字ID（如 264）。避免使用 'DYE:13' 这类旧版数据值格式。
• 数量与概率：

- `min` 和 `max` 定义了随机掉落的数量范围。

- 将 `min` 设为 `0`，即可实现“有概率不掉落任何物品”的效果。

- `chance` 是触发该掉落项的概率（百分比）。

• 抢夺与时运：在 config.yml 中启用 Looting 和 Fortune 后，玩家使用对应附魔的工具会按配置增加掉落尝试次数。
• 命令执行：当掉落项是 commands 时，如果 amount 是随机范围（如 1-3），则命令会执行随机到的次数。
• 重载配置：在游戏中修改配置文件后，使用 /customdrops reload 命令重载插件以使更改生效。
• 查找材料名：

- 生物类型列表：https://goo.gl/dzwI5Q

- 方块材料列表：https://goo.gl/7PiB2F

- 附魔类型列表：https://goo.gl/wmJmbP

通过灵活运用 CustomDrops，你可以为服务器创造独一无二的资源获取方式、任务系统和惊喜事件。