ВЕРСИИ (94)

- **Fix!** Settings no longer show toggles for features you turned off, like bot games or the **bossbar** - **Fix!** Turning off bot games fills its main menu slot with glass instead of leaving a gap - **Fix!** Menu buttons no longer play their sound twice, like going back to the main menu - **Fix!** Fixed a typo in the sound notifications setting name

- **Fix!** The plugin starts even when another plugin ships a library that can't read your server version - **Fix!** A pending refund no longer goes missing when the same player starts another coinflip - **Fix!** Daily and weekly bet limits survive a restart instead of resetting to zero - **Fix!** Cancelling or expiring a coinflip gives that amount back to the player's bet limit - **Fix!** Amounts like **2.01k** are read as 2010 instead of 2009.99

- **New!** Full **Minecraft 26.3** support out of the box - **New!** **/cf support** gives you one link with everything we need to help you faster - **Fix!** Head textures like the bot head and menu arrows show up again on **1.8–1.17** - **Fix!** Menus no longer show a skeleton skull where a player head belongs on **1.8–1.12** - **Fix!** Typing a custom bet amount in the anvil works again on **26.x** - **Optimize!** Refreshed the libraries the plugin ships with

- **Fix!** On **Folia**, joining a coinflip whose host is far away no longer errors and loses both bets - **Fix!** A coinflip that fails to start now gives the bet back and puts the game back in the list - **Fix!** The plugin starts again on **Paper 1.16.5–1.18.1** instead of failing to enable - **Fix!** **MySQL** servers (not MariaDB) now create their tables instead of running without them - **Fix!** The plugin now stops if its database can't start instead of taking unprotected bets - **Fix!** **persist-games** keeps waiting coinflips across restarts and no longer loses bets after a crash - **Fix!** A database hiccup no longer resets a player's **stats** - **Fix!** Closing the flip menu no longer sends admins a false exploit alert - **Fix!** The coinflip list refreshes live again in every language - **Fix!** Menu items can no longer be taken out after a plugin reload or from a shared roll menu - **Fix!** **HeadDatabase** heads now show on every menu button instead of a plain head - **Fix!** **/cf limit** works for regular players, and six settings toggles now work for ops too - **Fix!** Players with **ultracoinflip.admin** can now use /cf reload - **Fix!** A typo in a language or menu file no longer resets it back to defaults - **Fix!** Currency **message overrides** and **event command** switches no longer vanish on restart - **Fix!** Coinflips that expire now run their **on-cancelled** event commands - **Fix!** Per-currency limits you add yourself now survive **config** updates - **Fix!** **Earnings limit** warnings now play their sound, and a **money** block works like vault - **Fix!** The earnings limit **auto-tune** multiplier is no longer wiped from config.yml - **Fix!** Boss bar messages now show up, and action bars work on **Spigot** - **Fix!** Long menu titles, player heads and dye icons display correctly on **1.8–1.12** - **Fix!** Custom bet amounts fall back to chat properly on **26.x** and **Folia** - **Fix!** Running a command while the bet prompt is open no longer eats the command - **Fix!** **/cf create playerpoints** and the other currency names from the help message now work - **Fix!** Extra command names in **command_aliases** now actually register - **Fix!** Custom currency balances like **1.5k** and currency file amounts like **10M** are read correctly - **Fix!** **CoinsEngine** wins and losses from player games now count in stats - **Fix!** The custom currency **win rate** placeholder no longer always shows 0 - **Fix!** Daily to yearly **profit** leaderboards now count profit the same way as the all-time board - **Fix!** Bot game history now saves on **MySQL** even with a long bot name - **Fix!** Plugins listening for limit events now get the real reset time - **Fix!** Config comments now match what really happens when players leave or close a flip - **Fix!** Errors from other plugins show in the console again instead of disappearing - **Optimize!** The stats and heads-or-tails menus no longer log a sound warning every time they open

- **Fix!** Creating and joining games works again on **1.8.8–1.11.2** servers - **Fix!** A refund from one **bot** game could pay out another player's bet a second time - **Fix!** Starting a second flip while one was still rolling could swallow the bet - **Fix!** A flip that was already refunded could still pay out when its animation ended - **Fix!** Relogging during a flip no longer cancels it and burns the loser's bet - **Fix!** Leaving mid-flip now pays your full winnings instead of only your bet back - **Fix!** Winnings that fail to deposit are now saved in full for your next join - **Fix!** Cancelling a coinflip right as you joined could refund it twice - **Fix!** **/cf reload** during a flip now refunds online players right away - **Fix!** **Custom currencies** handle comma-decimal servers and very large balances correctly - **Fix!** A mistyped **custom currency** command no longer lets bets through for free - **Fix!** Decimal **Points** and **Tokens** bets on older configs no longer take points without a game - **Fix!** **Earnings limits** now apply to bot games and count real profit, not the whole payout - **Fix!** **Betting limits** now apply to players who join a coinflip - **Fix!** Turning off **house.tax.enabled** now actually removes tax from bot games - **Fix!** Very large bets no longer get paid less than they should - **Fix!** The update checker now actually tells you when a new version is out - **Fix!** A player name containing a placeholder can no longer freeze the server

- **Fix!** Rejoining right after a refund could hand the same bet back over and over - **Fix!** Stopping or reloading the server could pay a bet back twice on **bot** games - **Fix!** One failed refund on shutdown no longer stops everyone else from getting theirs - **Fix!** The first game after a restart no longer wipes that player's lifetime **stats** - **Fix!** **SQLite** servers no longer lose stats and history writes at random - **Fix!** The update checker no longer breaks on **Java 8** servers - **Fix!** Currency limits you add yourself stay in **config.yml** instead of vanishing on restart - **Fix!** Earnings limit **permission groups** now actually raise the cap - **Fix!** The currency arrow in the create menu now moves your bet inside that currency's limits - **Fix!** **/cf limit player** showed your own limits when the target was offline - **Fix!** Leaderboard placeholders for **custom currencies** now return a value - **Fix!** The audit menu no longer fails to open on **1.8-1.12** - **Fix!** Translated two leftover English messages in **5 languages** - **Optimize!** The history menu only loads the page you're on instead of your whole history - **Optimize!** **Discord** messages no longer pause the server looking a player name up - **Optimize!** Chat and menu text is turned into colours faster on busy servers - **Optimize!** Player data is dropped from memory on quit so it stops building up

- **Fix!** Betting a decimal amount of **Points** or **Tokens** no longer charges less than the game pays out - **Fix!** Bot games now round winnings to whole numbers like normal games already did - **Fix!** Switching currency in the create menu now moves your bet inside that currency's limits - **Optimize!** Player lookup commands no longer pause the server when the target is online

