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

---

🔑 Permissions

---

📊 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

---