![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`，别名 `/cd`。
[MD]| 命令 | 权限 | 说明 | | --- | --- | --- | | `/customdrops help` | `customdrops.use` | 显示帮助 | | `/customdrops reload` | `customdrops.reload` | 重载配置文件 | | `/customdrops list [页码]` | `customdrops.list` | 列出已配置的方块 | | `/customdrops info <方块id>` | `customdrops.info` | 查询某方块的特殊掉落信息，未配置则返回「无」 | | `/customdrops set <方块id> <选项> [参数...]` | `customdrops.set` | 设置某方块的特殊掉落，方块不存在时自动创建 | | `/customdrops target <方块id> <true\|false>` | `customdrops.target` | 启用/禁用某方块的特殊掉落 | | `/customdrops delete <方块id>` | `customdrops.delete` | 删除某方块的特殊掉落配置 | | `/customdrops undo [步数]` | `customdrops.undo` | 撤回前几步命令操作，最多 5 步 | | `/customdrops placeholders` | `customdrops.info` | 查看全部可用变量 | | `/customdrops update` | `customdrops.update` | 手动检查更新 |[/MD]
set命令中的所有选项列表：
[MD]方块级（直接写选项名）： | 选项 | 参数 | 对应配置项 | | --- | --- | --- | | `enabled` | `<true\|false>` | `enabled` | | `override-default` | `<true\|false>` | `override-default` | | `silk-touch-preserve-original` | `<true\|false>` | `silk-touch-preserve-original` | | `add-drop` | `<物品id>` | 在 `drops` 末尾追加一项 | | `remove-drop` | `<序号\|物品id>` | 删除某项 | | `clear-drops` | | 清空全部掉落项 | 掉落项级（`drops.<序号|物品id>.<选项>`，也可简写为 `drop-<序号>-<选项>`，序号从 1 开始）： | 选项 | 参数 | 对应配置项 | | --- | --- | --- | | `item` | `<物品id>` | `item` | | `amount` | `<整数>` | `amount` | | `chance` | `<0~1>` | `base-chance` | | `fortune-affects-count` | `<true\|false>` | `fortune-affects-count` | | `fortune-chance-bonus` | `<数字>` | `fortune-chance-bonus` | | `execute-command-per-item` | `<true\|false>` | `execute-command-per-item` | | `silk-touch-ignore` | `<true\|false>` | `silk-touch-ignore` | | `exp` | `<整数>` | `exp` | | `money` | `<数字>` | `money` | | `exp-multiplier` | `<数字>` | `exp-multiplier` | | `money-multiplier` | `<数字>` | `money-multiplier` | | `permission` | `<权限节点\|none>` | `permission` | | `add-command` | `<命令>` | 追加一条控制台命令 | | `add-command-player` | `<命令>` | 追加一条玩家身份命令 | | `add-command-op` | `<命令>` | 追加一条 OP 身份命令 | | `remove-command` | `<序号>` | 删除第 n 条命令 | | `clear-commands` | | 清空全部命令 |[/MD]
依赖
本插件可以通过高度自定义的配置，实现设置某种具体方块的掉落物的功能。
本插件在Github上开源: 点击查看
功能特性
- 按世界启用 – 可指定哪些世界生效，不影响其他世界。
- 按方块启用/禁用 – 每个方块独立的 `enabled` 开关，可临时停用某个方块的特殊掉落而不必删除配置。
- 自定义掉落列表– 为不同方块分别配置多种掉落物品，每种物品独立设置：
- 物品类型、基础数量
- 掉落概率（0~1）
- 掉落金币和经验的数量
- 是否受时运附魔影响数量（按原版随机倍率）
- 是否每个掉落物品执行一次命令
- 对精准采集附魔的自定义
- 所需权限
- 多命令支持– 每个掉落项可配置多条命令，支持三种执行身份：
- CONSOLE – 由控制台执行（支持 PlaceholderAPI 占位符）
- PLAYER – 由触发玩家执行
- OP – 临时提升为 OP 执行（执行后恢复）
- 覆盖原版掉落 – 可选择是否彻底替换原版掉落物和经验值。
- 调试模式 – 开启后控制台输出详细处理日志，便于排错。
- 撤回 - 使用命令进行的操作均可被撤回，防止失误
安装
- 下载插件
从本帖处或者在github上的 Releases 下载最新版的 CustomDrops-*.jar。 - 放入服务器
将 jar 文件放入服务器的 plugins/ 目录。 - 重启服务器（或使用 PlugMan 等热加载工具）
插件将自动生成默认配置文件 plugins/CustomDrops/config.yml。 - 修改配置 – 按需编辑配置文件，然后执行 /customdrops reload 使配置生效。
命令 / 权限
主命令 `/customdrops`，别名 `/cd`。
[MD]| 命令 | 权限 | 说明 | | --- | --- | --- | | `/customdrops help` | `customdrops.use` | 显示帮助 | | `/customdrops reload` | `customdrops.reload` | 重载配置文件 | | `/customdrops list [页码]` | `customdrops.list` | 列出已配置的方块 | | `/customdrops info <方块id>` | `customdrops.info` | 查询某方块的特殊掉落信息，未配置则返回「无」 | | `/customdrops set <方块id> <选项> [参数...]` | `customdrops.set` | 设置某方块的特殊掉落，方块不存在时自动创建 | | `/customdrops target <方块id> <true\|false>` | `customdrops.target` | 启用/禁用某方块的特殊掉落 | | `/customdrops delete <方块id>` | `customdrops.delete` | 删除某方块的特殊掉落配置 | | `/customdrops undo [步数]` | `customdrops.undo` | 撤回前几步命令操作，最多 5 步 | | `/customdrops placeholders` | `customdrops.info` | 查看全部可用变量 | | `/customdrops update` | `customdrops.update` | 手动检查更新 |[/MD]
set命令中的所有选项列表：
[MD]方块级（直接写选项名）： | 选项 | 参数 | 对应配置项 | | --- | --- | --- | | `enabled` | `<true\|false>` | `enabled` | | `override-default` | `<true\|false>` | `override-default` | | `silk-touch-preserve-original` | `<true\|false>` | `silk-touch-preserve-original` | | `add-drop` | `<物品id>` | 在 `drops` 末尾追加一项 | | `remove-drop` | `<序号\|物品id>` | 删除某项 | | `clear-drops` | | 清空全部掉落项 | 掉落项级（`drops.<序号|物品id>.<选项>`，也可简写为 `drop-<序号>-<选项>`，序号从 1 开始）： | 选项 | 参数 | 对应配置项 | | --- | --- | --- | | `item` | `<物品id>` | `item` | | `amount` | `<整数>` | `amount` | | `chance` | `<0~1>` | `base-chance` | | `fortune-affects-count` | `<true\|false>` | `fortune-affects-count` | | `fortune-chance-bonus` | `<数字>` | `fortune-chance-bonus` | | `execute-command-per-item` | `<true\|false>` | `execute-command-per-item` | | `silk-touch-ignore` | `<true\|false>` | `silk-touch-ignore` | | `exp` | `<整数>` | `exp` | | `money` | `<数字>` | `money` | | `exp-multiplier` | `<数字>` | `exp-multiplier` | | `money-multiplier` | `<数字>` | `money-multiplier` | | `permission` | `<权限节点\|none>` | `permission` | | `add-command` | `<命令>` | 追加一条控制台命令 | | `add-command-player` | `<命令>` | 追加一条玩家身份命令 | | `add-command-op` | `<命令>` | 追加一条 OP 身份命令 | | `remove-command` | `<序号>` | 删除第 n 条命令 | | `clear-commands` | | 清空全部命令 |[/MD]
依赖
- Vault以及相应的经济插件（如EssentialsX，CMI）（非必须，但不装无法给掉落物设置掉落的金币）
- PlaceHolderAPI（非必须）
YAML：
# ============================================================
# CustomDrops 配置文件
#
# 修改后请执行 /customdrops reload 使其生效。
# ============================================================
# 配置文件结构版本，请勿手动修改
config-version: 2
# 是否检查插件更新（启动后异步检测一次，之后每 6 小时检测一次；
# 发现有新版本时会通知拥有 customdrops.update 权限的在线管理员）
check-update: true
# 更新检测所使用的 GitHub 仓库，格式为 "用户名/仓库名"
update-check:
repository: "CGSuperNova/CustomDrops"
# 是否开启调试模式
# 开启调试模式后，服务器后台将输出详细的运行日志
# 一般情况下建议不要打开，避免日志输出过多
debug: false
# 是否发送 bStats 匿名统计数据
metrics: true
# 在哪些世界启用自定义掉落（世界名区分大小写）
enabled-worlds:
- world
# ============================================================
# 具体方块配置 / Block configuration
#
# 方块名可写 COAL_ORE、coal_ore 或 minecraft:coal_ore。
#
# ============================================================
blocks:
# 方块ID / Block id
COAL_ORE:
# 是否启用该方块的特殊掉落（true = 启用，false = 完全按原版处理）
enabled: true
# 是否覆盖原版的掉落物
override-default: true
# 当玩家的工具有精准采集时，是否保留原版掉落（矿石）
silk-touch-preserve-original: true
# 特殊掉落物详细配置，可配置多个 id
drops:
# 掉落物品id / Item id
- item: "DIAMOND"
# 掉落物品数量 / Base amount
amount: 1
# 掉落该物品的概率（0 ~ 1）/ Drop chance (0 ~ 1)
base-chance: 0.1
# 每级时运额外增加的概率（0.01 = 每级 +1%）
fortune-chance-bonus: 0.0
# 是否允许时运附魔影响掉落数量（按原版随机倍率）
fortune-affects-count: true
# 命令执行次数是否按照掉落物品的数量来执行，如果填false则无论掉多少物品都只执行一次
execute-command-per-item: false
# 若工具有精准采集，是否禁止该特殊掉落物品掉落
silk-touch-ignore: true
# 基础经验值 / Base experience
exp: 10
# 基础金币 / Base money
money: 5.0
# 每级时运增加50%经验
exp-multiplier: 0.5
# 每级时运增加50%金币
money-multiplier: 0.5
# 触发该掉落所需的权限；留空表示不需要任何权限
permission: ""
# 掉落该物品所执行的命令，可以写多个
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-chance-bonus: 0.0
fortune-affects-count: true
execute-command-per-item: true
silk-touch-ignore: false
exp: 30
money: 12.0
exp-multiplier: 0.4
money-multiplier: 0.4
# 只有拥有该权限的玩家才会掉落该物品（示例）
permission: ""
commands:
- command: "give %player% stone 1"
executor: PLAYER
