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.

• Create region-based mines with weighted block compositions.

• Reset mines based on time or remaining block percentage.

• Control access with permissions and tool Efficiency requirements.

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

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