RoodyMines v1.6.2 is outSee what’s new →
⛏️

RoodyMines

RoodyMines creates mines that refill themselves with the blocks you choose: by time, by percentage or block by block. Everything — block mix, layers, drops, rewards, holograms — is edited from menus with /rm editar.

Commands, permissions and default messages are in Spanish. Every text can be changed in messages.yml.

Installation

License: after the first start, paste your key (from My account) in plugins/RoodyMines/license.yml and restart. Without a valid key the plugin does not start. Once checked, it keeps working for 14 days offline.

Updates: when a new version is out, the console says so and ops (permission roodymines.update) get a message with the download link when they join. Turn it off with avisar-actualizaciones: false in config.yml.

  1. Put RoodyMines-<version>.jar in your plugins/ folder and restart.
  2. Optional: WorldEdit or FastAsyncWorldEdit (use their selection), WorldGuard (automatic region per mine), PlaceholderAPI and Vault (money rewards).
  3. /rm varita, mark two corners and /rm crear <id>.

Works on Paper (and forks such as Purpur) from 1.20.4 to 1.21.x with the same jar.

Creating a mine

  1. /rm varita — left click = corner 1, right click = corner 2 (or /rm pos1 and /rm pos2, or your WorldEdit selection).
  2. /rm crear <id> — creates the mine and fills it. Mines cannot overlap.
  3. /rm editar <id> — opens the editor: blocks, reset mode, layers, drops, rewards, hologram, warnings…

In every menu: Q = type the value in chat, Ctrl + Q = remove it. Weights and percentages accept decimals (0.5, 0.25, 0.01…).

Reset modes

Mode What it does
tiempo Refills completely every X seconds.
porcentaje Refills when less than X % of the blocks are left.
ambos Whichever comes first.
regeneracion Each mined block turns into another one (bedrock by default) and the ore comes back after X seconds. Nobody is teleported and the mine never empties.
manual Only with /rm reset.

Before a reset, players inside are moved out (to the mine's teleport point or on top) and warned beforehand.

Layers, drops and rewards

  • Layers: rows with their own blocks (altura counts from the bottom, so moving the mine keeps them in place).
  • Drops: with vanilla: false only your custom drops fall; Fortune multiplies them like vanilla ores. Auto-pickup (XP too) and auto-smelt per mine.
  • Rewards by chance on every block, or every X blocks a player mines: commands, money (Vault), items, message, broadcast and sound. Create and test them from the menu (Dar ahora gives it to you).
recompensas:
  - { probabilidad: 1, comandos: ["crates key give {jugador} mina 1"], mensaje: "&aYou found a key!" }
  - { probabilidad: 100, bloques: [DIAMOND_ORE], dinero: 50 }
  - { cada: 1000, anuncio: "&e{jugador} &7has mined &f{cantidad} &7blocks in {mina-nombre}&7.", items: ["DIAMOND 5"] }

Reward variables: {jugador} (player) {mina} {mina-nombre} {bloque} {cantidad} (amount).

Holograms and bars

Text displays (no hologram plugin needed) on top of the mine and/or in the centre of each side (north, south, east, west), plus a custom spot. Edit the lines with a live preview, the height, the offset and the background (normal, ninguno = none, #RRGGBB). Inside the mine, a boss bar and action bar show its status.

Commands

/roodymines or /rm. Admin commands need roodymines.admin.

Command What it does
/rm varita · /rm pos1 · /rm pos2 Mark the area.
/rm crear <id> [x1 y1 z1 x2 y2 z2 [world]] Create (also from the console with coordinates).
/rm redefinir <id> [coords] Same mine, new area.
/rm editar [id] Menu editor (no id: list of mines).
/rm lista · /rm info <id> List / inspect mines.
/rm reset <id|todas> Reset now (todas = all).
/rm parar <id> · /rm activar <id> Stop / resume automatic resets.
/rm bloque <id> <block> <weight> Block in the mix (weight 0 = remove).
/rm modo <id> <tiempo|porcentaje|ambos|regeneracion|manual> Reset mode.
/rm tiempo <id> <s> · /rm porcentaje <id> <n> Interval / threshold.
/rm settp <id> · /rm tp <id> Set the mine's teleport point / go there.
/rm holo <id> [aqui|quitar|on|off] Hologram. lugares, altura, separacion, fondo to adjust it.
/rm nombre <id> <text> Display name (the id does not change).
/rm region <id> [on|off] That mine's WorldGuard region.
/rm top [mine|total] · /rm stats [player] Tops and stats.
/rm borrar <id> Delete (type it twice). The blocks stay.
/rm recargar Reload the files.

Permissions

Permission Default Grants
roodymines.admin op All admin commands.
roodymines.bypass op Ignore mine permission, entry and efficiency rules.
roodymines.tp op /rm tp.
roodymines.top · roodymines.stats everyone Tops and stats.

Each mine can require its own permission to mine and, optionally, to enter.

Placeholders

In holograms, bars and messages: {nombre} {id} {estado} {tiempo} {segundos} {porcentaje} {restantes} {total} {minados} {modo}.

PlaceholderAPI Value
%roodymines_<mine>_<field>% nombre, estado, tiempo, segundos, porcentaje, restantes, total, minados, modo
%roodymines_jugador_<mine|total>% Blocks mined by the player
%roodymines_top_<mine|total>_<position>_<nombre|valor>% Tops (name / value)

WorldGuard

With WorldGuard installed, each mine gets a region roodymines-<mine> exactly its size with block-break: allow, so players can mine even when the mine sits inside a protected spawn. It is created, moved and removed with the mine. Turn it off globally with worldguard.activado: false or per mine with /rm region <mine> off.

Physics

Under ajustes (all false by default): bloques-caen (sand and gravel do not fall), hielo-deja-agua (broken ice leaves no water) and bloques-cambian-solos (nothing melts, grows or spreads inside the mine). Blocks outside the mine are not affected.

Files

  • config.yml — general settings, hologram, bars and defaults for new mines.
  • messages.yml — every text.
  • mines/<id>.yml — one mine per file, with comments.
  • stats.yml — statistics (saved every 5 minutes and on shutdown).