Mines

A clean, modern Mines plugin for Paper servers.

If you want a Mines plugin that feels smooth in game without turning into a headache to manage, that is what this is built for.

Mines gives players a simple 5x5 GUI-based gambling game with Vault support, configurable limits, persistent stats, live reloads, and a cleaner overall feel 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:

• %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:

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