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.

简体中文链接： QQ交流群（For Chinese）：1107921027 Discord： ## 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 > `` 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_[_player]%` | Whether the player has the rank, returning `true` or `false` | | `%supermines_treasures_got_[_player]%` | How many times the specified treasure has been obtained; uses the current player when `player` is omitted | | `%supermines_regenpoints_mined_[_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_[_player]%` | The player's total blocks mined at the specified regen point; uses the current player when `player` is omitted | | `%supermines_regenpoints_resettime_%` | Formatted time until the regen point respawns, or the localized generated status when it is ready | | `%supermines_mine__%` | Runtime data for a mine; see the type table below | ### MiniPlaceholders | Placeholder | Returns | |------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| | `` | The highest rank display name; uses the current player when `player` is omitted | | `` | The highest rank level; uses the current player when `player` is omitted | | `` | The player's total mined blocks; uses the current player when `player` is omitted | | `[:player]>` | Whether the player has the rank, returning `true` or `false` | | `[:player]>` | How many times the specified treasure has been obtained; uses the current player when `player` is omitted | | `[:player]>` | The player's blocks mined during the current reward cycle at the specified regen point; uses the current player when `player` is omitted | | `[:player]>` | The player's total blocks mined at the specified regen point; uses the current player when `player` is omitted | | `>` | Formatted time until the regen point respawns, or the localized generated status when it is ready | | `:>` | 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 ![/sm help command](https://cdn.modrinth.com/data/cached_images/fddfa69f572c1eae8a12c9c9f2647fec380f1c9d.png) ### Cuboid Mine ![cuboid mine in picture](https://raw.githubusercontent.com/LinsMinecraftStudio/SuperMines/refs/heads/main/media/cuboid_mine.png) ### Sphere Mine ![sphere mine in picture](https://raw.githubusercontent.com/LinsMinecraftStudio/SuperMines/refs/heads/main/media/sphere_mine.png) ### Border Condition: Core The iron ore shown below is restricted to the interior of the mine. ![iron ore is covered by coal ore](https://raw.githubusercontent.com/LinsMinecraftStudio/SuperMines/refs/heads/main/media/border_condition_core_in_mine.png) ## API See [the API class](https://github.com/LinsMinecraftStudio/SuperMines/blob/main/src/main/java/io/github/lijinhong11/supermines/api/SuperMinesAPI.java)

lijinhong11

Organizations