Mystery Bags - 神秘福袋

MysteryBags 是一款为 Minecraft 1.9+ 服务器设计的插件，它完全重写并改进了已停止更新的 SurpriseBags。玩家可以从生物身上获得这些可自定义的神秘袋子，右键点击即可打开，袋子会消失并随机获得一件物品！所有内容都可通过游戏内命令和配置文件轻松定制。

💡核心特性

• 高度可定制的消息系统。
• 袋子可从任何生物身上掉落。
• 掉落限制：可按世界、WorldGuard 区域、生物类型、名称甚至元数据进行限制。
• 袋子可以是任何物品：包括自定义玩家头颅。
• 袋子可包含命令：打开时从控制台执行。
• 奖励数量随机：可设置随机数量范围。
• 游戏内 GUI 编辑器：轻松编辑袋子内容。
• 稀有物品公告：当玩家获得稀有物品时，可向全服公告。

🎮命令列表

命令格式：<必填参数> [可选参数]

• /mbag list - 列出所有已加载的神秘袋子 ID。
• /mbag addbag <id> [材质]:[数据值] - 创建一个新的神秘袋子配置文件。除非你清楚自己在做什么，否则请始终使用此命令来创建新袋子！
• /mbag removebag <id> - 卸载一个已加载的袋子（不会删除文件）。在删除配置文件前请使用此命令。
• /mbag spawn <id> [数量] [玩家] - 生成指定数量的神秘袋子。
• /mbag edit <id> - 为指定的神秘袋子打开内容编辑 GUI。
• /mbag save <id> - 将 GUI 编辑器中的更改保存到袋子的配置文件中。
• /mbag reload - 重新从磁盘加载配置选项和所有袋子。
• /mbag stack <数字> - 设置手中物品的堆叠数量（用于物品权重计算）。
• /mbag amount <数字> - 设置从袋子中可获得的该物品的数量（不影响掉落几率）。可使用 <最小-最大> 格式指定一个范围（包含两端）。
• /mbag command <命令> - 生成一本写有命令的成书。如果从神秘袋子中获得，玩家不会得到书，而是会从控制台执行这些命令。对现有的“命令书”使用此命令可以添加更多命令。

- **命令中允许的参数（区分大小写）**：

- `%P%` - 玩家名

- `%W%` / `%X%` / `%Y%` / `%Z%` - 玩家的世界和坐标

• /mbag setname <名称> - 设置手中物品的自定义名称。
• /mbag setlore <描述> - 设置手中物品的自定义描述。使用 / 分隔多行。
• /mbag addlore <描述> - 向手中物品追加描述行。使用 / 添加多行。
• /mbag removelore [行数] - 从物品描述底部开始移除指定行数，例如 /mbag removelore 2 会移除最底部的 2 行。
• /mbag unbreakable - 切换手中物品的“无法破坏”状态。需要服务器运行 Spigot。
• /mbag skulldata <文件名> - 显示手中头颅的内部数据。将此数据用在配置文件 material: 部分，即可将自定义头颅设为袋子！指定文件名会将输出写入文件。

✨权限节点

• mysterybags.open - 允许打开神秘袋子。

- 默认：所有人

• mysterybags.admin - 允许使用所有 MysteryBag 命令。

- 默认：管理员 (OP)

🔧与 SurpriseBags 的主要区别

本插件设计上尽可能兼容现有的 SurpriseBags 配置，但在移植旧的袋子和配置文件前，仍需注意以下改动：

• 新增检查，防止玩家用神秘袋子进行合成、烧炼或酿造。
• 袋子掉落的区域和世界限制，现在基于生物被杀死的位置（而非生成位置）。
• 袋子可以在主手和副手槽位中打开。双手各持一个袋子会同时打开两个！
• 移除了袋子的“全局”掉落几率。现在每个袋子的掉落几率都在其独立配置中指定。
• 掉落几率可进一步按生物类型变化，例如，骷髅掉落特定袋子的几率可以比其他生物更高。
• 玩家的开袋计数和“稀有”奖励获取会被追踪，并记录到 output.yml。
• 可以指定“稀有”奖励，并在幸运玩家获得时向全服公告，可选烟花和音效。广播消息完全可自定义。
• 袋子的 ID 不再显示在物品描述中。
• 大量新增的配置选项！

