rBoersX

How it works

1. A player places a drill. A frame shows the mining area.
2. The player puts coal into the fuel menu or buys time with coins.
3. The player starts the drill with a button in the menu.
4. The drill mines the area layer by layer and stores the loot.
5. The player takes the loot from the storage menu.

Drills

Drill	Area	Depth	Speed	Perks
Iron	3x3	16 layers	1 block per 2 s	Removes water and lava
Gold	5x5	32 layers	1 block per 1.5 s	Smelts ore into ingots
Diamond	7x7	64 layers	1 block per 0.5 s	Fortune II
Netherite	9x9	128 layers	11 blocks per 0.25 s	Fortune III, smelting, half the fuel

No limit on the number of drill types. You set the area, depth, speed, fortune, silk touch and smelting of every drill in items.yml.

Features

• 4 drills: from 3x3 and 16 layers to 9x9 and 128 layers.
• A drill keeps working while the owner is away.
• Loot goes into the drill's own storage.
• A "What to mine" menu: the player toggles 59 block types.
• The area sits around the drill or in front of it.
• Fortune, silk touch and smelting ore into ingots.
• Fuel: coal, coal blocks, blaze rods, dried kelp blocks.
• Time for coins through Vault, BVault, CoinsEngine or PlayerPoints.
• A colored area frame, visible through blocks.
• A hologram above the drill: status, fuel, progress, storage.
• A message to the owner when a drill stops.
• 3 drills per player, no overlapping areas, no mining in foreign WorldGuard claims.
• SQLite or MySQL, Folia support.

Requirements

Server	Java	Required plugins	Optional plugins
Paper 1.21.4+ or Folia	21	packetevents	Vault, BVault, CoinsEngine or PlayerPoints for buying time. WorldGuard. FancyHolograms or DecentHolograms

Commands

Command	What it does
/boer give [player] [drill] [amount]	Gives a drill, the drill number comes from items.yml
/boer admins list [player]	Shows a player's drills, a click teleports to the drill
/boer admins remove [player] [number]	Removes a drill, storage and fuel drop next to it
/boer admins fuel [player] [minutes]	Adds work time to all drills of a player
/boer admins stop [player or all]	Stops the drills of a player or of the whole server
/boer reload	Reloads the configs
/boer help	Shows the command list

Full command: /rboersx. Aliases: /boer, /bur.

Permissions

Permission	What it gives	Default
rboersx.use	Placing and using drills	Everyone
rboersx.limit.bypass	No drill limit per player	Operators
rboersx.admin	Every admin command	Operators

Good to know

• The plugin sends anonymous usage statistics to bStats. Set metrics: false in config.yml to turn it off.
• The plugin checks for a new version and reports it in the console. Set update-check: false in config.yml to turn it off.
• Item names, lore and messages in the default configs are in Russian. You translate them in the config files.

items.yml

# Area frame: corner posts joined by thin edges at the bottom and top.
border:
  thickness: 0.06 # edge thickness in blocks, 0.02-1.0
  corner-size: 0.16 # corner post thickness
  corner-height: 1.0 # corner post height
  y-offset: 0.01 # frame offset from the bottom of the drill block
  glow: true # colored frame glow, visible through blocks

# The drill number is the ID for /boer give [player] [drill].
list:
  1:
    level: 1 # tier shown in the menu and lore
    name: "<#C9B99A>Iron drill"
    block: IRON_BLOCK # drill block, solid and without gravity
    radius: 1 # area radius: 1 gives a 3x3 square, 0-32
    depth: 16 # layers mined downward, 1-512
    interval-ticks: 40 # pause between cycles, 20 ticks = 1 second, 5 at least
    blocks-per-cycle: 1 # blocks broken per cycle, 1-64
    storage-limit: 0 # storage capacity, 0 removes the cap
    max-fuel-minutes: 120 # bought time a drill stores, in minutes
    fuel-multiplier: 1.0 # fuel use: 0.5 burns half, 2.0 burns double
    fortune: 0 # fortune level, 0-10
    silk-touch: false # silk touch, turns fortune off
    auto-smelt: false # smelting by the smelt table in blocks.yml
    remove-liquids: true # removes water, lava, fire and powder snow in the area
    border:
      material: WHITE_CONCRETE # frame block
      glow-color: "#C9B99A" # frame glow color
    item:
      glow: false # enchantment glint on the item
      model-data: 0 # CustomModelData for a resource pack
      # {size}: area side, {depth}: depth, {speed}: blocks per minute, {fuel}: bought time
      name: "{name} <gray>[<#7FC4B8>{level} LvL<gray>]"
      lore:
        - " <#C9B99A>▌ <white>Area: <#C9B99A>{size}x{size}"
        - " <#C9B99A>▌ <white>Depth: <#C9B99A>{depth} layers"
  # Drills 2, 3 and 4 follow the same format: gold, diamond, netherite.

