AS CoinFlip – Minecraft Plugin

AS CoinFlip 1.0.0 — 1v1 Coinflip Gambling Plugin for Paper 1.21+

AS CoinFlip is a complete 1v1 coinflip betting system for Minecraft servers. Players wager a chosen amount using the server's economy, another player joins through a clean graphical interface, and an animated coin flip determines the winner. The winner receives the entire prize pool minus an optional configurable server tax. Everything works with your existing economy plugin — AS CoinFlip does not create or print its own currency.

What this plugin does

Adds the [ICODE]/coinflip[/ICODE] command (aliases: [ICODE]/cf[/ICODE], [ICODE]/cflip[/ICODE]), opening a GUI showing every active public coinflip. Players create a bet using [ICODE]/coinflip create [currency][/ICODE] — the wager is withdrawn immediately and safely held until the game finishes or is cancelled. Another player joins simply by clicking the creator's icon inside the GUI, and a synchronized coin flip animation begins for both players. The winner receives the full prize pool (bet ×2) minus the configured tax, and the result is announced in chat. Automatic refunds are issued if the game expires, the creator disconnects, or [ICODE]/coinflip delete[/ICODE] is used before another player joins.

GUI & User Experience

Paginated Active Games GUI with player heads, bet amount, currency and remaining join time. The built-in player statistics panel displays wins, losses, win/loss ratio, total earnings and current win streak. A personal notification toggle ([ICODE]/coinflip toggle[/ICODE]) allows players to mute global broadcasts. Includes a refresh button, page navigation, empty-state view and different styling for your own coinflips and other players' games. Full language support included: English, Polish, German, Spanish and French.

Animation System

Three reveal styles are available inside [ICODE]config.yml[/ICODE]:

Bar — horizontal CS:GO style scrolling bar. Spin — classic spinning coin animation. Wheel — colorful spinning wheel that lands on the winner.

Configurable animation duration, slowdown curve and reveal delay. Fully synchronized animations ensure both players see the exact same result on the same tick. Configurable sounds for every stage: menu open, click, join, flip, tick, reveal, victory, defeat and cancellation. The GUI header always displays Player 1 vs Player 2, bet amount, total prize pool, tax percentage and final payout.

Economy & Currency Support

Built-in support for:

Vault (EssentialsX, CMI, EconomyX and every Vault-compatible economy) PlayerPoints TokenManager CoinsEngine ExcellentEconomy BeastTokens Built-in Token Wallet (no additional plugin required) PlaceholderAPI-based currencies (define balance, withdraw and deposit using placeholders and console commands)

Each currency can be configured independently with its own display name, icon, minimum bet, maximum bet, enabled/disabled state and default flag.

Tax System

Supports progressive tax brackets per currency (for example: 2% up to 1,000, 5% up to 10,000, 7.5% up to 100,000, 10% above) or a flat percentage. Taxes can be disabled individually for each currency. Collected taxes may either be deposited into a configured account or simply removed from the economy.

Anti-Abuse & Integrity

Configurable creation cooldown (15 seconds by default) with bypass permission for staff. Configurable public game timeout (120 seconds by default); expired games automatically refund the creator. One active coinflip per player. Players cannot join their own game. Busy-state protection prevents players from entering multiple games simultaneously. Idempotent payout system guarantees the winner is paid exactly once even during lag or interrupted animations. Disconnect handling safely refunds the creator if nobody has joined yet. Startup dependency validation skips missing economy providers with a clear console warning instead of disabling the plugin.

Storage

Pluggable storage backend:

YAML (default) SQLite MySQL

SQL backends use HikariCP connection pooling with configurable pool size. Stores player statistics (wins, losses, earnings and streaks) as well as notification preferences.

Permissions

[ICODE]coinflip.use[/ICODE] — Access [ICODE]/coinflip[/ICODE] and the GUI (default: true) [ICODE]coinflip.create[/ICODE] — Create coinflips (default: true) [ICODE]coinflip.join[/ICODE] — Join other players' coinflips (default: true) [ICODE]coinflip.toggle[/ICODE] — Toggle personal notifications (default: true) [ICODE]coinflip.admin[/ICODE] — Reload and administration commands (default: op) [ICODE]coinflip.bypass.cooldown[/ICODE] — Bypass creation cooldown (default: op) [ICODE]coinflip.*[/ICODE] — Grants every permission above

Broadcasts

[ICODE]broadcast-new[/ICODE] — Enable or disable "New Coinflip Available" broadcasts. [ICODE]broadcast-result[/ICODE] — Enable or disable winner broadcasts. [ICODE]show-tax-msg[/ICODE] — Optionally display the tax percentage in result messages.

PlaceholderAPI Expansion (Optional)

[ICODE]%coinflip_wins%[/ICODE] [ICODE]%coinflip_losses%[/ICODE] [ICODE]%coinflip_ratio%[/ICODE] [ICODE]%coinflip_earned%[/ICODE] [ICODE]%coinflip_streak%[/ICODE]

Commands

[ICODE]/coinflip[/ICODE] — Opens the Active Games GUI. [ICODE]/coinflip create [currency][/ICODE] — Creates a public coinflip. [ICODE]/coinflip delete[/ICODE] — Cancels your active coinflip and refunds your bet. [ICODE]/coinflip toggle[/ICODE] — Enables or disables personal notifications. [ICODE]/coinflip reload[/ICODE] — Reloads configuration and language files.

Why use AS CoinFlip?

A fair and transparent PvP gambling system for Survival, SkyBlock, Prison, Factions and Economy servers with a built-in server tax system. Progressive tax brackets allow higher taxation on large bets without punishing smaller wagers. One plugin supports cash, tokens, gems, points and custom currencies. Asynchronous storage, safe payouts and automatic refunds make AS CoinFlip ready for production servers.