- **New!** Set the amount the create menu opens on with **default-bet**, or -1 to use the currency's min-bet - **Fix!** The create menu no longer opens below a currency's **min-bet** - **Fix!** Limit warnings now show **80%** instead of the broken **80%%** - **Fix!** Menus with a named player head no longer stall the server looking that name up - **Fix!** Translated a leftover English message in **German**, **Spanish**, **French**, **Dutch** and **Russian** - **Optimize!** The skin cache now has a size limit so it stops growing on busy servers

- **New!** Waiting coinflips can now expire on their own and hand the bet back to the host - **New!** Set how long a coinflip may sit with **after-hours**, default is 3 days - **New!** Hosts who are offline when their coinflip expires get the money on their next join - **Fix!** Placeholder currency and event commands no longer spam errors on **Folia** servers - **Optimize!** Opening menus no longer freezes the server while a player skin is downloaded

- **Fix!** Custom bet amounts in the create menu no longer get rejected as an invalid format - **Fix!** Copied amounts with hidden characters in them now work instead of failing - **Fix!** Emptying **prefix** to turn it off no longer throws a validation error on startup - **Fix!** Problems while opening the create menu now show up in console instead of staying hidden

- **New!** Turn off the **+/- preset buttons** so players only set their bet with the custom amount - **New!** Hide a single preset with **enabled: false** if you just want fewer of them - **New!** Hidden preset slots fill in with your filler item instead of leaving a hole - **New!** One switch in config.yml now turns off every coinflip **broadcast** at once - **New!** Net profit has an uncoloured **<net_money_raw>** so you can pick your own colour - **Fix!** Dialog titles and buttons came out blank, and their colour codes never showed

- **New!** The on/off toggles now take **glowing**, **custom model data** and **item-model** like every other item - **New!** Toggle icons also accept a **HeadDatabase** head with **material: 'hdb-1234'** - **Fix!** The private button stayed on **Public** when clicked, so games went private with no sign of it - **Fix!** Typing a custom bet amount no longer quietly sets your game back to public - **Fix!** **settings-slots** now actually moves the toggles instead of being ignored

- **New!** Bedrock players on **Geyser/Floodgate** get native phone-friendly menus instead of chests - **New!** Works both when Geyser runs on your proxy and when it runs on the server itself - **New!** Any menu icon accepts a **HeadDatabase** head with **material: 'hdb-1234'** - **New!** Bedrock menu buttons can show your own images, set per button in the gui files - **New!** Other plugins can finally react to coinflips: create, join, cancel, refund and finish all fire now - **Fix!** A bet could vanish with no refund when a limit blocked the game right after paying - **Fix!** Creating a bet with **/cf create** no longer says it worked when it did not - **Fix!** Items in the **stats** menu now respect their glow and custom model settings

- **New!** Menu items can now use the **item-model** component for custom models on **1.21.4+** - **New!** Set it on any item that already supports custom model data, in every GUI file - **Fix!** Items in the **stats** menu now respect their glow and custom model settings

- **New!** Optional modern pop-up menus on **1.21.7+** for betting, joining, and picking heads or tails - **New!** Bet amounts can be set with a slider instead of typing, so no more mistyped numbers - **New!** Turn it on with **dialog.enabled** in config — older servers keep the classic chest menus

- **Fix!** Leaderboards and placeholders no longer risk stalling the database on MySQL servers - **Fix!** The largest-win and worst-profit leaderboard placeholders work again - **Fix!** Leaderboard placeholders no longer glitch when many are shown at once - **Fix!** Custom menu icons now work on every Minecraft version - **Fix!** Bot game profit in the list now matches the currency shown next to it - **Fix!** A typo in the house bet amount no longer breaks bot games - **Fix!** Coinflip menus always refresh correctly, even right after a player logs out - **Fix!** Points and Tokens winnings round cleanly instead of dropping a leftover - **Optimize!** Faster leaderboard and placeholder loading on busy MySQL servers - **Optimize!** Smoother menu and leaderboard rendering with less memory use

- **Fix!** Tab-completing /coinflip create no longer suggests a bet amount where the currency should go

- **New!** Leaderboard placeholders can now show daily, weekly, monthly or yearly rankings - **Fix!** Leaving and rejoining during a coinflip can no longer pay your bet back twice

- **New!** The server can now announce when a player wins or loses against the bot - **New!** The create coinflip menu now has a Back button to return to the main menu

- **New!** Full **Minecraft 26.2** support out of the box - **Optimize!** Updated bundled libraries to their latest stable versions

- **New!** Menus can now have extra filler items, each with its own material, slots and lore - **New!** The Public/Private button text in the Create menu is now editable in the language files - **Fix!** The click hint line on game tiles no longer shows up as a blank line - **Fix!** Win and loss action bar messages no longer show up in chat

- **New!** Previous and Next page buttons can now show custom lore - **Fix!** Quickly clicking the page buttons no longer drops you on an empty page - **Fix!** The Previous button no longer stays on page 1 after going forward then back - **Fix!** Hex colors written as <##rrggbb> now render cleanly instead of leaving stray brackets in chat

- **New!** /coinflip info shows plugin version, server, database and detected economies at a glance - **New!** /coinflip help is now grouped by section and shows admin commands when an admin runs it - **New!** Every GUI now has a filler.enabled switch so you can turn off the glass background in one line - **Fix!** Plugin no longer crashes when opening the Create menu on 1.8.x servers - **Fix!** /cf reload now applies the new language to the GUI right away instead of keeping English captions until restart - **Fix!** Stats menu currency slots no longer force glass behind the scenes when you turn the filler off

- **New!** /cf invite <player> sends a clickable Accept/Deny invite to a specific player - **New!** /cf private hides your coinflip from the list so only invited players can join - **New!** Private toggle in the Create GUI starts your game invite-only in one click - **New!** /cf accept and /cf deny respond to invites, no ID needed for a single pending invite - **New!** /cf uninvite <player> removes someone from your invite list - **New!** Optional setting keeps waiting games alive across a full server restart - **New!** Master toggle in config.yml turns the invite system off for pure public coinflip - **New!** "Usage:" hints for every /cf command are now translatable per language - **Fix!** Coinflips kept alive after host disconnect now show in the list instead of a blank barrier - **Fix!** Joining a coinflip whose host is offline now shows a clear message instead of crashing - **Fix!** Discord webhooks no longer leak raw &b color codes from LuckPerms prefixes into messages - **Fix!** /coinflip help now runs from console too instead of refusing with "Console may not execute" - **Optimize!** Chat commands and the list GUI now share one join path so dupe protection is identical

- **New!** /cf create <amount> now works with a single argument, using the default currency from config - **Fix!** Plugin now loads on Paper 1.20.5 and newer instead of failing the remap step at startup - **Fix!** Setting filler slots to an empty list now actually clears the panes instead of falling back to the default layout - **Fix!** Leaderboard menu now respects the filler slots option in the config instead of always filling every empty slot - **Fix!** PlaceholderAPI placeholders inside the Play with Bot button lore now resolve correctly instead of showing the raw text

