挖掘事件

开发者提示: 此事件非彼事件，这个页面的“事件”是抽象概念，而非 Bukkit API 的事件。

本插件将挖掘掉落物品抽象成多个挖掘事件，如果你没有改过 config.yml，挖掘事件默认放在 events 目录中。

你可以创建任意数量的 .yml 文件来添加挖掘事件，文件名去掉后缀名即为事件 ID，比如 example.yml 的事件ID是 example。事件 ID 目前只用作调试日志，暂无他用。

默认挖掘事件配置如下

# 在哪些世界可用
worlds:
  - world
# 挖掘哪种方块会触发掉落
blocks:
  - BEDROCK
# 要求使用什么物品来挖掘，留空则不限制挖掘工具
# 原版物品直接填ID，比如 DIAMOND_PICKAXE
# MythicMobs 物品使用 mythic:物品ID 比如 mythic:ExampleItem
# MMOItems 物品使用 mmo:物品类型:物品ID 比如 mmo:Tools:EXAMPLE_ITEM
tools: []
# 要求使用合适的工具来挖掘才能触发掉落
# 比如矿只能用镐子挖等等
require-preferred-tool: false
# 要求使用带有什么附魔的物品来挖掘，留空则不限制挖掘附魔
# 格式为 附魔:等级 或 附魔，不输入等级的格式不限制等级
# 1.13+ 使用原版的附魔ID，1.12.2 及以下请查阅以下链接
# https://helpch.at/docs/1.12.2/org/bukkit/enchantments/Enchantment.html
# 原版示例：
#   要求锋利I     sharpness:1
#   要求锋利      sharpness
# EcoEnchants 示例：
#   要求保护光环I  aura:1
#   要求保护光环   aura
enchantments: []
# 掉落取消设置
cancel:
  # 是否取消原版的全部掉落，不分情况
  all: false
  # 如果概率判定成功，掉落了物品，是否取消原版掉落
  if-drop-any: false
# 拥有此权限的玩家，掉落物将会自动放到背包，注释则不使用此功能
perm-to-inventory: sweet.drops.auto
# 在物品带有什么附魔时，掉落物将会自动放到背包
# 格式与 enchantments 相同
enchantments-to-inventory:
  - binding_curse
# 背包满了以后，掉落物自动放入背包时，不在玩家附近掉落溢出物品，而是直接消失
# 开启此选项，如果实际给予了玩家0个物品，将阻止命令列表执行
overflow-disappear: false
# 掉落物品设置，格式如下，其中<>为必选参数，[]为可选参数
#   原版格式：          mc <概率> <物品ID> [数量] [end]; [命令] [text]
#   预制体格式：        prefeb <概率> <预制体ID> [数量] [end]; [命令] [text]
#   MythicMobs物品格式：mythic <概率> <物品ID> [数量] [end]; [命令] [text]
# 概率有两种格式
#   小数格式：<数值>        比如 0.5 代表 50%
#   百分比格式：<数值>%     比如 50%
# 数量不填默认为1，填写时可以使用以下格式
#   固定数量：<数字>        比如 1
#   随机数量：<下界>-<上界>  比如 1-5
# 可选参数 end 如果填写，当此物品概率判定成功时，剩下的物品将会跳过概率判定，直接判为失败
# 可选参数 命令 如果填写，当此物品概率判定成功时，执行 commands-pool 中对应的命令列表
# 可选参数 text 如果填写，命令列表中 %text% 将会替换为这个值
items:
  - mc 0.1 netherite_ingot 1-5 end; example 下界合金锭
  - mc 0.1 gold_ingot 1-5
# 时运设置
fortune:
  # 取整方式，ceil 向上取整，floor 向下取整，round 四舍五入
  rounding: ceil
  # 时运等级对应的物品数量乘数，可填随机范围，如 1.0-1.2
  # 没有相应等级的，乘数默认 1.0
  multiples:
    # 0级代表没有时运附魔
    0: 1.0
    1: 1.0
    2: 1.0
    3: 1.0
# 命令列表池
# [console]控制台执行
# [player]玩家执行
# [message]聊天消息
# 均支持 PAPI 变量。特殊地，%text% 变量请见上文，%amount% 代表获得的物品数量，%fortune% 代表时运等级
# 命令列表池中可以添加多个不同名字的命令列表，用于 items 中调用
commands-pool:
  example:
    - '[message]&e你在矿物中获得了 &b%text%&fx%amount%'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

注释已经很详细了，以下挑一些值得一讲的选项，进行具体说明并给出示例。

# worlds

指定该挖掘事件在哪些世界可用。在这个选项里输入世界名列表。

# 示例
worlds:
  - 世界1
  - 世界2

1
2
3
4

# blocks

指定玩家在挖掘哪些方块时，该挖掘事件才可用。在这个选项里输入方块的英文ID列表，不支持 Minecraft 旧版的子ID。

# 示例
blocks:
  - DIAMOND_ORE
  - IRON_ORE

1
2
3
4

# tools

指定需要手持列表中的哪些工具来挖掘时，该挖掘事件才可用。在这个选项里输入物品列表。物品格式如下

原版物品：英文ID 例如 DIAMOND_PICKAXE
MythicMobs 物品：mythic:物品ID 例如 mythic:ExampleItem
MMOItems 物品：mmo:物品类型:物品ID 例如 mmo:Tools:EXAMPLE_ITEM

# 示例
tools:
  - 'DIAMOND_PICKAXE'
  - 'mythic:ExampleItem'
  - 'mmo:Tools:EXAMPLE_ITEM'

1
2
3
4
5

# enchantments

指定需要手持的工具拥有列表中的哪些附魔时，该挖掘事件才可用。附魔格式如下

附魔ID 要求拥有哪个附魔，不要求等级
附魔ID:等级 要求拥有至少多少级的哪个附魔

对于附魔ID，1.13 及以上使用原版附魔ID (opens new window)（Minecraft Wiki/Java版数据值魔咒），1.12.2 及以下使用Bukkit接口枚举名 (opens new window)。

相关使用示例已在配置文件注释中提供，在 1.13 及以上可兼容 EcoEnchants 的附魔。

# items

该挖掘事件会掉落的物品、掉落概率、掉落数量、执行命令等配置项。

这是一个列表，列表中每一个条目的基本格式为

<类别> <概率> <物品ID> [数量] [end]; [命令] [预留变量]

其中以 <> 包裹的为必选参数，以 [] 包裹的为可选参数。
类别有 mc、prefeb、mythic 等，在配置文件注释中已进行说明。

概率可使用小数(1.0)或百分比(100%)的形式。

数量可使用固定数值(1)或随机数值(1-3)的格式。

填写了 end，则代表如果这个条目的概率判定成功了，在这个条目后面的所有条目都跳过。

如果你填写了分号，以及命令池名称，则会在判定成功时调用命令池中的命令。不需要命令时可不写分号。

以下是一些示例

items:
  # 有 10% 的几率，刷出 1-5 个下界合金锭，如果刷出了，下面的全部跳过，
  # 并执行 example 命令池，命令池中的 %text% 会替换成 下界合金锭
  - mc 0.1 netherite_ingot 1-5 end; example 下界合金锭
  # 有 10% 的几率，刷出 1-5 个金锭
  - mc 0.1 gold_ingot 1-5
  # 有 10% 的概率，刷出 2-3 个 MythicMobs 物品 ExampleItem
  - mythic 10% ExampleItem 2-3
  # 有 5% 的概率，执行 foo 命令池
  - mc 5% air 1; foo

1
2
3
4
5
6
7
8
9
10

上次更新: 2025/05/03, 21:58:24

← 命令与权限简介→