NotMines

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.