- **Fix!** Filler items in every GUI now show the correct texture from custom-model-data, including on Paper 1.21.4 and newer - **Fix!** Glowing setting on filler items is now respected across all GUIs - **Fix!** /cf reload now refreshes filler textures right away instead of keeping the old ones cached

- **Fix!** /cf limit alone now shows the available subcommands instead of "unknown command" - **Fix!** /cf limit player and reset now show <player> instead of <arg1> in the usage hint - **Fix!** /cf limit auto-tune now shows <currency> instead of <arg1> in the usage hint - **Fix!** Player heads in the GUI now load correctly on Arclight and other hybrid servers - **Optimize!** Player heads in the history GUI no longer flood the console with Mojang 403 errors when their session server is unreachable - **Optimize!** Faster MySQL reads, multiple players can fetch data at the same time

- **New!** Cap how much players can win or lose per day, week, or month - **New!** /cf limit auto-tune scans recent activity and suggests sensible cap values for you - **New!** Players get a heads-up when they reach 50%, 75%, or 90% of their limit - **New!** /cf limit subcommands let players check their own limits and admins reset them - **New!** Eight new placeholders for showing limit caps and remaining amounts on HUD or scoreboard - **New!** Console highlights critical and important updates so urgent fixes stand out - **New!** Other plugins can now integrate with UltraCoinFlip through a public API - **Fix!** Setting the game lore to empty no longer leaves a stray cancel hint for the host - **Fix!** Server no longer freezes when many players open the coinflip list at once - **Optimize!** Stats save in the background so they don't slow down active games - **Optimize!** Faster MySQL reads, multiple players can fetch data at the same time

- **Fix!** Server thread freeze when many players opened the coinflip list - Bot stats are cached briefly and refreshed in the background instead of querying the database on the main thread - **Optimize!** Player stats batch save no longer blocks the main thread - Saves now run on a background thread so heavy stats traffic doesn't cause lag spikes - **Optimize!** Removed unnecessary database lock that was bottlenecking MySQL queries - Multiple players can now read the database in parallel for noticeably smoother performance

- **New!** Winner head option for the history GUI - Set player-head.type to 'Winner' in history.yml to show whoever actually won each game instead of the opponent - **Fix!** Blank lore lines using '' or '&f ' were silently removed from item tooltips

- **New!** GUI text now follows the language setting - Titles, lores and button names are translated, so non-English servers finally see GUIs in their language - **New!** Safe auto-migration of GUI customizations - Your customized text is moved into the active language file, with a backup of the original kept just in case - **New!** Cleaner GUI config - Layout files now hold layout only, all translatable text lives in the language files - **New!** All 17 supported languages ship with full GUI translations (en, vi, pl, de, fr, es, it, nl, pt, ru, zh_cn, zh_tw, ja, ko, ar, tr, lt) - **Fix!** Rightmost head in the roll animation snapped to the winner right after the reveal - **Fix!** Slot-machine animation flashed the winner head mid-spin then went random again before the final reveal - **Fix!** Circular animation looked like every slot was randomly flickering instead of rotating - **Fix!** Vertical animation looked like every row was randomly flickering instead of scrolling - **Fix!** Circular and vertical winner heads were forced into hardcoded slots ignoring your config - **Fix!** Per-subcommand permissions could be bypassed by clicking buttons in the main menu GUI

- **New!** Disconnect-mid-roll exploit detection - **New!** Per-subcommand permissions - Each /cf subcommand has its own permission node (ultracoinflip.command.menu, .create, .delete, .history, .leaderboard, .settings, .stats, .help) so admins can selectively disable any of them - **New!** Leaderboard cache controls in config.yml - **New!** Placeholder %coinflip_leaderboard_refresh_in% - Countdown to the next leaderboard refresh - **Fix!** Critical dupe where players could disconnect mid-roll the moment they saw they were about to lose and get their bet back on rejoin - **Fix!** Closing the GUI mid-roll with allow-close-during-animation off used the same loophole - **Fix!** Winner heads showing as plain chest icons in the coinflip history GUI on Purpur 1.21.8

- **Fix!** Refund only arrived after a server restart instead of on rejoin (especially on 1.8.x) - **Fix!** Game stayed stuck if both players disconnected right at the end of the animation - **Optimize!** Added detailed disconnect/rejoin debug logs

- **New!** Support blank lines in GUI lore - **Fix!** Winner sometimes did not receive their prize if a player disconnected right before the result - **Fix!** Game stuck and money held when both players disconnected mid-roll - **Fix!** Newer ExcellentEconomy builds were not detected after the plugin was renamed from CoinsEngine - Now works on both old CoinsEngine and the latest ExcellentEconomy without changing your config

- **Fix!** Console spammed dozens of "Invalid material" warnings on 1.8.x servers for materials that actually worked fine - **Fix!** Sunflower, oak sign, and command block icons didn't render on 1.8.x servers

- **New!** Per-currency winner/loser/broadcast messages - **New!** Leaderboard lore now switches with the filter by default - **Fix!** Worst leaderboard mirrored the Profit totals - Now ranks by biggest single-game loss, matching how Best Win works

- **Fix!** Update notifier kept showing the old message after /cf reload

- **Fix!** Event commands didn't parse PlaceholderAPI placeholders when PlaceholderAPI loaded after UltraCoinFlip - **Optimize!** Click cooldown data piled up in memory over long uptimes

- **Fix!** Plugin crashed with "NoSuchMethodError" when players interacted with GUIs on Paper 1.12.2

- **New!** Per-actor prefix placeholders - Use <winner_prefix>, <loser_prefix>, <player_prefix> in broadcast and win/lose messages to show each player's LuckPerms prefix correctly - **Fix!** Console spam of "SQLite database connected!" when players did actions - **Fix!** LuckPerms prefix with &x hex color codes not rendering in messages - **Fix!** PlaceholderAPI placeholders not working if PlaceholderAPI loaded after UltraCoinFlip - Now detects PAPI dynamically

- **New!** Minecraft 26.1.2 support - **New!** Player stats command - View any player's coinflip stats with /cf stats [player], supports GUI and chat display modes - **New!** Stats GUI - Detailed stats screen showing wins, losses, win rate, and per-currency profit breakdown - **New!** Default currency setting - Skip currency selection with /cf create <amount> when a default is configured - **New!** Settings shortcut - Click your stats head in the main menu to open player settings - **New!** PlaceholderAPI in all messages - Use any PlaceholderAPI placeholders in messages, broadcasts, and GUI lore - **Fix!** MiniMessage tags with hex colors like <gradient:#FAC100:#E2E501> were broken - **Fix!** Update notification shows a helpful diagnostic message instead of silently failing when the lang file has formatting errors