fuel.yml

# Item: seconds of work from one piece.
items:
  COAL: 60
  CHARCOAL: 60
  COAL_BLOCK: 540
  DRIED_KELP_BLOCK: 150
  BLAZE_ROD: 120

# Buying work time with coins.
money:
  enabled: true # turns buying on
  provider: VAULT # VAULT, BVAULT, COINSENGINE, PLAYERPOINTS
  currency: money # COINSENGINE: currency ID. BVAULT: account name. VAULT and PLAYERPOINTS ignore this field
  price-per-minute: 50 # price of one minute. Minutes per button are set in menus/fuel.yml

config-version: 1 # internal field, leave it as is

blocks.yml

skip-blocks: [ BUDDING_AMETHYST, REINFORCED_DEEPSLATE, END_PORTAL_FRAME ] # the drill never breaks these

smelt: # what the loot turns into on drills with auto-smelt: true
  RAW_IRON: IRON_INGOT
  RAW_GOLD: GOLD_INGOT
  RAW_COPPER: COPPER_INGOT
  ANCIENT_DEBRIS: NETHERITE_SCRAP
  COBBLESTONE: STONE
  COBBLED_DEEPSLATE: DEEPSLATE

# Blocks in the "What to mine" menu. Line order sets the menu order.
# Blocks outside the list share one "Other blocks" button.
list:
  - STONE
  - DEEPSLATE
  - COAL_ORE
  - IRON_ORE
  - DIAMOND_ORE
  - ANCIENT_DEBRIS
  # the default file lists 59 blocks: stones, dirt, ores, Nether and End blocks

config-version: 1 # internal field, leave it as is

config.yml

settings:
  debug: false # detailed console messages for troubleshooting
  metrics: true # anonymous bStats statistics
  update-check: true # console message about a new plugin version

command:
  main: rboersx # main command name
  aliases: [ boer, bur ] # extra command names

limits:
  per-player: 3 # drills per player, rboersx.limit.bypass removes the limit
  allow-overlap: false # true: areas of different drills overlap
  pickup: OWNER # who breaks and picks up a drill: OWNER only the owner, ANYONE any player

worlds:
  mode: BLACKLIST # BLACKLIST: drills banned in listed worlds. WHITELIST: allowed only there
  list: []

# Server load. 20 ticks = 1 second. Longer intervals and a smaller radius mean less load.
performance:
  autosave-seconds: 60 # how often fuel, storage and progress go to the database, 10 at least
  max-scan-per-cycle: 64 # positions a drill checks per cycle while looking for a block, 1-1024
  menu-refresh-ticks: 20 # refresh rate of an open drill menu, 5 at least
  border-view-radius: 48 # distance from which a player sees the frame, 8-128 blocks
  border-update-ticks: 20 # how often the plugin checks who sees a frame, 5 at least
  hologram-update-ticks: 20 # refresh rate of hologram text, 10 at least

sounds:
  click: # menu button click, an empty key turns the sound off
    key: "minecraft:ui.button.click"
    volume: 0.5
    pitch: 1.0
  break: # block break sound, volume: 0 turns it off
    volume: 0.6
    pitch: 1.0

config-version: 1 # internal field, leave it as is

holograms.yml

# Hologram above the drill. Requires FancyHolograms or DecentHolograms.
# Text refreshes only on drills with players nearby.
enabled: true
height: 0.6 # blocks above the drill
only-running: false # true: holograms only on running drills

style: # appearance, works with FancyHolograms only
  scale: 1.0 # text size, 0.1-20
  billboard: CENTER # CENTER: always faces the player. VERTICAL, HORIZONTAL, FIXED
  alignment: CENTER # line alignment: CENTER, LEFT, RIGHT
  background: transparent # default, transparent, #RRGGBB or #AARRGGBB
  text-shadow: true # text shadow
  see-through: false # true: text visible through blocks
  brightness: -1 # brightness 0-15, -1 takes the surrounding light
  visibility-distance: -1 # view distance, -1 takes the FancyHolograms value

# Placeholders: {name}, {level}, {owner}, {status}, {fuel}, {progress}, {mined}, {stored},
# {size}, {depth}, {speed}, {x}, {y}, {z}
lines:
  running: # text of a running drill
    - "{name} <gray>tier {level}"
    - "<gray>{owner}"
    - "{status} <dark_gray>• <white>{progress}%"
    - "<gray>Fuel <#D9A26B>{fuel}"
    - "<gray>Storage <#7FC4B8>{stored}"
  stopped: # text of a stopped drill, an empty list reuses the running text
    - "{name} <gray>tier {level}"
    - "{status}"

config-version: 1 # internal field, leave it as is