SuperMines
SuperMines 是一款适用于 Paper 服务器的免费开源挖矿插件。它结合了自动重置、基于规则的生成以及游戏内管理功能,旨在减少运营矿场时的重复性劳动。
简体中文链接:
QQ交流群(For Chinese):1107921027
Discord:
其他插件的痛点
- 有限的生成规则:许多矿洞设置仍然围绕“方块与百分比池”展开,难以表达基于地表、高度、边界、内部或生物群系的放置逻辑。
- 重度配置管理:添加方块、更改权重或编辑矿洞通常意味着需要修改 YAML 文件并重新加载插件。
- 功能分散于多个插件:自动拾取、挖矿进度、宝藏奖励和独立重生点等功能往往由不同插件分别处理,导致配置和权限管理分散。
- 仅支持全矿重置:定时重置整个选区无法很好地覆盖独立矿石、资源点或不同的重生时间表。
- 扩展点有限:缺乏可组合的条件和生命周期事件,使得自定义玩法的对接或其他插件安全地交互矿洞操作变得更加困难。
SuperMines 的亮点
-
2 种矿脉形状:长方体选择区域与球形挖掘,均可按可配置的时间间隔重置。
-
8 种生成条件:地表、相对 Y 坐标、边界、生物群系、占位符,以及 AND、OR 和 NOT 组合逻辑。
-
独立可再生节点:每个节点拥有独立的计时器、加权方块池、持久化倒计时,以及独立的 0-100% 宝藏掉落概率。
-
游戏内管理:使用 GUI 管理矿脉、方块权重、生成条件、宝藏、等级和再生点。
-
更流畅的挖矿循环:支持按矿脉和按玩家的自动拾取、基于方块的进度系统,以及可选的 mcMMO / AuraSkills 经验值获取。
-
4 种自定义方块平台:ItemsAdder、Oraxen、Nexo 和 CraftEngine。
变量
[参数] 表示可选参数
<参数> 表示必需参数
PlaceholderAPI
| 占位符 |
返回值 |
%supermines_bestrank[_player]% |
最高排名的显示名称;省略 player 时使用当前玩家 |
%supermines_biggestranklevel[_player]% |
最高排名等级;省略 player 时使用当前玩家 |
%supermines_minedblocks[_player]% |
玩家已挖掘的方块总数;省略 player 时使用当前玩家 |
%supermines_hasrank_<rank_id>[_player]% |
玩家是否拥有该排名,返回 true 或 false |
%supermines_treasures_got_<treasure_id>[_player]% |
指定宝藏被获取的次数;省略 player 时使用当前玩家 |
%supermines_regenpoints_mined_<point_id>[_player]% |
玩家在指定重生点当前奖励周期内挖掘的方块数;省略 player 时使用当前玩家 |
%supermines_regenpoints_total_mined_<point_id>[_player]% |
玩家在指定重生点累计挖掘的方块总数;省略 player 时使用当前玩家 |
%supermines_regenpoints_resettime_%<point_id>% |
格式化后的重生点重置时间,或在就绪时显示的本地化生成状态 |
| %supermines_mine_<mine_id>_<type>% | 矿区的运行时数据;参见下方的类型表 |
MiniPlaceholders
| 占位符 |
返回值 |
<supermines_bestrank[:player]> |
最高排名的显示名称;当省略 player 时使用当前玩家 |
<supermines_biggestranklevel[:player]> |
最高排名等级;当省略 player 时使用当前玩家 |
<supermines_minedblocks[:player]> |
玩家的总挖掘方块数;当省略 player 时使用当前玩家 |
<supermines_hasrank:<rank_id>[:player]> |
玩家是否拥有该排名,返回 true 或 false |
<supermines_treasures_got:<treasure_id>[:player]> |
获取指定宝藏的次数;当省略 player 时使用当前玩家 |
<supermines_regenpoints_mined:<point_id>[:player]> |
玩家在当前奖励周期内于指定重生点挖掘的方块数;当省略 player 时使用当前玩家 |
<supermines_regenpoints_total_mined:<point_id>[:player]> |
玩家在指定重生点的总挖掘方块数;当省略 player 时使用当前玩家 |
<supermines_regenpoints_resettime:<point_id>> |
格式化后的重生点重置时间,或当其就绪时的本地化生成状态 |
<supermines_mine:<mine_id>:<type>> |
矿区的运行时数据;见下方的类型表 |
矿区变量类型
| 类型 |
返回值 |
blocksbroken |
当前重置周期内挖掘的方块数 |
resettime |
格式化后的下次重置时间 |
blockpercent |
矿区中剩余方块的百分比 |
minedpercent |
已挖掘的矿区百分比 |
totalblocks |
矿区中的方块总数 |
如果矿区不存在,结果为 MINE_NOT_FOUND。
无效的类型将返回 INVALID_ARGUMENT。
如果重生点不存在,结果为 REGEN_POINT_NOT_FOUND。
接下来做什么
截图
命令帮助

长方体矿区

球形矿区

边界条件:核心
下面显示的铁矿石被限制在矿区内部。

API
请参阅 API 类
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
<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
评论 0
登录后参与评分
还没有评论,来抢沙发吧