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

!Main game board

!Cashout screen with mine reveal

!Stats button in gui

!Stats command output

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.