RampenDrills - 自动化采矿插件

为你的服务器添加自动化采矿功能！本插件允许玩家建造自动钻机，持续挖掘方块并将物品收集到箱子中。如果你正在从 4.4.0 或更低版本更新，建议阅读相关更新说明。

💡快速开始

建造钻机

按照以下结构放置方块

• 放置 2 个铁块、1 个熔炉、1 个箱子和 1 个钻石块。
• 具体布局请参考下方图示。

启动钻机

• 在熔炉中放入燃料（例如煤炭）。
• 手持钻机工具，右键点击钻机头部（铁块/钻石块/绿宝石块）。
• 钻机将开始工作，并将挖掘到的物品放入箱子。

停止条件

钻机在移动前会检查两个方块

• 熔炉正下方的方块。
• 相对于熔炉下方方块，钻头挖掘方向上的下一个方块。

如果其中任何一个方块是空气或液体，钻机将停止工作。

🎮钻机类型与布局

水平钻机

（此处应放置水平钻机布局图）

垂直钻机

（此处应放置垂直钻机布局图）

对于垂直钻机，停止检查的方块位置有所不同。

大型钻机

（此处应放置大型钻机布局图，使用双箱子的结构）

✨配置详解

钻机尺寸

在配置文件中找到 DrillSizes 选项。默认配置如下：

DrillSizes:
  Default:
    Height: 3
    Width: 3
    WidthOffset: Auto

• Height 和 Width：钻机挖掘区域的高度和宽度。
• WidthOffset：通常设置为 Auto 即可。对于想精确控制偏移（如 4x4 钻机）的高级用户，可以手动设置（例如 3x3 对应 -1，5x5 对应 -2）。
• 你可以添加任意多个不同名称的尺寸预设。

配置示例：

DrillSizes:
  Default:
    Height: 3
    Width: 3
    WidthOffset: Auto
  NotDefault:
    Height: 5
    Width: 5
    WidthOffset: Auto

钻机头部

在配置文件中找到 DrillHeads 选项。你可以定义不同方块作为钻头，并设置其属性。默认提供了绿宝石块、铁块和钻石块的配置。

每个钻头可以配置以下属性

• SilkTouch：是否启用精准采集。
• FuelModifier：移动时的燃料消耗倍率。
• DigFuelCost：挖掘一个方块的基础燃料消耗。
• Permission：使用此钻头所需的权限节点（例如 rampen.drills.silk）。移除此项则无需权限。
• Size：此钻头使用的尺寸预设名称（对应 DrillSizes 中的配置），无效或移除则使用 Default。
• NormalDelay / LongDelay：挖掘普通方块和坚硬方块（如黑曜石）的延迟（刻数）。
• SlowBlocks：触发 LongDelay 的方块材料列表。

添加自定义钻头示例：

DrillHeads:
  COBBLESTONE:
    SilkTouch: false
    FuelModifier: 2
    DigFuelCost: 30
    NormalDelay: 30
    LongDelay: 100
    Size: NotDefault

Permission、DrillShapes、Size 和 SilkTouch 选项可以移除，插件将使用默认值。

钻机形状

可用的钻机形状有

• default：标准钻机（如图示）。
• placement：与标准类似，但侧面有金块，此钻机可以放置方块。
• ender 与 enderplacement：功能同上，但使用末影箱代替普通箱子。
• large 与 largeplacement：使用双箱子的钻机。

🔧命令与权限

命令列表

• /drill, /rdrill, /rdrills, /drills：显示插件名称、版本和作者。
• /drill tool：获取用于启动/停止钻机的工具。
• /drill effect [type/off]：开启或关闭钻机的粒子效果类型。
• /drill pattern [pattern/none]：选择配置中预设的方块放置模式（仅对 placement 形状的钻机有效）。
• /drill filter [add/remove/list/clear]：设置钻机不拾取的物品过滤器（使用手中的物品）。

权限节点

• rampen.drills.use：允许使用钻机。
• rampen.drills.limit.X：限制玩家可拥有的钻机数量（X 为数字）。
• rampen.drills.unlimited：允许拥有无限数量的钻机。
• rampen.drills.tool：允许使用 /drill tool 命令。
• rampen.drills.pattern.select：允许使用 /drill pattern 命令。
• rampen.drills.cosmetic：使用所有粒子效果所需的权限。
• rampen.drills.itemfilter：允许使用 /drill filter 命令。
• rampen.drills.silk：默认绿宝石钻头所需的权限。
• rampen.drills.basic：提供使用插件所需的基本权限（包含 rampen.drills.use、rampen.drills.tool 和 rampen.drills.limit.1）。

⭐主要特性

• 数量限制：可通过权限节点精确控制每位玩家可拥有的钻机数量。
• 高度可定制：

-   每个钻头可独立配置挖掘速度。

-   完全可自定义的提示消息（包括前缀）。

-   可自定义燃料消耗。

-   可自定义钻头方块和钻机尺寸。

-   可自定义粒子效果。

• 功能选项：支持使用潜影盒代替普通箱子。
• 智能管理：

-   玩家下线或远离钻机时，钻机会自动停止。

-   应能在领地插件保护的领地边界处停止（需测试）。

• 物品过滤：玩家可以为钻机设置物品拾取黑名单。

❓注意事项与支持

重要提醒

• 强烈建议你在自己的服务器上进行全面测试。因使用不当造成的任何损失需自行承担。
• 请勿在评论区域提交功能请求或错误报告。

获取帮助

如果你有任何问题、发现错误，或有新功能建议，最佳的联系方式是：

• 通过 Discord 联系开发者。
• 使用插件的 讨论区 选项卡。

感谢 @Filmjolk 制作的精美插件图标！