- **Fix!** CoinsEngine v2.7.0 currencies failed to initialize with a "Could not find API methods" error - **Fix!** Startup showed both "CoinsEngine: Found" and "ExcellentEconomy: Not installed" even though they are the same plugin

- **New!** Minecraft 26.1 support - AnvilGUI now works correctly on 26.1 servers with the new NMS wrapper - **New!** Custom placeholder currencies now support set-command as an alternative to remove-command for plugins without a withdraw command - **Fix!** Some GUI screens crashed on 1.8.x servers due to materials that only exist in 1.13+ - **Fix!** Version comparison could give incorrect results for 26.x minor versions - **Optimize!** Updated all bundled and runtime libraries to their latest stable versions for better performance, security, and compatibility

- **Fix!** Errors from other plugins were displayed under UltraCoinFlip's name

- **New!** Round-to-integer option per currency - Winnings are rounded to the nearest whole number, useful for currencies like tokens or shards that don't support decimals (round-to-integer in each currency config, default: false) - **Fix!** Plugin crashed with a null config error when joining a coinflip - The roll animation screen now opens correctly for both players - **Fix!** Plugin crashed with a null config error when creating a coinflip with the heads/tails selection screen enabled - The selection screen now opens correctly - **Fix!** Plugin crashed with a null config error when starting a bot coinflip game - Bot games now start correctly - **Fix!** Custom PlaceholderAPI currencies blocked the game with a false security error even when the player had enough balance - Custom placeholder currencies now work correctly - **Fix!** Coinflip animation did not play and no winner was determined when a game was accepted - Both players now see the animation and the game resolves correctly - **Optimize!** Material lookups were repeated on every GUI render - Results are now cached so the server does far less work when many players have the list open - **Optimize!** GUI config was re-read from disk on every render and every click across all screens - All values are now read once per render, greatly reducing CPU use - **Optimize!** Lore template caching no longer uses a class-level lock - Reduced contention when multiple players open the list at the same time - **Optimize!** Inventory size and config reference are now cached once per render cycle instead of being re-queried on every slot check - **Optimize!** Click cooldown check now calls the system clock once per click instead of three times - **Optimize!** Auto-refresh title check no longer re-parses color codes and regex on every tick - **Optimize!** Settings, animation, leaderboard, create-game, and currency screens still re-read config up to 124 times per render - All remaining GUI screens now read config once per render - **Optimize!** Settings menu sort re-read config twice per item comparison - Slot values are now pre-loaded before sorting

- **New!** **/cf webhook test** command - Lets admins verify their Discord webhook is working without needing a live game - **Fix!** Discord webhook not sending when using Discord Canary or PTB links - All Discord URL variants are now accepted - **Fix!** Discord webhook silently failing when the URL had a trailing space - URL is now trimmed before validation

- **New!** Discord webhook for game creation - Server owners can now receive Discord notifications when players create new coinflip games, with full PlaceholderAPI support for custom player info like ranks and prefixes - **New!** Arrow indicator toggle in animation GUI - The arrow head indicator in default coinflip animations can now be hidden via config (arrow-enabled: true/false in flipping.yml) - New! PlaceholderAPI support in Discord webhooks - All Discord webhook messages now support PlaceholderAPI placeholders like %luckperms_prefix% for displaying player ranks and custom information - **Fix!** Rainbow and fade animations not working on Minecraft 1.8.9 servers - All border animation modes (rainbow, fade, pulse, wave, gradient, random, sequence) now display correctly on legacy 1.8.x servers with proper colored glass pane support - **Fix!** Cleanup task could crash with ConcurrentModificationException when many players were online - stale refund and cooldown entries are now removed safely - **Fix!** GUI inventory clicks could interfere with vanilla chest and player inventory interactions under high concurrency - event handling is now thread-safe - **Fix!** Animation running and finished states in the roll screen were not visible across threads, which could cause the animation to stop early or not stop at all - **Fix!** Cached player head items shared the same ItemStack reference, meaning lore or name changes to one affected all other players seeing the same head - **Optimize!** Tab-completing currency names no longer triggers a full lookup on every key press - results are cached for 5 seconds, reducing server load - **Optimize!** Player head items in all GUIs are now reused from a cache instead of being rebuilt on every GUI open, improving performance with many concurrent players - **Optimize!** Database column migration on startup now checks all columns in one query instead of running a separate SQL statement per column

- **Fix!** Discord webhook embeds could show broken winner names and win amounts when placeholders were used with bold formatting

- **Fix!** Language files missing newer message keys now get those keys filled in automatically when the plugin starts or reloads

- **New!** Player rank placeholders - %coinflip_position_wins%, %coinflip_position_winstreak%, %coinflip_position_profit_money%, %coinflip_position_largest_win_money%, etc. show each player's leaderboard position; bare %coinflip_position% defaults to wins rank - **New!** Configurable unranked text - The text shown when a player has no rank or a leaderboard slot is empty can now be changed in config.yml (leaderboard.not-ranked-text), default is N/A - **New!** GUI button visibility toggle for all menus - Any button in the main menu (leaderboard, history, create, filter, bot game), leaderboard GUI (filter, currency, back), history GUI (back), and settings GUI (back) can be hidden by setting enabled: false in the corresponding yml config file - **New!** Loser (most losses) ranking placeholders - %coinflip_top_<rank>_losses_name%, %coinflip_top_<rank>_losses_value%, and %coinflip_position_losses% let you display who has lost the most games and each player's rank by number of defeats - **Fix!** %coinflip_top_<rank>_wins_name%, %coinflip_top_<rank>_winstreak_name% and similar placeholders not resolving - they now display correctly on all servers - **Fix!** Wins and winstreak leaderboard placeholders with an optional currency token (e.g. %coinflip_top_1_wins_money_name%, %coinflip_top_1_winstreak_coinsengine_gems_name%) now resolve correctly regardless of how many currency tokens are present - **Fix!** %coinflip_winrate_formatted% not returning a value - it now works as an alias for %coinflip_win_percentage_formatted% - **Fix!** Custom no-permission message - Players now see the plugin’s configured no-permission message instead of the default server message - **Fix!** Unlimited active games setting - Setting multiple-games.default-limit: -1 now correctly removes the active game limit for all players - **Fix!** Broadcast visibility for admins and wildcard ranks - Broadcast messages now respect bypass permissions correctly even when silent permissions are present - **Fix!** Unranked text consistency - The configurable unranked text now also appears in the game list win-rate display

