Logo
UltraCoinFlip
PluginMIT

UltraCoinFlip

UltraCoinFlip allows players to create coin flip games where two players can bet against each other. The winner is determined by a fair, cryptographically secure random system, and the winner takes the pot (minus tax).

2.2K
Downloads
5
Followers
1 months ago
Updated
📦
30
Versions
economyminigamesocialbukkitfoliapaperpurpurspigot
Download Latestv5.5.1View on Modrinth

📖About 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.

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)

bStats