Mines
A clean, modern Mines plugin for Paper servers
A clean, modern Mines plugin for Paper servers
If you want a Mines plugin that feels smooth in game without turning into a mess to manage, that is exactly what this is for.
Mines gives players a simple 5x5 GUI-based gambling game with Vault support, configurable limits, persistent stats, live reloads, and a cleaner overall look than the usual thrown-together casino plugins.
The board is generated server-side when the round starts, payouts are based on real survival odds with a configurable house edge, and the plugin stays easy to work with even after you start customizing it.
Screenshots
PlaceholderAPI
If PlaceholderAPI is installed, NotMines registers the
%notmines_...% placeholder set automatically.Player stat placeholders:
%notmines_games%%notmines_wins%%notmines_losses%%notmines_tiles_cleared%%notmines_win_rate%%notmines_total_wagered%%notmines_total_paid%%notmines_profit%%notmines_best_cashout%%notmines_biggest_bet%
For leaderboard plugins such as Topper, use the raw numeric variants for money values so sorting stays numeric instead of lexicographic.
Raw numeric placeholders:
%notmines_total_wagered_raw%%notmines_total_paid_raw%%notmines_profit_raw%%notmines_best_cashout_raw%%notmines_biggest_bet_raw%
If you want integer minor-unit values instead, these are also available.
Minor-unit placeholders:
%notmines_total_wagered_minor%%notmines_total_paid_minor%%notmines_profit_minor%%notmines_best_cashout_minor%%notmines_biggest_bet_minor%
Features
- Clean 5x5 Mines GUI
- Vault economy support for bets and payouts
- Compact number support like 1k, 1.1k, 1m, 1.4m, and 1b
- Configurable minimum and maximum bet limits
- Configurable minimum and maximum mine counts
- Admin commands to change limits in game
- Runtime /mines reload support for config, messages, and GUI files
- Global announcements for big wins above a configurable multiplier
- Persistent player stats stored in SQLite
- Pending stats journal to better survive reloads and shutdowns
- Mine reveal after cashout or loss
- Server-side board generation with SecureRandom
- Customizable GUI title, items, lore, and chat messages
Commands
- /mines <bet> <mines> - Start a new board
- /mines cashout - Cash out your current board
- /mines reopen - Reopen your active board
- /mines stats [player] - View your own stats or another player's stats
- /mines limits - View the live limits
- /mines limits <min-bet|max-bet|min-mines|max-mines> <value> - Change limits in game
- /mines reload - Reload config, messages, and GUI files
Permissions
- notmines.use - Allows players to use Mines and view their own stats
- notmines.stats.others - Allows viewing stats for other players
- notmines.admin - Allows limit changes and runtime reloads
Requirements
- Paper server
- Java 21
- Vault
- Any Vault-compatible economy plugin
This plugin is built against the Paper 1.20.6 API as a baseline target, but it is intended for use on modern stable Paper versions as well.
Config Notes
- Bet limits support plain values or short formats like 100, 1k, 1m, and 2b
- The house edge is configurable
- Big-win broadcasts can be enabled or disabled
- The announcement threshold multiplier is configurable
- GUI text and chat messages can be edited separately
A Few Small Details That Matter
- Closing the menu does not throw the round away
- Players can reopen active games at any time
- Active games cash out safely on disconnect or shutdown
- Mine locations are shown after the round ends, so players can immediately see the board they were playing
One of the only mines gambling plugins and its open source.
