Changelog:
• Fix! Fixed critical exploit allowing players to steal heads from coinflip GUI using shift+double-click - comprehensive multi-layer protection added
• Fix! Fixed GUI protection being lost when one player closes coinflip animation - remaining player's GUI is now fully protected even after opponent closes theirs
• Fix! Added InventoryDragEvent protection - prevents item dragging exploits in all plugin GUIs
• Fix! Added COLLECT_TO_CURSOR action blocking - prevents double-click from collecting items across inventories
• Fix! All click events now cancelled immediately at GUIManager level with HIGHEST priority as first line of defense
• Fix! Dangerous inventory actions (MOVE_TO_OTHER_INVENTORY, HOTBAR_SWAP, etc.) are now blocked in addition to click types
• Fix! Player cursor is now cleared after blocking dangerous clicks to ensure no items remain on cursor
• Fix! GUI handler and button map are now only unregistered/cleared when ALL viewers close the inventory, not just the first one
• Optimize! Updated core development libraries

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added support for 1.21.11
• Fix! Improved error messages for users - error messages now show your current balance and required amount for better clarity
• Fix! Enhanced error messages for currency restrictions - messages now explain why you cannot use a currency (permissions, world restrictions, etc.)
• Fix! Improved configuration error messages - console warnings now include file paths and suggestions for fixing configuration issues
• Fix! Better error recovery - invalid button amounts in GUI configs are now automatically fixed to default values instead of causing errors
• Fix! Enhanced null checks - added comprehensive null and validation checks for currency operations to prevent crashes
• Fix! Improved thread safety - currency withdraw and deposit operations now properly validate player state before processing
• Fix! Better error logging - all error messages now include [UltraCoinFlip] prefix and helpful context for easier debugging
• Fix! Configuration validation improvements - validation errors now provide clearer guidance on how to fix configuration issues
• Optimize! Error message formatting - error messages now use placeholders to show formatted amounts and balances for better readability

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Enhanced sound feedback system - added sounds for all game events and user interactions
• New! Added sound when joining a coinflip game - both players hear a sound when someone joins their game
• New! Added sound when game starts - exciting sound plays when coinflip animation begins
• New! Added sound for consecutive wins - special sound plays when players achieve consecutive wins
• New! Added error sounds - different sounds for insufficient balance, invalid amount, and general errors
• New! Added page change sounds - sound feedback when navigating through GUI pages
• New! Added heads/tails selection sounds - distinct sounds for selecting heads or tails
• New! Added input submit sound - sound plays when players submit amount via anvil or chat
• New! Added reload command sounds - success and error sounds for configuration reload
• Optimize! Improved sound experience - all sounds are now properly configured with appropriate volume and pitch for better audio feedback
• Fix! Sound configuration now properly preserves user settings when updating - existing sound configurations will not be lost during plugin updates

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Config cache now properly refreshes on reload - cached config values are automatically updated when using /cf reload command
• Optimize! Optimized config reading - cached frequently accessed config values (titles, actionbar, bossbar, refund settings, update checker)
• Optimize! Improved game finish performance - notification config values are now cached during GUI creation instead of being read from config file multiple times
• Optimize! Reduced config reads in hot paths
• Optimize! Optimized update checker - cached config values are automatically updated when using /cf reload command

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Fixed potential currency loss when joining a game fails - players will now always receive their currency back even if the game cannot be started
• Fix! Fixed plugin crashes when checking player balance - improved error handling to prevent server crashes when players disconnect during balance checks
• Fix! Fixed plugin crashes during config reload - improved cleanup process to prevent crashes when reloading the plugin configuration
• Fix! Fixed plugin crashes when sending update notifications - improved error handling to prevent crashes when notifying players about plugin updates
• Optimize! Overall stability - added multiple safety checks to prevent crashes in edge cases and improve plugin reliability

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added consecutive wins tracking system - tracks consecutive wins between player pairs
• New! Consecutive wins notifications
• New! Automatic reset system - consecutive wins counter resets when the previous loser wins against the previous winner
• New! Ordinal suffix support - notifications show "1st", "2nd", "3rd", etc. for consecutive wins

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Critical animation freeze bug - animation now continues running when one player closes GUI, only stops when both players close GUI. This prevents animation from freezing for the remaining player
• Fix! Critical GUI freeze bug when players press ESCAPE during animation
• Fix! GUI not closing properly after animation completes - GUI now closes automatically after showing winner for 3 seconds
• Optimize! Game now runs in background mode - closing GUI does NOT stop the game. Animation continues running even when both players close GUI, and both players will be notified via chat/title/sound when the game completes. Players can freely close/open GUI without affecting game completion
• Optimize! Cleanup reliability
• Optimize! Enhanced ESCAPE key handling during animation

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Fixed plugin crash when displaying coinflip games from offline players - plugin no longer crashes if player name cannot be retrieved
• Fix! Fixed plugin crash when reloading config with invalid language settings - plugin now safely handles null or invalid language values
• Fix! Fixed potential crashes during config reload - added safety checks to prevent plugin from crashing when config values are missing or corrupted

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! NullPointerException when config is null
• Fix! Language not updating correctly

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Missing UUID validation in MySQLDatabaseManager
• Fix! Potential memory leak in animation system
• Optimize! Improved race condition handling in CoinFlipManager
• Optimize! Gson instance creatio
• Optimize! Improved SQL query construction
• Optimize! Cached additional config values in CoinFlipRollGUI

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Fixed memory leak in animation tasks
• Fix! Fixed race condition in game creation
• Fix! Fixed potential NullPointerException in animation schedule
• Optimize! Reduced ItemStack cloning overhead
• Optimize! Cached config values in HeadsTailsSelectionGUI
• Optimize! Improved animation task scheduling
• Optimize! Reduced memory usage in animation system

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added heads/tails selection feature - players can now choose heads or tails before creating a coinflip game (enable in config.yml: heads-tails.enabled)
• New! Customizable heads/tails selection GUI - fully customizable through heads-tails.yml config file
• New! Heads/tails selection works with both command (/cf create) and GUI create button
• New! Support for Minecraft 1.8.8 - 1.21.10 and Java 8+
• New! 4 animation types: default (left-to-right), slot-machine, circular, and vertical
• New! 8 border animation effects: rainbow, pulse, wave, gradient, fade, random, sequence, basic
• New! Customizable animation settings (speed, direction, colors, etc.)
• New! Auto-fix corrupted language files - plugin automatically restores broken language files from backup
• Fix! Mojang API warnings in console - reduced API calls when loading player heads
• Fix! Italian language file errors - automatically updates to working version
• Fix! Animation display issues - all animation types now show correctly
• Fix! Players taking items from GUI - all slots are now protected
• Fix! GUI not closing after animation - closes automatically when game ends
• Fix! Game state issues after reload - active games are properly cleaned up
• Fix! PlaceholderAPI currency detection
• Fix! Critical bug where currency was withdrawn before heads/tails selection - currency is now only withdrawn after player confirms their choice
• Fix! Added validation checks in heads/tails GUI to prevent issues when player changes world or balance changes
• Optimize! Improved player head loading - faster and fewer API calls
• Optimize! Improved animation performance - each animation type works independently
• Optimize! Improved border effects - pulse, sequence, and fade now have unique visual styles (not rainbow)
• Optimize! Increased animation speeds - pulse, sequence, and fade are now 3x faster

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added Italian language support (it) - added messages_it.yml language file
• New! Added batch database operations
• New! Potential issue with duplicate calls
• Fix! Async task overhead - offline winner and loser stats updates are now combined into single async task
• Fix! Removed unused OfflinePlayer import in TaxRateCalculator
• Fix! Removed unused Date import in CoinFlipHistoryGUI
• Optimize! Tax bypass permission check
• Optimize! Removed redundant tax rate clamping in CoinFlipRollGUI

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added tax bypass permission (ultracoinflip.bypass.tax) - players with this permission receive full winnings without tax deduction
• New! Split Chinese language into Chinese Simplified (zh_cn) and Chinese Traditional (zh_tw)
• New! Added messages_zh_cn.yml (Chinese Simplified - 简体中文) language file
• New! Added messages_zh_tw.yml (Chinese Traditional - 繁體中文) language file
• New! Added messages_ar.yml (Arabic - العربية) language file
• Optimize! Users with "zh" in their config.yml will automatically use "zh_cn" (Simplified Chinese)

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Fixed potential race condition
• Optimize! Reduced synchronized block scope
• Optimize! Improved cache key generation
• Optimize! Enhanced thread safety

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Potential crash from invalid UUID format in database
• Optimize! Replaced SimpleDateFormat with DateTimeFormatter in CoinFlipHistoryGUI
• Optimize! Improved string replacement performance
• Optimize! Enhanced leaderboard query error handling

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Critical resource leak - SQLiteDatabaseManager and MySQLDatabaseManager are now properly closed using try-with-resources to prevent database connection leaks
• Fix! Thread safety issue
• Optimize! Improved database resource management

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! All language files now get restriction messages automatically added during config update, not just the active language file

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added currency restrictions system - restrict currency usage based on world and permissions
- World-based restrictions: allow or block specific worlds per currency
- Permission-based restrictions: require specific permissions to use currency
- Each currency can have independent restrictions configuration
- Supports both allowed-worlds (whitelist) and blocked-worlds (blacklist)
• New! Restriction validation when creating games - players cannot create games with currencies they cannot use
• New! Restriction validation when joining games - players cannot join games if restrictions prevent them from gambling together
• New! Automatic game filtering - games that players cannot join are automatically hidden from the list
• New! Currency filtering in create GUI - only shows currencies that the player can use based on their current world and permissions
• New! Restriction messages to all language files
• Fix! Null safety checks for player, world, and world name throughout restriction validation
• Fix! Improved error messages with detailed restriction reasons (world blocked, permission required, etc.)
• Fix! Optimized restriction validation to avoid duplicate checks
• Fix! Added warning log when world appears in both allowed-worlds and blocked-worlds lists
• Optimize! Improved data loading - filters and trims world names and permissions when loading from config
• Optimize! Optimized game filtering to reduce unnecessary validation calls
• Optimize! Improved code quality with comprehensive comments and error handling

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! CoinsEngine and Placeholder currency command usage - users can now use currency ID directly (e.g., /cf create coins 1) instead of only syntax-command or coinsengine:<id> format
• Fix! CoinsEngine API compatibility
• Fix! Custom placeholder currency winrate placeholders now return actual winrate (was returning 0 before)
• Optimize! Improved invalid currency error message
• Optimize! Improved CoinsEngineCurrencyHandler initialization

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added winstreak tracking system - tracks consecutive wins for each player
• New! Added winstreak placeholder: %coinflip_winstreak% - returns player's current winstreak
• New! Added top winstreak placeholders: %coinflip_top_<rank>_winstreak_name% and %coinflip_top_<rank>_winstreak_value%
• New! Added top leaderboard placeholders - display top player names and values for all leaderboard filters: %coinflip_top_<rank>_<filter>_<currency>_name% or %coinflip_top_<rank>_<filter>_<currency>_value[_formatted]%
• Optimize! Leaderboard data is cached for 30 seconds to optimize performance

