SuperMines
SuperMines is a free, open-source mine plugin for Paper servers. It combines automatic resets, rule-based generation, and in-game management to reduce the repetitive work of running mines.
简体中文链接：https://www.minebbs.com/resources/supermines-folia-gui.17891/
QQ交流群（For Chinese）：1107921027
Discord：https://discord.gg/9YP2UaPZhE
Other Plugins' Pain Points
- Limited generation rules: many mine setups still revolve around a block-and-percentage pool, making it difficult to express surface, height, border, interior, or biome-based placement.
- Configuration-heavy management: adding blocks, changing weights, or editing a mine often means editing YAML and reloading the plugin.
- Features spread across multiple plugins: auto pickup, mining progression, treasure rewards, and individual respawn points are often handled separately, which spreads out configuration and permissions.
- Full-mine resets only: a scheduled reset of the whole selection does not cover independent ores, resource points, or different respawn schedules very well.
- Limited extension points: without combinable conditions and lifecycle events, it is harder to connect custom gameplay or let other plugins safely interact with mine operations.
SuperMines's Highlights
- 2 mine shapes: cuboid selections and spherical mines, both reset on a configurable schedule.
- 8 generation conditions: surface, relative mine Y, border, biome, placeholder, plus AND, OR, and NOT combinations.
- Independent regenerable points: each point has its own timer, weighted block pool, persisted countdown, and independent
0-100%treasure chances. - In-game management: use GUIs to manage mines, block weights, generation conditions, treasures, ranks, and regen points.
- A smoother mining loop: per-mine and per-player auto pickup, block-based progression, and optional mcMMO / AuraSkills XP.
- 4 custom-block platforms: ItemsAdder, Oraxen, Nexo, and CraftEngine.
Variables
[parameter]means an optional parameter<parameter>means a required parameter
PlaceholderAPI
| Placeholder | Returns |
|---|---|
%supermines_bestrank[_player]% |
The highest rank display name; uses the current player when player is omitted |
%supermines_biggestranklevel[_player]% |
The highest rank level; uses the current player when player is omitted |
%supermines_minedblocks[_player]% |
The player's total mined blocks; uses the current player when player is omitted |
%supermines_hasrank_<rank_id>[_player]% |
Whether the player has the rank, returning true or false |
%supermines_treasures_got_<treasure_id>[_player]% |
How many times the specified treasure has been obtained; uses the current player when player is omitted |
%supermines_regenpoints_mined_<point_id>[_player]% |
The player's blocks mined during the current reward cycle at the specified regen point; uses the current player when player is omitted |
%supermines_regenpoints_total_mined_<point_id>[_player]% |
The player's total blocks mined at the specified regen point; uses the current player when player is omitted |
%supermines_regenpoints_resettime_<point_id>% |
Formatted time until the regen point respawns, or the localized generated status when it is ready |
%supermines_mine_<mine_id>_<type>% |
Runtime data for a mine; see the type table below |
MiniPlaceholders
| Placeholder | Returns |
|---|---|
<supermines_bestrank[:player]> |
The highest rank display name; uses the current player when player is omitted |
<supermines_biggestranklevel[:player]> |
The highest rank level; uses the current player when player is omitted |
<supermines_minedblocks[:player]> |
The player's total mined blocks; uses the current player when player is omitted |
<supermines_hasrank:<rank_id>[:player]> |
Whether the player has the rank, returning true or false |
<supermines_treasures_got:<treasure_id>[:player]> |
How many times the specified treasure has been obtained; uses the current player when player is omitted |
<supermines_regenpoints_mined:<point_id>[:player]> |
The player's blocks mined during the current reward cycle at the specified regen point; uses the current player when player is omitted |
<supermines_regenpoints_total_mined:<point_id>[:player]> |
The player's total blocks mined at the specified regen point; uses the current player when player is omitted |
<supermines_regenpoints_resettime:<point_id>> |
Formatted time until the regen point respawns, or the localized generated status when it is ready |
<supermines_mine:<mine_id>:<type>> |
Runtime data for a mine; see the type table below |
Mine Variable Types
| Type | Returns |
|---|---|
blocksbroken |
Blocks mined during the current reset cycle |
resettime |
Formatted time until the next reset |
blockpercent |
Percentage of blocks remaining in the mine |
minedpercent |
Percentage of the mine that has been mined |
totalblocks |
Total blocks in the mine |
If the mine does not exist, the result is MINE_NOT_FOUND.
An invalid type returns INVALID_ARGUMENT.
If the regen point does not exist, the result is REGEN_POINT_NOT_FOUND.
What's Next
- Random mine events: lucky periods and double drops.
- Update checks.
Screenshots
Command Help
Cuboid Mine
Sphere Mine
Border Condition: Core
The iron ore shown below is restricted to the interior of the mine.
API
See the API class
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
SuperMines 1.6.15 1.6.15 |
26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
folia, paper, purpur
|
Download |
|
1.6.13 |
26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
folia, paper, purpur
|
Download |
|
1.6.12 |
26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
folia, paper, purpur
|
Download |
|
SuperMines 1.6.11 1.6.11 |
26.1, 26.1.1, 26.1.2, 26.2
|
folia, paper, purpur
|
Download |