Ore Regeneration and Mines - 矿石再生与矿场

Ore Regeneration 是一款功能强大的 Minecraft 插件，它允许你创建可再生的矿区和自定义的矿石生成器。通过配置，你可以控制特定区域内方块的掉落物、重生时间以及替换规则，为服务器经济或玩法增添深度。

💡核心功能

• 自定义矿区：划定特定区域，控制区域内方块的破坏、放置、PVP 和生物生成规则。
• 矿石生成器：将任意方块转换为可再生的资源点，自定义其掉落和重生行为。
• 灵活配置：支持为不同方块设置不同的掉落物品、重生时间以及替换逻辑。
• 玩家交互：可设置破坏/放置提示信息、音效以及物品直接进入背包等功能。

🎮如何创建矿区

你需要使用区域选择工具来划定矿区范围。

获取与使用工具

• 使用命令 /regionwand 获取区域选择工具（木棍）。
• 左键点击设定第一个坐标点（pos1）。
• 右键点击设定第二个坐标点（pos2）。
• 在聊天框中输入你为这个区域设定的名称。

学习教程

建议观看以下视频教程以快速上手

• [Dynamic Region tutorial!](Dynamic Region tutorial!)
• [Regular Region tutorial!](Regular Region tutorial!)

🎮如何配置区块与掉落

主要配置文件为 drops.yml，你可以在其中全局配置方块掉落，也可以为特定区域进行独立配置。

权重系统说明

在配置 replaceWith 和 replenishAs 时，你需要为材料设置整数权重。插件的随机选择机制如下：

假设配置列表为

GOLD_ORE,10
IRON_ORE,50
STONE,160

• 总权重上限为 160，插件会随机生成一个 0 到 160 之间的数字。
• 插件从权重最低的选项开始检查。如果随机数 小于等于 某个选项的权重，则该选项进入候选列表。
• 最终从候选列表中随机选择一个（候选列表内选项概率相等）。

这意味着

• 金矿石 (GOLD_ORE) 仅在随机数 ≤ 10 时可能被选中。
• 铁矿石 (IRON_ORE) 仅在 10 < 随机数 ≤ 50 时可能被选中。
• 石头 (STONE) 仅在 50 < 随机数 ≤ 160 时可能被选中。

配置示例

在 drops.yml 中，你可以进行全局配置，也可以在 regions: 部分下为特定区域进行覆盖配置。

blocks:
  DIRT:
    drops:
      DIAMOND:
        name: '&2Test Item'
        lore:
          - '&6Optional line'
          - '&2Second line'
        max-drop: 5
        min-drop: 1
        replenishTime: 100
regions:
  example_region:
    DIRT:
      drops:
        DIAMOND:
          max-drop: 5
          min-drop: 1
          name: '&2Test Item'
          lore:
            - '&6Optional Line'
            - 'You can delete this btw'

**说明**

• 在 blocks: 部分下可以添加任意数量的材料（Material）。
• 在材料下添加 drops: 可以自定义其掉落物。配置多个掉落物时，挖掘时会随机选择其中之一。
• replenishTime: 的作用与 locations.yml 中的相同，控制方块重生所需的 tick 数。

❓常见问题

如何移除一个矿石生成器？

• 如果你是放置者：右键点击生成器方块，在出现的 GUI 中点击名为 “yes” 的物品。这将使生成器掉落为物品并从世界中移除。
• 如果你是管理员：拥有 oreGen.regions.noderemover 权限即可移除任何人生成的矿石生成器。

服务器重启时，未重生的方块还会重生吗？

会的。只要不删除存储节点和区域数据的 nodes.yml 或 regions.yml 文件，服务器关闭时，那些尚未到重生时间的方块会自动完成重生过程。

如何获得一个矿石生成器？

• 拥有相应权限后，手持任意方块，执行命令 /node，即可将其转换为矿石生成器。
• 或者，任何名称中包含蓝色“Generator”字样的物品（使用颜色代码 &9）都可以作为生成器使用。

🔧权限列表

• oreGen.commands
• oreGen.commands.node - 允许使用 /node 命令。
• oreGen.commands.delete - 允许使用 /deleteregion 命令。
• oreGen.commands.editmode - 允许使用 /editmode 命令。
• oreGen.regions
• oreGen.regions.editor - 允许玩家在编辑模式下修改区域。
• oreGen.regions.noderemover - 允许玩家移除非自己所有的矿石生成器。

🔧命令列表

• /node - 将手持方块转换为矿石生成器。
• /regionwand - 获取区域选择工具。
• /showborder [region name] - 显示指定区域的边界。
• /editmode [region name] [on/off] - 开启或关闭指定区域的编辑模式。
• /regionlist - 列出所有现有区域。
• /reloadconfig - 重载 Ore Regeneration 的所有配置文件。
• /region [regionname] - 打开指定区域的 GUI。
• /region [region] setPlaceMsg [msg] - 设置玩家在区域内禁止放置方块时的提示信息。留空则无提示。
• /region [region] setBreakMsg [msg] - 设置玩家在区域内禁止破坏方块时的提示信息。
• /region [region] setFullmsg [msg] - 当区域启用“物品直接入背包”功能且玩家背包已满时，设置提示信息。
• /region [region] setBreakSound [sound] [volume] [pitch] - 设置在区域内破坏方块时播放的附加音效（在原版破坏音效之上）。可用音效可通过 Tab 键补全查看（包含所有原版 Minecraft 音效）。
• /region [region] removeBreakSound - 清除区域设置的附加破坏音效。
• /region [region] setPickupMsg [material-name] [msg] - 当区域启用“物品直接入背包”功能时，设置特定物品进入玩家背包时的提示信息。可使用 [x] 作为获取物品数量的占位符。

⭐配置文件示例

以下是一个通过 YAML 文件直接配置的完整区域示例，展示了所有可用选项：

regiontest:
  canBreak:
    STONE:
      replaceWith:
        - COBBLESTONE,1
      replenishTime: 140
      replenishAs:
        - GOLD_ORE,20
        - IRON_ORE,65
        - STONE,100
      replaceAs: []
    COBBLESTONE:
      replaceWith:
        - BEDROCK
      replenishTime: 40
    IRON_ORE:
      replaceWith:
        - STONE
      replenishTime: 40
      replenishAs:
        - STONE,1
    GOLD_ORE:
      replaceWith:
        - STONE
      replenishTime: 40
      replenishAs:
        - STONE
  pvp: false
  mobs-spawn: false
  pos1: i,63,3,19
  pos2: i,57,9,12
  break-msg: 'test '
  break-sound:
    name: BLOCK_ANVIL_FALL
    volume: 1.0
    pitch: 1.0
  full-msg: 'full_inventory '
  pickup-msg:
    GOLD_ORE: '+ [x] gold ore! '
  dropInInventory: true
  dropOnPlayer: false
  givePlayerXp: false

✨重要提示与支持

• 重生时间限制：如果设置的重生时间超过 20 分钟，将被插件内的自动重生系统覆盖。
• 问题与反馈：如果你仍有疑问、需要支持或发现了漏洞，请在插件发布页留下评论。
• 联系作者：你可以通过 Discord 联系我：Meep#8596（现为 meep8496）。