Support/Help:
Join the discord server to ask for help.

Changelog:
• Optimize! FoliaScheduler now caches MethodHandles instead of raw reflection, reducing per-task overhead on Folia servers

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added winrate tracking for custom placeholder currencies - custom currencies now track wins/defeats and display actual winrate instead of 0
• New! Database schema updated to store custom placeholder currency stats in JSON format (automatic migration for SQLite and MySQL)
• Fix! Custom placeholder currency winrate placeholders now return actual winrate (was returning 0 before)

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added minimum reserve balance feature - prevents players from betting entire balance to bypass other plugin limits
• New! Added winrate per currency tracking - track and display winrate separately for Money, PlayerPoints, TokenManager, and BeastTokens
• New! Added winrate placeholders: %coinflip_winrate_<currency>% and <winrate_<currency>> in GUI
- Built-in currencies (money, playerpoints, tokenmanager, beasttokens): returns actual winrate
- Custom placeholder currencies: %coinflip_winrate_<currencyId>% or %coinflip_placeholder_<currencyId>_winrate% (returns 0, not tracked)
• New! Added placeholder currency support in GUI placeholders - placeholder_<currencyId>_unit and placeholder_<currencyId>_display
• New! Database schema updated to track wins/defeats per currency (automatic migration for SQLite and MySQL)
• Fix! Fixed c olor code sup port for unit in messages
• Fix! Fixed custom placeholder currencies not showing in GUI placeholders
• Fix! Fixed potential exploit where players could bet entire balance to bypass plugin limits
• Fix! Added post-update field addition to ensure user currencies in customplaceholder.yml are preserved with all new fields during updates
• Optimize! Improved config comments with PlaceholderAPI usage examples and currency ID format documentation

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added bStats for anonymous plugin statistics collection

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Critical security bug where players could take player heads from coinflip roll GUI
• Optimize! Added button handlers for all slots containing player heads
• Optimize! Prevents players from taking items from coinflip animation GUI by adding protected slot handlers

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Fixed AnvilGUI import path to use relocated package
• Fix! Removed unused imports in VaultEconomyListener to clean up code
• Optimize! Removing unnecessary dependencies and import statements

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added second example currency (gems) to customplaceholder.yml to demonstrate multiple currencies support
• New! Added per-currency dynamic tax configuration - each custom currency can now have its own tax rate tiers
• New! Added leaderboard filter configuration in config.yml - enable/disable specific filters (wins, profit, largest-win, worst-profit)
• New! Added "Worst Profit" leaderboard filter - shows players who lost the most money overall
• Fix! Critical bug where user-added custom currencies in customplaceholder.yml were being removed/reset during config updates
• Fix! Customplaceholder.yml always resetting to "orbs" currency when users add additional custom currencies
• Fix! Leaderboard "Wins" filter incorrectly showing currency symbol ($) when it should only display win count
• Optimize! Enhanced config updater to use addIgnoredRoute for currencies section in customplaceholder.yml and coinsengine.yml

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Migrated build system from Gradle to Maven for better dependency management and compatibility
• New! Added VaultEconomyListener to automatically detect when economy plugins hook into Vault
• Fix! Anvil GUI not capturing user input correctly
• Fix! Color codes displaying in anvil GUI text field - input now shows clean numbers without formatting codes
• Fix! Anvil GUI compatibility issues with Paper 1.21.10+ by using proper AnvilGUI library with Spigot mappings support
• Fix! Plugin disabling when economy loads after UltraCoinFlip - now uses ServiceRegisterEvent for economy detection
• Fix! NPE when using commands before economy is ready - added null checks with informative messages
• Fix! AnvilGUI dependency conflicts with other plugins
• Optimize! No longer relies on softdepend or delay timers

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added permission-based multi-game creation limits with configurable defaults and per-permission overrides
• New! Added protection that blocks players from starting or joining a second coinflip while an animation is running, and hides their other listings until the roll finishes
• New! Added crash-safe waiting-game refunds stored in the database
• New! Added leaderboard feature with customizable GUI displaying top 15 players
• New! Added leaderboard filtering system (Number of Wins, Most Profit, Largest Win)
• New! Added currency filter in leaderboard GUI
• New! Leaderboard command (/cf leaderboard, /cf lb, /cf top)
• Fix! Dynamic tax rate system not working properly - tax rates are now correctly applied based on bet amount tiers
• Fix! Tax rate validation - values entered as percentages (e.g., 99 for 99%) are now automatically converted to decimal format (0.99)
• Fix! Wiin reward calculation - tax is now properly applied according to configured dynamic tax rates
• Optimize! Improved tax rate validation with better error messages and automatic percentage conversion
• Optimize! Added debug logging for tax rate calculations to help diagnose configuration issues

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Large bet amounts no longer display in scientific notation anywhere (commands, GUI, broadcasts); they now respect the configured number-formatting style
• Fix! Broadcast and other messages no longer inherit bold/italic formatting from the prefix - prefix text now automatically resets formatting afterward
• Fix! Silent broadcasts now require the `ultracoinflip.silent` permission to be explicitly granted
• Optimize! Coinflip rolling animation precomputes spins so the reel always lands on the predetermined winner without last-frame flicker, keeping the visual result in sync with the payout

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Update checker success message keeps its color/tick formatting by translating legacy & codes into console colors

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added PlaceholderAPI placeholder support in GUI
• New! Added configurable number formatting system with 3 format types: COMPACT (K/M/B/T), COMMAS (1,000,000), and FULL (1000000)
• New! Added per-currency number format override option in config.yml
• New! Added configurable thresholds for compact format (K/M/B/T) in config.yml
• New! Added right-click to cancel own coinflip game feature in /cf menu (only host can cancel their own game)
• New! Added lore display for cancel option when viewing own game (shows "Right-click to cancel" message)
• New! Added anvil GUI input support as alternative to chat input (configurable in config.yml: input.method)
• New! Added formatted PlaceholderAPI placeholders for profit and net profit (e.g., %coinflip_profit_money_formatted%, %coinflip_net_profitt%) - returns formatted numbers with commas (xxx,xxx,xxx) or K/M/B/T based on config
• New! Added BeastTokens currency integration
• Fix! Fixed profit calculation to properly account for tax
• Fix! Fixed animation display bug where animation would show wrong winner
• Fix! Improved animation-result consistency - animation ending position now matches the actual winner result
• Fix! Fixed ChatColor plugin compatibility
• Fix! Fixed game item PlaceholderAPI placeholders showing viewer's stats instead of host's stats
• Fix! Anvil input GUI now opens reliably on 1.20+ servers
• Optimize! Improved number display formatting - removes unnecessary .00 decimals and adds comma separators
• Optimize! All amounts in GUI, messages, notifications, and Discord webhooks now use configurable formatting
• Optimize! GUI automatically refreshes for all viewers when a game is cancelled

