![CustomDrops | 自定义方块掉落，让你可以自定义方块的掉落物 | [1.17.X ~ 26.1.X]](/data/resource_icons/17/17052.jpg?1783164603){kind=icon}
- 版权类型
- 原创
- 插件中文名称
- 自定义方块掉落
- 插件英文名称
- CustomDrops
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
简介:
本插件可以通过高度自定义的配置，实现设置某种具体方块的掉落物的功能。
本插件在Github上开源: 点击查看
命令 / 权限
/customdrops reload 重载插件 --- 需要权限customdrops.reload
customdrops.update --- 是否能收到插件更新提示
依赖
本插件可以通过高度自定义的配置，实现设置某种具体方块的掉落物的功能。
本插件在Github上开源: 点击查看
功能特性
- 按世界启用 – 可指定哪些世界生效，不影响其他世界。
- 自定义掉落列表– 为不同方块分别配置多种掉落物品，每种物品独立设置：
- 物品类型、基础数量
- 掉落概率（0~1）
- 掉落金币和经验的数量
- 是否受时运附魔影响数量（按原版随机倍率）
- 是否每个掉落物品执行一次命令
- 多命令支持– 每个掉落项可配置多条命令，支持三种执行身份：
- CONSOLE – 由控制台执行（支持 PlaceholderAPI 占位符）
- PLAYER – 由触发玩家执行
- OP – 临时提升为 OP 执行（执行后恢复）
- 覆盖原版掉落 – 可选择是否彻底替换原版掉落物和经验值。
- 调试模式 – 开启后控制台输出详细处理日志，便于排错。
安装
- 下载插件
从本帖处或者在github上的 Releases 下载最新版的 CustomDrops-*.jar。 - 放入服务器
将 jar 文件放入服务器的 plugins/ 目录。 - 重启服务器（或使用 PlugMan 等热加载工具）
插件将自动生成默认配置文件 plugins/CustomDrops/config.yml。 - 修改配置 – 按需编辑配置文件，然后执行 /customdrops reload 使配置生效。
命令 / 权限
/customdrops reload 重载插件 --- 需要权限customdrops.reload
customdrops.update --- 是否能收到插件更新提示
依赖
- Vault以及相应的经济插件（如EssentialsX，CMI）（非必须，但不装无法给掉落物设置掉落的金币）
- PlaceHolderAPI（非必须）
YAML：
# 是否检查插件更新（启动时异步检测，发现有新版本时通知有权限的管理员）
check-update: true
# 是否开启调试模式
# 开启调试模式后，服务器后台将输出详细的运行日志
# 一般情况下建议不要打开，避免日志输出过多
debug: false
# 在哪些世界启用自定义掉落
enabled-worlds:
- world
# 具体方块配置
blocks:
# 方块ID
COAL_ORE:
# 是否覆盖原版的掉落物
override-default: true
# 特殊掉落物详细配置，可配置多个id
drops:
# 掉落物品id
- item: "DIAMOND"
# 掉落物品数量
amount: 1
# 掉落该物品的概率
base-chance: 0.1
# 是否允许时运附魔影响掉落数量
fortune-affects-count: true
# 命令执行次数是否按照掉落物品的数量来执行，如果填false则无论掉多少物品都只执行一次
execute-command-per-item: false
exp: 10 # 基础经验值
money: 5.0 # 基础金币
exp-multiplier: 0.5 # 每级时运增加50%经验
money-multiplier: 0.5 # 每级时运增加50%金币
# 掉落该物品所执行的命令，可以写多个
commands:
# 命令详情，%player%表示玩家id
- command: "say 玩家 %player% 挖到了钻石！"
# 执行者，可填CONSOLE（控制台），PLAYER（玩家），OP（管理）
executor: CONSOLE
- command: "eco give %player% 100"
executor: CONSOLE
- item: "COAL"
amount: 3
base-chance: 1.0
fortune-affects-count: true
execute-command-per-item: true
exp: 30
money: 12.0
exp-multiplier: 0.4
money-multiplier: 0.4
commands:
- command: "give %player% stone 1"
executor: PLAYER
