Sueta

SimplyMines

1.2.2

SimplyMines is a plugin for SkyMines and Prison servers that automatically resets mines via an easy-to-use GUI, custom block chances, and smooth, lag-friendly resets.

·Plugin

banner

SimplyMines ⛏️

ALL-IN ONE MINE PLUGIN

Supported Minecraft Versions: 1.21-26.2

DISCORD | WIKI | GITHUB

Getting started:

  • To start make sure your tool is enabled /sm tool
  • Now make a selection
  • Use /sm create <name>
  • Then edit the mine with /sm edit <name>

Then follow Quick Start.

Core features:

  • It supports both vanilla blocks and custom blocks.
    Nexo | ItemsAdder | CraftEngine

  • Mine setup and changes can be handled through an in-game GUI, including left-click block editing straight from the editor.

  • Create region-based mines with weighted block compositions.

  • Reset mines based on time or remaining block percentage, or use replace mode to only refill mined-out air blocks instead of resetting the whole region.

  • Control access with permissions, tool Efficiency, or Min Enchantments — require several enchantments at set levels (e.g. Fortune III, Unbreaking III, Efficiency III).

  • Set custom drops per mine, independent of a block's vanilla loot table.

  • Trigger actions on block break — money, items, commands, or permissions — with an option to disable normal drops so actions fully replace them.

  • Auto pickup sends mined blocks straight to the player's inventory.

  • Auto smelt smelts drops like a furnace (ores to ingots, etc.), with an exclusion list in config.yml. Both perks are per-mine settings gated by sm.use.autopickup and sm.use.autosmelt.

  • Fortune support — the Fortune enchantment multiplies custom mine drops.

  • Store mine data in JSON, SQLite, or MySQL.

  • Translatable — every message and menu lives in lang/<name>.yml.

  • Extend functionality with PlaceholderAPI.

  • In depth Developer API support.

  • Resets are designed to avoid blocking server ticks by using a workload queue.


Commands & Permissions

Manage everything on the fly with our comprehensive command system.

CommandPermissionDescription
/smsimplymines.adminOpens the main mine browser GUI to edit all mines.
/sm toolsimplymines.toolToggles your selection wand (Wooden Hoe) on/off.
/sm create <name>simplymines.createCreates a new mine from your current wand selection.
/sm edit <name>simplymines.adminOpens the mine editor GUI directly for a mine.
/sm reset <name>simplymines.resetForce-resets a specific mine immediately.
/sm reassign <name>simplymines.moveMoves an existing mine's region to your current selection.
/sm rename <old> <new>simplymines.renameRenames a mine.
/sm save <name>simplymines.saveForce-saves a mine immediately.
/sm setteleport <name>simplymines.setteleportSets the mine's reset teleport point to your exact location.
/sm teleport <name>simplymines.teleportTeleports you to the mine's designated teleport point.
/sm disable <name>simplymines.disableDisables the automatic reset timer for a mine.
/sm enable <name>simplymines.enableRe-enables the automatic reset timer for a mine.
/sm delete <name>simplymines.deletePermanently deletes a mine.
/sm reloadsimplymines.reloadReloads the config, reloads mines, and clears the workload queue.
/sm versionsimplymines.versionShows the running version and checks for updates.

Note: To actually use the selection wand to mark corners, players/admins must have the simplymines.select permission.

Note: /sm teleport <mine> also supports a per-mine permission — simplymines.teleport.<mine> — so you can restrict who can teleport to which mine individually.

Note: Staff with simplymines.update-notify are told in chat when an update is available.

Mining perk permissions

These decide which players get a mine's perks. The perk must also be switched on in the mine's settings.

PermissionDescription
sm.use.autopickupDrops go straight into the inventory in mines with Auto Pickup enabled. (enabled by default)
sm.use.autosmeltDrops are smelted in mines with Auto Smelt enabled. (enabled by default)

PlaceholderAPI Support

SimplyMines includes full PlaceholderAPI integration, making it easy to display mine information in scoreboards, tab lists, holograms, GUIs, and chat formats.

Per-Mine Placeholders

Replace <mine> with the exact mine name (case-insensitive).

PlaceholderDescription
%simplymines_<mine>_timeleft%Raw seconds until the next reset (e.g. 142)
%simplymines_<mine>_timeleft_formatted%Formatted as mm:ss (e.g. 02:22)
%simplymines_<mine>_timeleft_hms%Formatted as h:mm:ss for longer timers (e.g. 1:02:22)
%simplymines_<mine>_resettime%Configured reset interval in seconds
%simplymines_<mine>_enabled%Returns true or false
%simplymines_<mine>_status%Returns Enabled or Disabled
%simplymines_<mine>_warndistance%Configured warning distance in blocks
%simplymines_<mine>_blocks_broken%Total blocks broken in the mine since last reset
%simplymines_<mine>_blocks_count%Total block count of the mine region
%simplymines_<mine>_precent_left%Percentage of the mine still left (unmined), 2 decimal places

Current Mine Placeholders

These placeholders automatically use the mine the player is currently standing inside.

PlaceholderDescription
%simplymines_currentmine%Name of the current mine or None
%simplymines_currentmine_timeleft%Seconds remaining until reset
%simplymines_currentmine_timeleft_formatted%Remaining time formatted as mm:ss

Global Placeholders

PlaceholderDescription
%simplymines_count%Total number of mines
%simplymines_count_enabled%Number of currently enabled mines

Similar projects

Plugin →