NotMines (nmines)

NotMines v1.1.0 — Compatibility & Polish

This release modernizes NotMines with wider Paper compatibility, refreshed interfaces, safer configuration updates, and additional customization.

Highlights

- Expanded compatibility target from Paper 1.20.x through 26.x - Refreshed the game, stats, and leaderboard interfaces - Reworked default messages with cleaner formatting and colors - Added configurable layered sounds for leaderboard navigation - Added automatic configuration versioning - Added a detailed startup banner with version and integration information - Improved comments throughout config.yml, messages.yml, and gui.yml

New Configuration

- Toggle bStats metrics - Toggle safe-pick chat messages - Toggle board-close reminders - Require both a minimum multiplier and payout for big-win announcements - Toggle big-win announcements in the console - Configure sounds for opening, filtering, paging, and closing the leaderboard - Use Bukkit sound names, namespaced sound keys, or custom resource-pack sounds

Fixes

- Configuration errors during startup now disable the plugin cleanly instead of leaving it partially enabled - Configuration migration and file-writing errors are now handled properly by /mines reload - Existing configuration values are preserved when new defaults and comments are added - Configurations newer than the bundled version now produce a warning instead of being silently downgraded - Sound loading no longer depends directly on version-specific Bukkit sound enums - Low-value wins can be excluded from global announcements - Release builds now consistently target Java 17 bytecode - Added tests for bundled YAML files, configuration versions, GUI materials, sounds, permissions, and the API baseline

Important Upgrade Notes

Public identifiers now use the shorter nmines namespace. Update permissions: - notmines.use → nmines.use - notmines.stats.others → nmines.stats.others - notmines.admin → nmines.admin Update PlaceholderAPI placeholders: - %notmines_*% → %nmines_*% Player statistics and customized configuration values are not reset by this update.

This update adds configurable sound effects to the Mines GUI to make rounds feel more responsive and satisfying. What's new: - Added sound cues when opening or reopening a board - Added reward sounds for safe tile reveals - Added negative feedback sounds for mine hits - Added payout sounds for cashouts - Added a bigger celebration sound for full-board clears - Added a slight pitch ramp on safe-pick streaks so repeated wins feel more rewarding - Added configurable sound settings in gui.yml, including layered sounds, volume, pitch, and delay-ticks - Updated the README to document the new sound system, /minestop leaderboard details, and automatic YAML key merging behavior Config: - GUI sounds can be enabled or disabled with sounds.enabled - Each event supports one or more sound layers: board-open safe-pick mine-hit cashout board-cleared Admins can retune the sound theme directly in plugins/NotMines/gui.yml without rebuilding the plugin.

Added

- Added /minestop, a new paginated mines leaderboard GUI. - Added player-head leaderboard entries, including support for showing heads while players are offline. - Added a hopper-based stat filter that cycles through leaderboard categories. - Added a personal summary card at the top of the leaderboard showing your own rank and value for the currently selected stat. - Added automatic merging for config.yml, gui.yml, and messages.yml so new update keys are inserted into existing files without overwriting server-specific settings.

Improved

- Improved leaderboard performance with cached sorted rankings per stat. - Improved offline head loading by using stored profile textures instead of offline-player lookups. - Improved leaderboard GUI feedback so the active hopper filter is clearly highlighted in the stat list. - Improved leaderboard click handling for better reliability with other inventory-related plugins. - Improved GUI fallback behavior so missing new config sections no longer prevent the plugin from starting.

Notes

- Existing configs should now update automatically when new defaults are added in future releases. - Players who had older stored stats may not immediately have offline head textures until they play a round on the updated version.

NotMines v1.0.1

This update adds PlaceholderAPI support and improves stats database startup reliability.

What's new

- Added PlaceholderAPI support with automatic %notmines_...% stat placeholders - Added raw numeric placeholder variants for leaderboard plugins like Topper - Improved SQLite startup handling with a safe fallback when WAL mode is unavailable

Notes

- PlaceholderAPI is optional and only hooks in when installed - For leaderboard sorting, use the raw placeholders such as %notmines_profit_raw%

First release with basic plugin with plenty of features.