⛏️ SimplyMines | ️ SkyMines | Prison | Mines

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
  - 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 and tool Efficiency requirements.
  
  
  
• 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.
  
  
• Fortune support — fortune enchantment affects mine block drop rates.
  
  
• Store mine data in JSON, MySQL, or SQL
  
  
• 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.


/sm
Permission: simplymines.admin
Opens the main Mine Browser GUI, allowing you to view and manage all mines.

/sm tool
Permission: simplymines.tool
Toggles your selection wand ( Wooden Hoe) on or off.

/sm create <name>
Permission: simplymines.create
Creates a new mine using your current selection.

/sm edit <name>
Permission: simplymines.admin
Opens the Mine Editor GUI for the specified mine.

/sm reset <name>
Permission: simplymines.reset
Immediately resets the specified mine.

/sm reassign <name>
Permission: simplymines.move
Moves an existing mine to your current selection region.

/sm rename <old> <new>
Permission: simplymines.rename
Renames an existing mine.

/sm save <name>
Permission: simplymines.save
Forces a mine to be saved to disk immediately.

/sm setteleport <name>
Permission: simplymines.setteleport
Sets the mine's teleport location to your current position.

/sm teleport <name>
Permission: simplymines.teleport
Teleports you to the mine's configured teleport location.

/sm disable <name>
Permission: simplymines.disable
Disables automatic resets for the specified mine.

/sm enable <name>
Permission: simplymines.enable
Re-enables automatic resets for the specified mine.

/sm delete <name>
Permission: simplymines.delete
Permanently deletes the mine and removes its saved file.

/sm reload
Permission: simplymines.reload
Reloads the configuration, reloads all mines from disk, and clears the workload queue.

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.


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).

%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 seconds
%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.
%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
%simplymines_count% - Total number of mines
%simplymines_count_enabled% - Number of currently enabled mines