SimplyMines ⛏️

ALL-IN ONE MINE PLUGIN

Supported Minecraft Versions: 1.21-26.3

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.

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 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.
/sm reload	simplymines.reload	Reloads the config, reloads mines, and clears the workload queue.
/sm version	simplymines.version	Shows 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.

Permission	Description
sm.use.autopickup	Drops go straight into the inventory in mines with Auto Pickup enabled. (enabled by default)
sm.use.autosmelt	Drops 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).

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

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