更新 SurpriseBag 配置至 MysteryBag

只需将以下代码块复制粘贴到对应的配置文件中（并根据需要编辑）：

添加到 config.yml 的补充内容

# 是否必须由玩家击杀生物才有机会掉落袋子？
require-player-kill: yeah
### 可选
# 刷怪笼生成的生物可以掉落神秘袋子吗？
# 此值将覆盖全局设置。
allow-spawner-drop: no
### 可选
# 幼年动物可以掉落神秘袋子吗？
# 不适用于僵尸。
# 此值将覆盖全局设置。
allow-baby-drop: no
#
# 抢夺附魔几率提升
# 仅在 looting-sensitive 为 true 时生效 - 每级抢夺附魔将使掉落率提升此数值。
looting-effectiveness: 0.05
#
# 抢夺增加数量
# 如果为 true，则当玩家获得袋子时，抢夺附魔有机会增加掉落的袋子数量。
looting-increases-amount: no
#
# 告诉玩家他们获得了什么物品的消息
# %ITEMNAME% - 物品名称，若无名称则为材质名
# %ITEM% - 物品材质
open-message: 'The bag contained %ITEMNAME%!'
#
# 公告稀有战利品
# 如果为 true，每当玩家从 rare-items 列表中获得奖励时，都会广播 announce-rare-loot-message。
announce-rare-loot: indubitably
#
# 稀有战利品烟花
# 如果为 true，玩家获得稀有战利品时会在其位置发射烟花。
rare-loot-firework: k
#
# 稀有战利品音效
# 如果为 true，玩家获得稀有战利品时会对所有人播放“凋灵生成”音效。
rare-loot-sound: true
#
# %PLAYER% - 玩家名
# %ITEMNAME% - 物品名称，若无名称则为材质名
# %ITEM% - 物品材质
announce-rare-loot-message: '%PLAYER% got lucky and received %ITEMNAME% from a Mystery Bag!'
#
# 是否记录每位玩家打开每种袋子的数量。数据将写入 output.yml
log-bags: no
#
# 是否记录玩家获得的稀有战利品。数据将写入 output.yml
log-rare-loot: no
#
# 此处列出的物品被视为稀有战利品。这些仅影响稀有战利品消息。
# 格式：
# 物品材质:
#   - '如果此列表非空，'
#   - '则仅当物品名称包含在此列表中时才视为稀有。'
#   - '使用 & 作为颜色代码。'
## 此物品无论名称如何始终是稀有的：
# OTHER_ITEM: []
rare-loot:
  DIAMOND: []

添加到袋子配置文件（如 treasure.yml）的补充内容

#
# 重要!!!!!!!!!!!!!!!!!!!!!!!
# 将 'openmsg' 改为列表格式！
# 例如：
# openmsg:
#   - "&2Hold item and right click to open!"
#
#
# 此袋子是否会触发掉落检查
#
enabled: false
#
# 与 drop-chance 相同，但按生物定义。
# 此处的值会覆盖上面的 drop-chance。
drop-chance-mobs:
  ZOMBIE: 0.2

⭐默认配置文件

默认 config.yml

