UltraCoinFlip

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, TokenManager, BeastTokens, CoinsEngine, 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 <currency> <amount>	Create a new coinflip game
/coinflip create <currency> <amount> bot	Play against the server bot
/coinflip delete	Cancel your active coinflip game
/coinflip invite <player>	Invite a specific player with clickable Accept/Deny in chat
/coinflip uninvite <player>	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 <name>	Staff: view another player's limits
/cf limit reset <name>	Admin: reset a player's earnings in the current period
/cf limit auto-tune <currency>	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_<currency>% — Winrate for specific currency
• %coinflip_winrate_<currency>_formatted% — Winrate for specific currency with % symbol

Supported currencies: money, playerpoints, tokenmanager, beasttokens, and custom placeholder currencies.

Profit Tracking

• %coinflip_profit_<currency>% — Total profit
• %coinflip_loss_<currency>% — Total loss
• %coinflip_net_profit_<currency>% — Net profit (profit - loss)
• %coinflip_profit_<currency>_formatted% — Formatted profit
• %coinflip_loss_<currency>_formatted% — Formatted loss
• %coinflip_net_profit_<currency>_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_<currency>% — Player's rank by profit
• %coinflip_position_largest-win_<currency>% — Player's rank by largest win
• %coinflip_position_worst-profit_<currency>% — Player's rank by worst profit

Leaderboard

• %coinflip_top_<rank>_<filter>_<currency>_name% — Top player name
• %coinflip_top_<rank>_<filter>_<currency>_value% — Top player value
• %coinflip_top_<rank>_<filter>_<currency>_value_formatted% — Formatted value
• %coinflip_top_<rank>_wins_name% — Top player by wins
• %coinflip_top_<rank>_losses_name% — Top player by total losses
• %coinflip_top_<rank>_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_<id>_unit% — CoinsEngine currency unit
• %coinflip_coinsengine_<id>_display% — CoinsEngine currency display name
• %coinflip_placeholder_<id>_unit% — Custom currency unit
• %coinflip_placeholder_<id>_display% — Custom currency display name
• %coinflip_<id>_unit% — Custom currency unit (short format)
• %coinflip_<id>_display% — Custom currency display name (short format)
• %coinflip_winrate_<id>% — Winrate for custom placeholder currency
• %coinflip_winrate_<id>_formatted% — Winrate with % symbol

---

🔌 Developer API

Other plugins integrate via JitPack:

<dependency>
    <groupId>com.github.hiiamken</groupId>
    <artifactId>UltraCoinFlip-API</artifactId>
    <version>5.1.0</version>
    <scope>provided</scope>
</dependency>

Full integration guide (Gradle, listener examples, all 9 events, API stability promise): 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)

---