OxCoinFlip 💵

A modern, GUI-based coin flip gambling plugin for Paper servers with Vault economy support.

Create a wager, choose heads or tails, and let another player challenge it. The result is a fair 50/50 coin flip, with the winner receiving the combined pot minus an optional tax.

Features: 💎

Fair 50/50 heads-or-tails outcomes Vault economy integration Interactive GUI for active wagers Animated coin flip screen Up to 3 active wagers per player Maximum wager amount of 100,000,000 Configurable minimum bet, maximum bet, tax, messages, sounds, and GUI icons Players cannot accept their own wagers All active wagers appear in the lobby Wager creator chooses heads or tails Challenger automatically receives the opposite side Winner receives the combined pot minus configurable tax Safe balance checks before wagers begin Instant refunds when a wager is removed Protection against duplicate wager acceptance Protection against item movement, dragging, shift-clicking, and hotbar swaps in plugin menus, MiniMessage formatting and styled messages.

Commands
/cf
Opens the active coin flip lobby.

/cf create <heads|tails> <amount>
Creates a coin flip wager.

Example:

/cf create heads 1000
/cf remove <number>
Removes one of your active wagers and refunds the amount.

/coinflip Alias for /cf.

### How It Works: 🕹

Create a wager with /cf create heads|tails <amount>.
Your balance is charged immediately and the wager appears in the lobby.
Another player opens /cf and clicks your wager.
The challenger pays the matching wager amount.
A 50/50 coin flip animation plays for both players.
The winner receives the full pot, minus the configured tax.

### Requirements: 🕯

Paper 1.21.1 or compatible server version papermc (26.1.2) 
Java 21 or newer 26
Use Plugins such Vault,EssentialsX
A Vault-compatible economy plugin, such as EssentialsX Economy. 

### Installation: ❓

Download OxCoinFlip.jar.
Place it in your server's plugins folder.
Install Vault and an economy provider.
Restart the server.
Edit plugins/OxCoinFlip/config.yml to customize settings.

### Default Settings: 🔧

game: min-bet: 100.0 max-bet: 100000000.0 max-active-wagers: 3 tax-percentage: 5.0

### Configuration Which You can customize: 🔩

*Minimum and maximum wager amounts
Maximum active wagers per player
Tax percentage
Animation duration and speed
GUI materials and icons
Sounds and sound volume
All player-facing messages*

### Notes 📝

**Players cannot challenge their own wagers.
Each player can have a maximum of 3 active wagers.
The maximum bet is 100,000,000 by default.
Wager outcomes are randomly generated with an even 50/50 chance for heads or tails.**