# CheezBags 配置文件
#
# 常规设置：
#
# 不要修改这个！！！！
version: 1
# 袋子是否会从生物掉落，设置为 yes/no
# 不限于敌对生物
drop-from-mobs: yes
# 神秘袋子是否应该与生物的正常掉落物分开掉落？
# 如果你怀疑插件冲突导致袋子无法掉落，请将此选项设为 TRUE！
override-drops: no
# 是否必须由玩家击杀生物才有机会掉落袋子？
require-player-kill: yeah
# 刷怪笼生成的生物可以掉落神秘袋子吗？
# 这是默认值，可以在单个袋子配置中被覆盖。
default-allow-spawner-drop: no
# 幼年动物可以掉落神秘袋子吗？
# 不适用于僵尸。
# 这是默认值，可以在单个袋子配置中被覆盖。
default-allow-baby-drop: no
#
# 受抢夺附魔影响
# 如果为 true，则每个袋子的掉落几率会随着抢夺附魔等级提升而增加。
# 即，如果玩家使用带有抢夺附魔的剑，他们获得袋子的几率更高。
#
looting-sensitive: no
#
# 抢夺附魔几率提升
# 仅在 looting-sensitive 为 true 时生效 - 每级抢夺附魔将使掉落率提升此数值。
looting-effectiveness: 0.05
#
# 抢夺增加数量
# 如果为 true，则当玩家获得袋子时，抢夺附魔有机会增加掉落的袋子数量。
looting-increases-amount: no
# 限制掉落区域的 WorldGuard 区域列表。
# 例如，如果你只想在出生点区域掉落袋子，这很有用。
# 此功能需要安装 WorldGuard（显然）。
# 如果此项为空 ('[]')，袋子将尝试在所有地方掉落。
drop-limit-to-area: []
#
# 限制掉落至特定世界。
# 如果此项不为空 ('[]')，袋子将只在这些世界中掉落。
# 否则袋子将尝试在所有世界掉落。
drop-limit-to-world: []
#
# 告诉玩家他们获得了什么物品的消息
# %ITEMNAME% - 物品名称，若无名称则为材质名
# %ITEM% - 物品材质
# %BAG% - 袋子物品的显示名称，如果物品没有名称则使用袋子 id
open-message: 'The bag contained %ITEMNAME%!'
#
# 开袋监视消息
# 如果为 true，服务器 OP 会在用户打开袋子时收到消息。
openingspymessage: sure
#
# 公告稀有战利品
# 如果为 true，每当玩家从 rare-items 列表中获得奖励时，都会广播 announce-rare-loot-message。
announce-rare-loot: indubitably
#
# 稀有战利品烟花
# 如果为 true，玩家获得稀有战利品时会在其位置发射烟花。
rare-loot-firework: k
#
# 稀有战利品音效
# 如果为 true，玩家获得稀有战利品时会对所有人播放“凋灵生成”音效。
rare-loot-sound: true
#
# %PLAYER% - 玩家名
# %ITEMNAME% - 物品名称，若无名称则为材质名
# %ITEM% - 物品材质
# %BAG% - 袋子物品的显示名称，如果物品没有名称则使用袋子 id
announce-rare-loot-message: '%PLAYER% got lucky and received %ITEMNAME% from a &e%BAG%&6!'
#
# 是否记录每位玩家打开每种袋子的数量。数据将写入 output.yml
log-bags: no
#
# 是否记录玩家获得的稀有战利品。数据将写入 output.yml
log-rare-loot: no
#
# 此处列出的物品被视为稀有战利品。这些仅影响稀有战利品消息。
# 格式：
# 物品材质:
#   - '如果此列表非空，'
#   - '则仅当物品名称包含在此列表中时才视为稀有。'
#   - '使用 & 作为颜色代码。'
## 此物品无论名称如何始终是稀有的：
# OTHER_ITEM: []
rare-loot:
  DIAMOND: []

默认袋子示例：treasure.yml

此文件定义了袋子的外观、掉落条件和内容。完整示例展示了如何设置材质、显示名称、掉落几率及丰富的奖励物品列表（包括附魔装备）。

自定义头颅袋子示例：gift.yml

此示例展示了如何使用自定义玩家头颅作为袋子外观。material 字段包含了一长串 Base64 纹理数据，袋子本身被命名为 “Fancy Gift”。

---

发现漏洞？有功能请求或建议？请在插件页面留言或私信我！

在 GitHub 上查看源代码。