Support/Help:
Join the discord server to ask for help.

Changelog:
• Optimize! All debug messages now properly respect debug mode configuration
• Optimize! Added safe methods for InventoryView operations to prevent compatibility errors
• Fix! Fixed debug messages appearing in console when debug mode is disabled
• Fix! Fixed IncompatibleClassChangeError compatibility issue with Spigot and Spigot forks (UniverseSpigot, etc.)
• Fix! Improved compatibility with different server implementations (Paper, Spigot, UniverseSpigot)

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added configurable GUI click sound
• Fix! Moved all sound configuration to sounds.yml and removed duplicate sound section from config.yml!

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix! Incompatibility error with USpigot 1.20.4 (need more testing on other spigot forks)

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Slot range format support (x-y)
• New! Enhanced currency selection GUI
• Optimize! Removed unnecessary &r prefix from GUI configs
• Fix! Cursor jumping when click buttons

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Added help command for better user guidance
• New! Added silent permission (ultracoinflip.silent) to disable notifications
• New! Added game history display with full custom GUI support
• New! Added advanced filtering system (filter by time, price ascending/descending)
• New! Added game filtering feature
• New! Added /cf history command to check game history
• New! Added game behavior customization in config.yml
• New! Added tax system toggle customization per currency file
• New! Added support for custom-model-data, amount, and glowing effects on GUI buttons
• New! Added separate GUI folder with individual customization for each GUI
• New! Added sounds.yml to customize all sounds in the plugin
• Optimize! Improved message hiding support (set to " " to hide messages)
• Optimize! Enhanced player head display with multiple display methods
• Optimize! Updated page navigation buttons for better user experience

Support/Help:
Join the discord server to ask for help.

Changelog:
• Optimize! DiscordWebhook feature
• Optimize! Logic refunds the player
• Optimize! Improved performance when creating PlayerStats
• Fix! Remove Essentials depency

Support/Help:
Join the discord server to ask for help.

Changelog:
• Optimize! Better BoostedYAML optimization
• Optimize! Further optimization of Dynamic tax rate system

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! Dynamic tax rate system per currency
• Optimize! Clean some code parts

Support/Help:
Join the discord server to ask for help.

Changelog:
• Optimize! Auto-Refresh GUI feature when there are many games going on

Support/Help:
Join the discord server to ask for help.

Changelog:
• New! BoostedYAML added to the config

Support/Help:
Join the discord server to ask for help.

Changelog:
• Fix: Folia compatibility error
• Fix: Color code error in console with UpdateChecker message

Support/Help:
Join the discord server to ask for help.

Changelog:
• New: Add UpdateChecker feature

Support/Help:
Join the discord server to ask for help.