- **Fix!** Roll animation sound was silent or only played once at the start - **Fix!** Animation completion sound was silent on some servers - **Fix!** Plugin crashed when opening any GUI on PandaSpigot / 1.8.9 servers - **Fix!** Player heads (winner/loser display) failed to show on 1.8.9 servers - Player skulls now render correctly, and the SKULL_ITEM:3 legacy material format is now accepted in config - **Fix!** Coinflip roll animation crashed on 1.8.9 servers with rainbow border mode - **Fix!** Sounds crashed the server on 1.8.9 during and after the roll animation

- **New!** Redesigned Audit Dashboard - The admin audit GUI now displays a full system overview including plugin version, server software, database status, Discord integration, and all active hooks at a glance - **New!** Server software detection - The audit dashboard and startup log now show which server platform is running (Paper, Purpur, Folia, Spigot, etc.) - **New!** Console system report - Running /cf audit from the server console now prints a detailed text-based system report instead of failing silently - **Optimize!** Removed unused language keys

- **Fix!** Sound effects stopped working in newer plugin versions

- **Fix!** Player heads configured with Base64 texture in the Create CoinFlip item and currency selection items were showing a plain Steve head instead of the configured skin

- **Fix!** Hex color codes in item titles and display names were silently stripped and never shown in-game - **Fix!** Hex color in game item display names caused garbled or unexpected extra formatting

- **Fix!** Setting prefix to empty in config caused a leading space before all plugin messages - messages now display cleanly with no extra space when prefix is blank - **Optimize!** Reduced plugin file size by ~35% (from ~2.2MB to ~1.4MB)

- **New!** Minecraft 26.1 support - **Fix!** Chat text and player head textures silently fell back to low-quality mode on 26.1 servers - **Fix!** False "untested version" warning in server console on Minecraft 26.1 - **Fix!** Double-refund exploit - **Fix!** Winner loses money when economy is temporarily unavailable - **Fix!** Betting limit bypass via reconnect - **Fix!** Win/loss stats occasionally missing from leaderboards - **Fix!** Stats not always saved correctly under high server load - **Fix!** Refunds for players with multiple pending games of different currencies not all verified - **Fix!** Game results not broadcast when a player disconnects mid-animation - **Fix!** Game list accidentally closes other plugins' inventory menus - **Fix!** Player's game list permanently breaks after crashing while cancelling a game - **Fix!** Plugin crashes when a player disconnects at the exact moment a game result is being recorded or during the roll animation - **Fix!** Incorrect active game count shown in admin info when bot games are running - **Fix!** Plugin may fail to start cleanly if config.yml is corrupted on the first load attempt - **Optimize!** Reloading the plugin with /cf reload no longer briefly freezes the server when active games are in progress - **Optimize!** Memory usage stays stable on long-running servers

- **New!** Filter and sort buttons now show all available options in the lore with the current selection highlighted - **New!** Right-click on filter/sort/currency buttons to cycle backward (left-click still cycles forward) - **New!** Dynamic sort options display works on all 3 cycling buttons: main menu filter, leaderboard filter, and leaderboard currency selector - **New!** Sort options display is fully customizable via config - **New!** Game item lore is now role-aware - the game creator only sees "Right-click to cancel" and buyers only see "Left-click to accept" - **New!** <amount> placeholder now works inside game item lore lines - **New!** <maxpage> placeholder now available in navigation button labels - **New!** Leaderboard now supports a flexible slot layout - **New!** Leaderboard player heads now show all stats at once - **New!** All stats are available as placeholders in the leaderboard config - **Optimize!** ExcellentEconomy balance checks, deposits, and withdrawals are now faster - **Optimize!** GUI menu transitions are now smooth and instant - **Optimize!** GUI click cooldown reduced from 200ms to 50ms - **Optimize!** Leaderboard player heads now load faster on repeated opens - **Optimize!** Leaderboard no longer shows a loading barrier when switching filters - **Optimize!** Reopening the leaderboard is instant for up to 3 minutes after the first load - **Fix!** ExcellentEconomy currency could fail to initialize on servers where plugins load in a different order - **Fix!** ExcellentEconomy error messages now correctly appear in the server console log instead of being silently swallowed - **Fix!** Switching from the Create menu to the anvil amount input no longer shows a brief close animation - **Fix!** History GUI back button could cause a visual flicker when returning to the main menu - **Fix!** Coinflip roll GUI was briefly unprotected when opening for both players - **Fix!** Leaderboard player heads with Base64 skin type were showing a blank head instead of the configured texture - **Fix!** Leaderboard empty slot items configured with a Base64 player head skin were ignoring the texture and showing a plain head - **Fix!** Confirming a custom amount in the anvil and returning to the create menu had a brief inventory flash

- New! Added **ExcellentEconomy support** - CoinsEngine has been renamed to ExcellentEconomy, UltraCoinFlip now auto-detects and supports both the new ExcellentEconomy plugin and the legacy CoinsEngine plugin using the same coinsengine.yml config - Fix! Fixed a money duplication exploit where players could lose a coinflip, disconnect quickly, reconnect, and get their money refunded back - Fix! Rolling coinflip games are now unregistered immediately when the result is finalized - Fix! Bot coinflip games now properly remove refund backups after win/loss resolution

- **Fix!** Bot game not working when heads-tails selection is enabled - **Fix!** House mode (bot game) being lost when entering a custom bet amount via anvil or chat input

- **New!** Added "refund-restore-delay" setting in config.yml - **New!** Added "refund" debug category - **Fix!** Players not receiving their currency back after disconnecting from a coinflip game - **Fix!** Refund message showing "You received X back" but money not actually appearing in balance - **Fix!** Refund backups being deleted even when the currency deposit failed

- **New!** Added 6 new languages - Lithuanian, Portuguese (Brazil), Polish, Turkish, Korean, and Japanese - **New!** Update checker notifications can now be toggled separately for console and in-game - set notify-console and notify-in-game in config.yml (both default to true) - **Fix!** Heads/Tails selection menu now shows the coin side buttons correctly - players can choose heads or tails normally when creating a coinflip - **Fix!** Invalid bet amount messages can now be fully translated - server owners can edit the text in language files instead of seeing hardcoded English - **Fix!** Leaderboard stat labels (Wins, Profit, Largest Win, Worst Profit, Winstreak) can now be translated - edit the new labels section in leaderboard.yml

- **Fix!** Fixed heavy GUI debug blocks causing overhead - **Fix!** Fixed player-head Base64 textures not applying to some GUI items (e.g., History back button) - **Fix!** Fixed user-added config keys (e.g., player-head section) being deleted from GUI YAML files after /cf reload - **Optimize!** Reduced MSPT spikes when spam-clicking GUI items - reflection method lookups are now cached instead of running on every click - **Optimize!** Strengthened GUI anti-spam protection - click cooldown is enforced and redundant cursor-clearing operations were removed from hot paths

- **Fix!** Fixed GUI stats text (Wins/Losses/Profit/Loss/Net) reverting to English after /cf reload when editing gui/mainmenu.yml

