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 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 Develeper 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.
| Command | Permission | Description |
|---|---|---|
/sm |
simplymines.admin |
Opens the main mine browser GUI to edit all mines. |
/sm tool |
simplymines.tool |
Toggles your selection wand (Wooden Hoe) on/off. |
/sm create <name> |
simplymines.create |
Creates a new mine from your current wand selection. |
/sm edit <name> |
simplymines.admin |
Opens the mine editor GUI directly for a mine. |
/sm reset <name> |
simplymines.reset |
Force-resets a specific mine immediately. |
/sm reassign <name> |
simplymines.move |
Moves an existing mine's region to your current selection. |
/sm rename <old> <new> |
simplymines.rename |
Renames a mine. |
/sm save <name> |
simplymines.save |
Force-saves a mine to disk immediately. |
/sm setteleport <name> |
simplymines.setteleport |
Sets the mine's reset teleport point to your exact location. |
/sm teleport <name> |
simplymines.teleport |
Teleports you to the mine's designated teleport point. |
/sm disable <name> |
simplymines.disable |
Disables the automatic reset timer for a mine. |
/sm enable <name> |
simplymines.enable |
Re-enables the automatic reset timer for a mine. |
/sm delete <name> |
simplymines.delete |
Permanently deletes a mine and removes its JSON file. |
/sm reload |
simplymines.reload |
Reloads the config, reloads mines from disk, and clears the workload queue. |
Note: To actually use the selection wand to mark corners, players/admins must have the
simplymines.selectpermission.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).
| Placeholder | Description |
|---|---|
%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.
| Placeholder | Description |
|---|---|
%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
| Placeholder | Description |
|---|---|
%simplymines_count% |
Total number of mines |
%simplymines_count_enabled% |
Number of currently enabled mines |
