StoneTreasures - 挖矿寻宝

StoneTreasures 是一款让挖矿过程变得更有趣的插件。玩家在挖掘特定方块时，有（可配置的）几率获得宝藏奖励。这使得长时间挖矿不再枯燥，因为你不仅有机会挖到矿石，还可能随机获得各种战利品。

💡版本与下载

• 支持的版本：Minecraft 1.9+
• 下载最新版：请下载插件的最新版本。
• 旧版本支持：
• Minecraft 1.8：请下载对应的旧版本。
• Minecraft 1.7 及以下：不支持。

✨核心功能

• 丰富的 GUI 界面：几乎所有选项都可以通过 GUI 界面进行编辑。
• 高度灵活与可定制：插件提供了数百种可能性，你的想象力是唯一的限制。无论是使用默认设置，还是深度自定义，都能发挥其强大潜力。
• 自定义宝藏类型：可以创建自定义的宝藏类型，包括触发几率、奖励内容、动画效果、全服公告和音效。
• 清晰的错误提示：开发者已尽力消除控制台错误，取而代之的是在聊天栏中清晰的错误说明和修复指引。（如果发现控制台错误，请反馈！）
• 自然的自定义物品获取途径：为玩家提供一种在挖矿时自然获得自定义物品的方式。
• VIP 权限系统：可以为 VIP 玩家设置特定权限，使其获得宝藏的几率更高。
• 多样化的奖励形式：奖励可以是物品，也可以是执行的命令。
• 丰富的物品定制：可以为宝藏物品添加自定义名称、描述（Lore）、附魔等。
• 可选的全服公告：当玩家发现宝藏时，可以选择是否向全服广播。
• 灵活的奖励发放：奖励可以直接放入玩家背包、掉落在地上，或放入一个特殊的 GUI 界面中。
• 视听效果：当发现宝藏时，可以播放特定的音效或粒子效果。
• WorldGuard 支持：在无法建造的区域（WorldGuard 保护区）内无法获得宝藏。（注意：此功能在 v2.8.0 版本中暂时移除）

🔧安装指南

• 下载插件的 .jar 文件。
• 将其放入服务器的 /plugins 文件夹。
• 重载或重启服务器。
• 在配置文件中配置你的宝藏物品。

🎮命令与权限

通用命令与权限

• 命令：/stonetreasures 或 /st
• 权限：无（所有人可用）
• 功能：打开通用 GUI。普通玩家可以访问奖励 GUI 和展示 GUI。

管理员命令与权限

• 命令：/stonetreasures 或 /st
• 权限：stonetreasures.admin
• 功能：访问完整 GUI，包括选项面板、编辑战利品类型和宝藏、链接、属性模式等。

其他命令

• /stonetreasures debug：启用或禁用调试模式。也可以通过 GUI 操作。
• /stonetreasures links：在聊天栏中列出“有用链接”。也可以通过 GUI 操作。
• /st set <loot type> [chance/display/displayname/message/broadcast/playsound] <chance;item;name;true/false>：设置指定战利品类型的几率、展示物品、展示名称，并开关其消息、广播、音效和粒子功能。

其他权限

• stonetreasures.log：如果在选项 GUI 中启用了日志，拥有此权限的玩家将在有人发现宝藏时收到消息。
• stonetreasures.treasures.<treasure>：玩家必须拥有对应宝藏的权限才能获得它。这意味着，如果你想让玩家获得所有宝藏，他们需要拥有所有对应的权限（例如，使用 PEX 时，可以给予 stonetreasures.treasures.* 权限）。
• 倍率权限：在配置文件中指定。可以按需添加或编辑。它们默认不对 OP 生效。未来更新将通过 GUI 编辑它们。

⭐配置说明

配置文件 (config.yml) 允许你深度定制插件。以下是一个简化示例，展示了核心结构：

options:
  debug: false
  survival-only: true
  drop-to-inventory: true
  allowed-worlds:
    - world

treasure-types:
  common:
    GUI-display:
      item: INK_SACK:3
      name: "&7普通宝藏"
    allowed-blocks:
      - STONE
    percent-chance: 3
    message:
      enabled: true
      message: "&6你在挖矿时找到了一个 &7普通 &b%item%&6！"
    broadcast:
      enabled: false
      message: '&6%player% 在挖矿时找到了一个 &7普通 &9%item%&6！'
    playsound:
      enabled: true
      sound: BLOCK_NOTE_PLING
      volume: 10
    treasures:
      1:
        type: command
        command: 'say 你好'
      2:
        type: command-list
        name: "&6钻石套装"
        commands:
          - 'give %player% minecraft:DIAMOND_HELMET'
          - 'give %player% minecraft:DIAMOND_SWORD'
          - 'give %player% minecraft:DIAMOND_LEGGINGS'
          - 'give %player% minecraft:DIAMOND_CHESTPLATE'
          - 'give %player% minecraft:DIAMOND_BOOTS'

