UltraCoinFlip

 **[★ DISCORD SUPPORT ★](http://discord.gg/GGDxDnpnDP)** **UltraCoinFlip** is the most advanced and feature-rich **coinflip gambling plugin** for Minecraft servers. Bring the thrill of **high-stakes gambling** to your server. Players create and join coinflip games, betting their in-game currency against each other. Every flip is powered by a **cryptographically secure random algorithm**, guaranteeing provably fair outcomes. Ideal for **economy, survival, skyblock, factions, prison**, and any server looking to boost player engagement. *Why choose UltraCoinFlip over other coinflip plugins?* - **Most feature-rich** coinflip plugin available - **Optimized performance** with smart caching and async operations - **Actively maintained** with regular updates and new features - **17 languages** ready to use - **Free & Fastest support** via Discord --- ## ⭐ Features - **Multi-currency support**: Vault, [PlayerPoints](https://www.spigotmc.org/resources/playerpoints.80745/), [TokenManager](https://www.spigotmc.org/resources/tokenmanager.8610/), [BeastTokens](https://www.spigotmc.org/resources/beasttokens-custom-currency.20806/), [CoinsEngine](https://www.spigotmc.org/resources/coinsengine-%E2%AD%90-economy-and-custom-currencies.84121/), and PlaceholderAPI with unlimited custom currencies - **Database support**: SQLite and MySQL with HikariCP connection pooling - **Comprehensive statistics**: Track wins, losses, profit, net profit, and winstreaks with 60+ PlaceholderAPI placeholders - **Leaderboard system**: Top 15 players with customizable GUI, filter by wins/losses/profit/largest win/winstreak - **Winstreak tracking**: Consecutive wins for each player, resets on loss - **Dynamic tax system**: Tier-based tax rates based on bet amount - **Fully customizable GUI**: Layout, items, colors, animations, all visual elements - **Discord webhook integration**: Send game results to your Discord server - **Folia compatible**: Full support for Paper's Folia server software - **High performance**: Smart caching, batch updates, async operations, minimal resource usage - **Game history**: Complete game history with custom GUI and advanced filtering - **Security features**: Anti-exploit protection, automatic refunds, backup system, transaction safety - **Anvil GUI input**: Alternative to chat input for better user experience - **Multiple notifications**: Title, ActionBar, BossBar, and Sound notifications - **Per-currency config**: Enable/disable tax, min/max bets, settings per currency - **World restrictions**: Restrict currencies by world (whitelist/blacklist) and permissions - **Amount formatting**: Supports k, M, B, T (thousands, millions, billions, trillions) - **Player settings**: 17 toggleable settings for messages and notifications - **Play with Bot**: Play against server bot with customizable name, head, and animations - **Private coinflips & invites**: Invite specific players with clickable `[Accept]` / `[Deny]` chat buttons, lock games invite-only, optional persistence across server restart - **Betting limits**: Daily/weekly limits per player per currency with permission bypass - **Earnings & loss limits**: Cap cumulative win/loss per period with smart auto-tune from real activity data - **Public developer API**: Other plugins can integrate via JitPack with events, queries, and custom currency hooks - **Smart update notifications**: Severity-aware GitHub release alerts, [CRITICAL] fixes stand out from cosmetic ones - **Admin dashboard**: Real-time monitoring GUI for server status and active transactions - **17 Languages**: 🇬🇧 English, 🇻🇳 Vietnamese, 🇫🇷 French, 🇳🇱 Dutch, 🇷🇺 Russian, 🇨🇳 Chinese (Simplified), 🇹🇼 Chinese (Traditional), 🇪🇸 Spanish, 🇩🇪 German, 🇸🇦 Arabic, 🇮🇹 Italian, 🇱🇹 Lithuanian, 🇧🇷 Portuguese (Brazil), 🇵🇱 Polish, 🇹🇷 Turkish, 🇰🇷 Korean, 🇯🇵 Japanese --- ## 📝 Commands | Command | Description | |---------|-------------| | `/coinflip` | Open the coinflip menu | | `/coinflip help` | Display all available commands | | `/coinflip create ` | Create a new coinflip game | | `/coinflip create bot` | Play against the server bot | | `/coinflip delete` | Cancel your active coinflip game | | `/coinflip invite ` | Invite a specific player with clickable Accept/Deny in chat | | `/coinflip uninvite ` | Remove a player from your invite list | | `/coinflip accept [id]` | Accept a coinflip invite (id optional with single pending) | | `/coinflip deny [id]` | Deny a coinflip invite | | `/coinflip private [on\|off]` | Toggle invite-only mode on your coinflip | | `/coinflip reload` | Reload plugin configuration | | `/coinflip history` | View your game history | | `/cf settings` | Open player settings GUI | | `/cf leaderboard` | View top players leaderboard | | `/cf stats [player]` | View player coinflip statistics | | `/cf limit me` | View your earnings/loss limits and current usage | | `/cf limit player ` | Staff: view another player's limits | | `/cf limit reset ` | Admin: reset a player's earnings in the current period | | `/cf limit auto-tune ` | Admin: suggest cap values from your last 30 days of activity | | `/cf audit` | Admin dashboard (real-time monitoring) | --- ## 🔑 Permissions | Permission | Description | Default | |------------|-------------|---------| | `ultracoinflip.use` | Use basic coinflip commands | true | | `ultracoinflip.reload` | Reload plugin configuration | op | | `ultracoinflip.admin` | Access admin commands | op | | `ultracoinflip.command.menu` | Use `/cf` (open the main menu) | true | | `ultracoinflip.command.create` | Use `/cf create` | true | | `ultracoinflip.command.delete` | Use `/cf delete` | true | | `ultracoinflip.command.history` | Use `/cf history` | true | | `ultracoinflip.command.leaderboard` | Use `/cf leaderboard` | true | | `ultracoinflip.command.settings` | Use `/cf settings` | true | | `ultracoinflip.command.stats` | Use `/cf stats` | true | | `ultracoinflip.command.help` | Use `/cf help` | true | | `ultracoinflip.command.invite` | Use `/cf invite` and `/cf uninvite` | true | | `ultracoinflip.command.accept` | Use `/cf accept` and `/cf deny` | true | | `ultracoinflip.command.private` | Use `/cf private` | true | | `ultracoinflip.silent` | Disable notifications | false | | `ultracoinflip.bypass.tax` | Bypass tax, receive full winnings | false | | `ultracoinflip.bypass.bettinglimit` | Bypass daily/weekly betting limits | false | | `ultracoinflip.limit.me` | View your own earnings/loss limits | true | | `ultracoinflip.limit.staff` | View other players' earnings/loss limits | op | | `ultracoinflip.admin.limit` | Reset / auto-tune earnings limits | op | | `ultracoinflip.house.use` | Use "play with bot" feature | true | | `ultracoinflip.house.bypass.limit` | Bypass daily bot game limit | false | | `ultracoinflip.house.bypass.delay` | Bypass delay between bot games | false | | `ultracoinflip.stats.others` | View other players' stats | false | | `ultracoinflip.settings.bypass` | Bypass all player settings | false | --- ## 📊 PlaceholderAPI Placeholders (60+) ### Basic Statistics - `%coinflip_wins%` — Total wins - `%coinflip_losses%` — Total losses - `%coinflip_total_games%` — Total games played - `%coinflip_winstreak%` — Current winstreak ### Win Percentage - `%coinflip_winrate%` — Overall win percentage - `%coinflip_winrate_formatted%` — Win percentage with % symbol - `%coinflip_winrate_%` — Winrate for specific currency - `%coinflip_winrate__formatted%` — Winrate for specific currency with % symbol *Supported currencies: `money`, `playerpoints`, `tokenmanager`, `beasttokens`, and custom placeholder currencies.* ### Profit Tracking - `%coinflip_profit_%` — Total profit - `%coinflip_loss_%` — Total loss - `%coinflip_net_profit_%` — Net profit (profit - loss) - `%coinflip_profit__formatted%` — Formatted profit - `%coinflip_loss__formatted%` — Formatted loss - `%coinflip_net_profit__formatted%` — Formatted net profit *Currencies: `money` (alias: `m`), `playerpoints` (`pp`), `tokenmanager` (`tm`), `beasttokens` (`bt`).* ### Combined Statistics - `%coinflip_total_profit%` — Total profit across all tracked currencies - `%coinflip_total_loss%` — Total losses across all tracked currencies - `%coinflip_total_net%` — Total net profit across all tracked currencies ### Player Ranking - `%coinflip_position%` — Player's rank by wins (default) - `%coinflip_position_wins%` — Player's rank by wins - `%coinflip_position_losses%` — Player's rank by losses - `%coinflip_position_winstreak%` — Player's rank by winstreak - `%coinflip_position_profit_%` — Player's rank by profit - `%coinflip_position_largest-win_%` — Player's rank by largest win - `%coinflip_position_worst-profit_%` — Player's rank by worst profit ### Leaderboard - `%coinflip_top____name%` — Top player name - `%coinflip_top____value%` — Top player value - `%coinflip_top____value_formatted%` — Formatted value - `%coinflip_top__wins_name%` — Top player by wins - `%coinflip_top__losses_name%` — Top player by total losses - `%coinflip_top__winstreak_value%` — Top player's winstreak - `%coinflip_leaderboard_refresh_in%` — Live countdown to the next leaderboard cache refresh (e.g. `2m20s`). Format customizable in `config.yml` *Filters: `wins`, `losses`, `profit`, `largest-win`, `worst-profit`, `winstreak`.* *Optional period: add `daily`, `weekly`, `monthly` or `yearly` after the filter, e.g. `%coinflip_top_1_wins_monthly_name%` (no period = all-time).* ### Custom Currency Placeholders - `%coinflip_coinsengine__unit%` — CoinsEngine currency unit - `%coinflip_coinsengine__display%` — CoinsEngine currency display name - `%coinflip_placeholder__unit%` — Custom currency unit - `%coinflip_placeholder__display%` — Custom currency display name - `%coinflip__unit%` — Custom currency unit (short format) - `%coinflip__display%` — Custom currency display name (short format) - `%coinflip_winrate_%` — Winrate for custom placeholder currency - `%coinflip_winrate__formatted%` — Winrate with % symbol --- ## 🔌 Developer API Other plugins integrate via JitPack: ```xml com.github.hiiamken UltraCoinFlip-API 5.1.0 provided ``` Full integration guide (Gradle, listener examples, all 9 events, API stability promise): [github.com/hiiamken/UltraCoinFlip-API](https://github.com/hiiamken/UltraCoinFlip-API) --- ## 📋 Requirements | Requirement | Version | |-------------|---------| | **Java** | 8 or higher | | **Server** | 1.8.x – 26.2 (Spigot / Paper / Folia) | | **Required** | Vault + Economy plugin (EssentialsX, CMI, etc.) | | **Optional** | PlaceholderAPI, PlayerPoints, TokenManager, BeastTokens, ExcellentEconomy (CoinsEngine) | ---