- **Fix!** Fixed "Your Statistics" button not showing the player's skull in the main menu - player head now renders correctly on all Paper versions

- **Fix!** Fixed plugin crashes on Folia/Canvas servers when players enter a custom bet amount in chat - custom amount input now works correctly on all server forks - **Fix!** Fixed hex color codes (e.g., &#FFCF96) not displaying correctly in GUI and messages - hex colors now render properly on all server versions - **Fix!** Fixed custom bet amount input leaking to global chat and DiscordSRV - other players no longer see the amount you type when entering a custom bet - **Fix!** Fixed plugin crashes on reload when using CoinsEngine without Vault - currency system now initializes correctly regardless of whether Vault is installed - **Fix!** Fixed Anvil GUI not opening on Folia/Canvas servers - plugin now automatically falls back to chat input on Folia servers without errors or warnings - **Fix!** Fixed player heads showing as skeleton skulls on 1.8.8 servers - player heads configured with type "Player" now correctly display the player's skin, affects game list, history, navigation buttons, and bot button - **Fix!** Fixed player heads showing as blank/steve after creating a bet on Paper 1.21+ servers - player skins now display correctly in the game list using the proper Paper skin API - **Fix!** Fixed GUI buttons not rendering in the Create CoinFlip GUI - increase/decrease amount buttons now display their configured colors (red/green) and materials correctly on all servers - **Fix!** Fixed currency selection GUI items not displaying titles correctly - currency item names now show properly - **Optimize!** Improved text formatting compatibility - special color codes from external plugins no longer cause display errors

- **Fix!** Fixed GUI not opening and items not showing - all GUI menus now display correctly - **Fix!** Fixed /cf reload command errors - reload command now works without crashes - **Fix!** Fixed bet against bot errors - entering bet amount in chat now works correctly - **Fix!** Fixed coinflip game finishing error - GUI now closes properly after winning/losing - **Fix!** Fixed GUI reopening bug - menu stays closed when you cancel a coinflip - **Fix!** Fixed all button actions and messages on 1.8.8 - no more "null" errors when clicking buttons - **Optimize!** Improved performance on older servers - faster loading and better stability

- **New!** Added automatic compatibility detection - plugin automatically adapts to different server versions without manual configuration - **New!** Added fallback text system - all messages and GUI text display correctly on any server version - **Fix!** [CRITICAL] Fixed GUI not opening on 1.8.8 servers - coinflip GUI now works correctly on all server versions including PandaSpigot and other 1.8.8 forks - **Fix!** [CRITICAL] Fixed plugin crashes on 1.8.8 servers - plugin no longer crashes when starting up on servers without Adventure API - **Fix!** Fixed TokenManager currency not working - TokenManager integration now works correctly with the latest API - **Fix!** Fixed GUI reopening after canceling game - GUI no longer reopens unexpectedly when players cancel their coinflip games - **Fix!** Fixed mouse cursor jumping to center - cursor stays in position after canceling coinflip games - **Optimize!** Improved admin workflow - Visual dashboard is much faster and easier to read than scrolling through text - **Optimize!** Reduced console spam - Admins can monitor server status via GUI instead of running repeated /cf audit commands - **Optimize!** Better organization - All audit GUI settings consolidated in one centralized configuration file

- **New!** Modern GUI Dashboard for /cf audit command - Beautiful visual interface replaces plain chat output for easier monitoring - **New!** Real-time monitoring with auto-refresh - Live updates every second without needing to reopen the GUI - **New!** 9 visual status indicators with color-coded materials - See active games, rolling games, players in transaction, refund status, pending logs, global lock, reloading status, active refunds, and games processing at a glance - **New!** Fully customizable GUI via audit.yml config file - Change all materials, slots, messages, and settings to match your server style - **Optimize!** Improved admin workflow - Visual dashboard is much faster and easier to read than scrolling through text - **Optimize!** Reduced console spam - Admins can monitor server status via GUI instead of running repeated /cf audit commands - **Optimize!** Better organization - All audit GUI settings consolidated in one centralized configuration file

- **Fix!** Plugin now works on Spigot servers

- **New!** Game Event Commands - Run custom console commands when coinflip events occur (game created, game started, player wins, player loses, game cancelled) - **New!** Configure different commands for each currency type - Vault, PlayerPoints, TokenManager, BeastTokens, CoinsEngine, and custom placeholder currencies all support independent event command configurations - **New!** 15+ placeholders available in event commands - %player%, %opponent%, %winner%, %loser%, %amount_bet%, %winnings%, %tax%, %losses%, and formatted variants like %winnings_formatted% - **New!** Delay support for commands - Use [delay:TICKS] prefix to delay command execution (20 ticks = 1 second), useful for timed rewards or delayed notifications - **New!** PlaceholderAPI integration - Event commands support PlaceholderAPI placeholders if installed on your server - **New!** Per-event toggle - Enable or disable commands for each event type independently (on-created, on-start, on-win, on-lose, on-cancelled) - **New!** Perfect for server integration - Track statistics with external plugins, give consolation rewards to losers, trigger webhooks, run custom announcements, and more - **Fix!** Create GUI not updating when clicking +/- buttons - Amount now updates immediately when clicking increase/decrease buttons instead of only updating after game creation - **Fix!** Currency format display - Non-Vault currencies (PlayerPoints, Coins, Tokens, etc.) now display with proper spacing (e.g., "100 Points" instead of "100Points"), Vault currencies remain unchanged

- **Fix!** Fixed plugin blocking ALL inventory interactions - Click handling and drag handling now only applies to plugin GUIs, no longer affects chests, creative mode inventory, player inventory, or item splitting

- **New!** **Daily/Weekly Betting Limits** feature - Control your server economy by limiting how much players can bet per day or week - **New!** Permission bypass - Give "**ultracoinflip.bypass.bettinglimit**" permission to VIP players or admins to bypass all limits - **Fix!** Fixed **click cooldown blocking ALL inventory interactions** - Click cooldown now only applies to plugin GUIs, no longer affects chests, creative mode inventory, or player inventory - **Optimize!** Limit checks happen before currency withdrawal, preventing wasted operations

- **Optimize!** Faster game list loading - Game filtering and sorting is now cached, making the game list GUI much faster to open - **Optimize!** Reduced server lag - GUI operations now reuse objects instead of creating new ones, reducing server load - **Optimize!** Better performance on busy servers - Game list updates are now smarter and only refresh when needed - **Optimize!** Improved GUI responsiveness - Players will notice faster GUI loading, especially when there are many active games

- **New!** Click cooldown protection - Players can no longer spam-click GUI buttons, preventing lag and potential exploits (100ms cooldown) - **Optimize!** Faster GUI updates - Multiple inventory updates are now batched together, reducing server load significantly - **Optimize!** Player head caching - Player heads in GUIs are now cached, making leaderboards and game lists load much faster - **Optimize!** Automatic memory management - All caches automatically clean up old data to prevent memory issues - **Optimize!** Better performance on large servers - GUIs now perform much better even with many active games and players

Changelog: - **New!** Added detection logic to identify when balance check fails due to reserve balance requirement vs. actual insufficient balance - **New!** Added detailed error messages for reserve balance issues - shows minimum reserve required, current balance, and maximum bet allowed - **Fix!** Error messages now properly distinguish between insufficient balance and reserve balance issues, providing clearer guidance to players - **Fix!** Fixed confusing error messages when reserve balance requirement prevents betting - error messages now clearly explain the minimum reserve balance requirement instead of showing misleading "insufficient funds" message

- **New!** Smart exploit detection system - automatically detects and reports potential exploit attempts with rate limiting to prevent console spam - **New!** Exploit detection logs to dedicated file (exploit-detection.log) for security audit trail - **New!** Configurable exploit detection settings in config.yml - enable/disable console logging, file logging, and admin notifications - **Fix!** **[CRITICAL SECURITY]** Fixed currency duplication exploit via join game race condition - **Fix!** Added withdraw verification - plugin now verifies that balance actually decreased after withdraw to prevent exploits where withdraw returns success but money isn't deducted - **Fix!** Added deposit verification - **Fix! [CRITICAL SECURITY]** Fixed double-click exploit on join game - **Fix!** Added game restoration on failed join

- **New!** Added Play with Bot feature - players can now play coinflip games against the server bot instead of waiting for other players - **New!** Bot games include full animation GUI with customizable bot head and name - bot head texture and display name can be configured in config files - **New!** Bot games support all notification types - players receive title, actionbar, and bossbar notifications when playing with bot (same as player vs player games) - **New!** Bot game statistics display in main menu - main menu now shows total games played with bot, win rate against bot, and profit from bot games in real-time - **New!** Smart tab completion for bet amounts - command now suggests common bet amounts (100, 500, 1k, 5k, 10k, 50k, 100k, 500k, 1M, 5M, 10M) when creating games - **New!** Dynamic bot subcommand tab completion - tab completion automatically updates when bot subcommand name is changed in config - **New!** Bot games are tracked separately from player vs player games - bot games have their own statistics and can be filtered in history - **New!** Configurable bot game limits - administrators can set daily game limits and delay between bot games per player - **New!** Bot game permissions - separate permissions for using bot feature, bypassing daily limits, and bypassing delay between games - **New!** Bot head display in main menu - main menu button now uses player head with bot texture instead of diamond for better visual consistency - **New!** Added leaderboard button in main menu - players can now quickly access leaderboard GUI from main menu (fully customizable material, title, and lore) - **New!** Added comprehensive user-specific settings system - players can now customize all coinflip messages and notifications to their preferences - **New!** Settings GUI (/cf settings or /cf toggle) - fully customizable GUI with toggleable settings using LIME_DYE (enabled) and GRAY_DYE (disabled) materials - **New!** 17 toggleable settings available for messages and notifications - Game Created, Game Joined, Game Won, Game Lost, Game Cancelled, Bot Game, Game Result Broadcast, Consecutive Wins, Error Messages, Title, Actionbar, Bossbar, Game Start Sound, Consecutive Win Sound, Animation Sound, General Notification Sounds - **New!** Settings are stored per-player in database - settings persist across server restarts and reloads - **New!** Settings caching system - fast, in-memory cache with async database operations for optimal performance - **New!** Permission bypass system - administrators can bypass all settings or specific settings using permissions (ultracoinflip.settings.bypass and ultracoinflip.settings.bypass.<setting-key>) - **New!** Settings integration throughout plugin - all messages, broadcasts, titles, actionbars, bossbars, and sounds now respect player settings - **New!** Settings GUI features - beautiful toggle UI with checkmarks for enabled and crosses for disabled, customizable title format, back button to return to main menu, filler slots with borders - **New!** Settings automatically cleared from memory when players disconnect to optimize server performance - **Fix!** Fixed transaction logs spamming console - transaction logs now only display in console when enabled in config (default: false to reduce console spam), file logging still works for audit purposes - **Fix!** Fixed history GUI not displaying bot name and texture correctly - bot games in history now use the same bot name and texture configured in config files, matching the animation GUI - **Fix!** Fixed tab completion for /cf create command - now properly suggests currencies for type parameter and amounts for amount parameter - **Fix!** Fixed GUI item persistence bug - when cancelling a game via right-click, the game item now immediately disappears from the GUI instead of remaining visible - **Fix!** Fixed GUI auto-refresh logic - GUI now properly refreshes when games are cancelled or created - **Fix!** Fixed settings GUI toggle bugs - settings now toggle immediately on first click, settings no longer reset when clicking other settings, settings GUI now displays correct toggle state immediately after changes - **Fix!** Fixed blank lore lines in GUI - blank lines in lore configuration now properly display as empty lines in-game - **Fix!** Fixed filter button not cycling - filter button in main menu now properly cycles through filter types (None, Your Currency, All Currencies) with immediate visual feedback

- **New!** Added allow-close-during-animation option in config.yml - administrators can now control whether players can close GUI during coinflip animation (default: true, game continues in background when GUI is closed) _When allow-close-during-animation is set to false, closing GUI during animation will cancel the game and refund both players - prevents players from accidentally closing GUI and losing their bet_ - **New!** Added comprehensive 1.8.8 sound ID documentation to sounds.yml dded comprehensive 1.8.8 sound ID documentation to sounds.yml - **Fix!** Fixed sounds not working on 1.8.8 servers - plugin now automatically converts modern sound names (e.g., ENTITY_PLAYER_LEVELUP) to legacy sound names (e.g., LEVEL_UP) when running on 1.8.8 servers, users no longer need to manually change sound names in config

- **New!** Added /cf audit command for administrators to monitor plugin status (active games, transactions, locks) - **New!** Added transaction log file (transactions.log) for detailed audit trail of all currency movements - **New!** Added RefundLimiter system for centralized transaction management and abuse prevention - **New!** Added fully customizable messages for all anti-dupe, currency error, and admin audit messages in language files - **New!** Added complete 1.8.8 material ID documentation to all GUI configuration files - users can now easily configure materials for 1.8.8 servers using the legacy format (e.g., STAINED_GLASS_PANE:14 for red glass) - **New!** All GUI config files now include helpful comments with examples for both modern servers (1.13+) and legacy servers (1.8.8-1.12.2) - makes it easy to configure materials for any server version - **Fix!** Fixed currency duplication exploit - players can no longer exploit the refund system to duplicate money, added transaction locking to prevent multiple refund attempts, added 3-second cooldown between cancel commands to prevent spam abuse, all transactions are now logged for admin audit purposes, currency is now safely restored if payment fails, plugin now blocks refunds during config reload to prevent issues - **Fix!** Fixed double refund when both players disconnect at the same time during coinflip animation - players will only receive one refund each - **Fix!** Fixed plugin blocking ALL inventory interactions (chests, creative mode, etc.) - plugin now only handles its own GUI events without affecting other inventories - **Fix!** Fixed GUI not automatically updating when new games are created on Paper 1.21.x servers - players with the list GUI open will now see new games appear immediately without needing to close and reopen the GUI - **Fix!** Fixed GUI refresh overwriting other GUIs - when players are viewing the coinflip animation, refreshing the list GUI will no longer interrupt their game - **Fix!** Fixed coinflip animation not running on Paper 1.21.x servers - animation now displays correctly and shows the winner properly - **Fix!** Fixed plugin crashes when opening GUI on 1.8.8 servers (PandaSpigot) - GUI auto-refresh now works correctly on all server versions without errors - **Fix!** Fixed /cf delete command causing disconnect.spam kick when used with extra arguments - **Optimize!** Improved server performance with better game list caching (using AtomicInteger) - **Optimize!** Added automatic memory cleanup every 30 minutes to prevent memory buildup over time - **Optimize!** Added detailed transaction logs for server administrators to track all currency movements - **Optimize!** Reload command now blocks new refunds during reload to prevent race conditions - **Optimize!** Improved GUI refresh performance - GUI only refreshes when players actually have the list GUI open, reducing unnecessary updates - **Optimize!** Enhanced border animation colors on 1.8.8 servers - rainbow and other color animations now display correctly with proper color values

- **New!** Full Minecraft 1.8.8 support - plugin now runs smoothly on servers from 1.8.8 to 1.21.x without any errors - **New!** Rainbow border animations work correctly on 1.8.8 - all animation colors display properly in coinflip GUI - **New!** Action bar messages now work on 1.8.8 servers - players see action bar notifications during gameplay ​​​​​​- **Fix!** Fixed plugin crashes when opening GUI on 1.8.8 servers - improved compatibility for inventory operations across all versions - **Fix!** Fixed colored glass panes showing white instead of configured colors in GUI on 1.8.8 - glass colors now display correctly (black, gray, red, lime, etc.) - **Fix!** Fixed titles and messages showing technical data instead of formatted text on 1.8.8 - titles and chat messages now display properly with colors - **Fix!** Fixed title display not working on 1.8.8-1.10 servers - titles now show correctly on all server versions - **Fix!** Fixed plugin crashes when creating player heads on 1.8.8 - player head creation now works across all versions - **Fix!** Fixed plugin errors when creating coinflip games on 1.8.8 - game creation now works properly - **Fix!** Fixed offhand swap exploit not being blocked on 1.8.8 - GUI protection now works correctly on all versions - **Fix!** Fixed some items not loading correctly on 1.8.8 (sunflower, oak sign icons) - item materials now work across all versions - **Fix!** Fixed plugin startup errors on 1.8.8 due to missing text libraries - text formatting now works on all legacy versions - **Fix!** Fixed garbled special characters in console on 1.8.8 servers - console output now displays correctly with ASCII fallback - **Fix!** Fixed color codes like &l, &8, &a not working in GUI titles on 1.8.8 - all color codes now parse correctly - **Fix!** Fixed GUI buttons not responding to clicks on 1.8.8 - button interactions now work properly on all versions - **Fix!** Fixed players being able to take items from GUI on 1.8.8 - GUI protection fully functional across all versions - **Fix!** Fixed YAML parsing errors on 1.8.8 - removed unsupported Unicode characters from config files - **Fix!** Fixed player profile features causing errors on 1.8.8 - player profiles work correctly with fallback for older servers - **Optimize!** Improved performance on legacy servers - reduced overhead from version compatibility checks - **Optimize!** GUI rendering optimized for all versions - faster item creation with proper color handling - **Optimize!** Cached GUI templates - game item and stats lore loaded once for better performance on busy servers - **Optimize!** Database queries optimized - added indexes for faster leaderboard loading on large databases - **Optimize!** Improved error handling - invalid database data no longer causes plugin crashes

- **Optimize!** Cached game behavior config values (cancel-game-on-disconnect, refund-on-disconnect, keep-coinflip-on-disconnect) - eliminates repeated config reads when players disconnect, improving performance on busy servers - **Optimize!** PlayerListener now uses cached config values from CoinFlipManager instead of reading config file on every player quit event

• **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

• **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

- **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

- 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

- **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

- **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

- **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

- **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

- **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 - **Fix!** Fixed NullPointerException in reloadLanguage() when config is null - added null check before accessing config.getString() to prevent crashes when config fails to load - **Fix!** Fixed language not updating correctly - messages are now properly reset when language changes, ensuring the correct language file is loaded instead of using cached messages from previous language - **Fix!** Fixed missing UUID validation in MySQLDatabaseManager.getAllBackups() - added try-catch to handle invalid UUIDs gracefully, preventing crashes when database contains corrupted UUID data - **Fix!** Fixed potential memory leak in animation system - scheduledRollItems and cached heads are now properly cleared when animation stops or GUI closes - **Fix!** Improved race condition handling in CoinFlipManager.getGame() - now attempts to retrieve another game if the first one was removed between check and get operations - **Fix!** Fixed memory leak in animation tasks - animation tasks are now properly cancelled when GUI closes or players disconnect - **Fix!** Fixed race condition in game creation - added synchronized block to ensure atomic validation and creation, preventing bypass of game limits - **Fix!** Fixed potential NullPointerException in animation schedule - added null checks to prevent null items in scheduled animation list - **Fix!** Optimized Gson instance creation - replaced repeated new Gson() calls with cached static final GSON instance in both SQLiteDatabaseManager and MySQLDatabaseManager, reducing object allocation overhead - **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 - **Optimize!** Improved SQL query construction - replaced string concatenation with StringBuilder for complex leaderboard queries (getTopPlayersByProfitFromLogs and getTopPlayersByWorstProfitFromLogs), reducing intermediate string object creation - **Optimize!** Cached additional config values in CoinFlipRollGUI.setupBorders() - eliminated redundant config reads for arrow slots, border display name, border material, and circular arrow slots - **Optimize!** Reduced ItemStack cloning overhead - winner/loser heads are now cached and reused instead of being cloned repeatedly - **Optimize!** Cached config values in HeadsTailsSelectionGUI - eliminated redundant config reads by caching values during construction - **Optimize!** Improved animation task scheduling - tasks now check animationRunning flag before executing to prevent unnecessary execution after animation stops - **Optimize!** Reduced memory usage in animation system - cached player heads reduce garbage collection pressure

[~] Fix Folia compatibility error [~] Fix color code error in console with UpdateChecker message

[+] Add UpdateChecker feature

First release!