multiplier-permissions:
  '1':
    permission: stonetreasures.vip
    multiplier: 2
  '2':
    permission: stonetreasures.peasant
    multiplier: 0.9

配置要点

• allowed-blocks：指定可以触发此宝藏的方块列表。可以使用 方块:数据值 的格式（如 LOG:2）来指定子类型。
• percent-chance：挖掘 allowed-blocks 中任一方块时，获得此宝藏的百分比几率。
• treasures：宝藏奖励列表。类型 (type) 可以是：
• item：给予物品。可配置物品、数量、名称、Lore、附魔、耐久等。
• command：执行单个命令。可使用 %player% 代表玩家名。
• command-list：执行一系列命令。
• multiplier-permissions：自定义权限倍率。拥有指定权限的玩家，其获得宝藏的原始几率将乘以对应的倍率。

> 注意：以上示例基于旧版本（v2.6）配置，最新版配置可能有所变化，请以实际生成的配置文件为准。更复杂的配置示例，请参考插件页面提供的 Advanced Example 链接。

❓教程指南

基础设置

• 添加当前世界：

- 将插件放入 `/plugins` 文件夹并重载/重启服务器。

- 使用 `/st gui` 打开 GUI。

- 转到“选项”标签（比较器图标）。

- 点击“允许的世界”（钻石镐图标）。

- 点击“添加当前世界”（连锁命令方块图标）。

- 关闭 GUI。

• 创建宝藏类型和宝藏：可以通过配置文件或 GUI 完成。其他教程会详细说明。

• 分配权限：

- 格式：`stonetreasures.treasures.<宝藏类型名称>`

- 给予 `stonetreasures.treasures.*` 权限以获得所有宝藏。

- 或者，直接给予玩家 OP 权限。

通过 GUI 操作

• 创建新宝藏类型：
• 使用 /st gui 打开 GUI。
• 转到“宝藏类型”部分（指南针图标）。
• 点击“新建宝藏类型”（纸图标）。
• 在聊天栏中输入名称（支持颜色代码，如 &c），按回车确认。

• 编辑触发几率：
• 在“宝藏类型”界面，点击想要修改的宝藏类型。
• 点击“编辑几率”（向日葵图标）。
• 在聊天栏输入新的几率（0 到 100 之间），按回车确认。

• 编辑宝藏内容：
• 在“宝藏类型”界面，点击想要修改的宝藏类型。
• 转到“宝藏”部分（默认是石头图标）。
• 你可以直接从背包拖拽物品到 GUI 中来添加简单的物品奖励，然后点击“保存”。
• 注意：要添加带有 Lore、附魔等复杂属性的物品，目前仍需通过配置文件编辑。

通过配置文件操作

• 添加新宝藏：在 treasures: 列表下，复制一个已有的宝藏条目（如 ‘1’: …），粘贴并顺序修改其编号（如 ‘2’: …）。
• 创建物品奖励：将 type 改为 item，并配置 item（物品类型）、amount（数量）、name（名称）、lore（描述）、enchants（附魔）等字段。
• 创建命令奖励：将 type 改为 command 或 command-list，并配置 command 或 commands 字段。可使用 %player% 变量。

🔧有用链接

Minecraft 1.8

• 音效列表
• 材料列表
• 附魔列表
• 粒子效果列表
• 状态效果列表

Minecraft 1.9+

• 音效列表
• 材料列表
• 附魔列表
• 粒子效果列表
• 状态效果列表

（具体链接请查看原插件页面）

✨计划功能

• 自定义 WorldGuard 标志。
• 使用标题或动作栏消息替代聊天栏消息。
• 为宝藏物品添加 Item Flags。
• 多重物品奖励。
• 彻底消除控制台错误（开发中），用清晰的聊天栏错误提示替代。
• 欢迎提出建议！

⭐其他信息

• 反馈 Bug：如果你发现了漏洞，请通过私信、Discord 或资源页面的讨论区反馈，请不要在评论区内提交。
• 喜欢这个插件？ 请留下评论！
• 非常喜欢这个插件？ 考虑捐赠支持开发者！

开发者：@instantout