# VxCoinflip

## What is VxCoinflip?

​ The Ultimate Premium Coinflip Experience ​ Looking to add a thrilling, lag-free gambling system to your server? VxCoinflip is a modern, high-quality betting plugin that allows players to wager their money or custom currencies against each other in a clean 50/50 game of chance. Built with performance, deep customization, and premium RPG aesthetics in mind, it is the perfect money sink for any economy.

​

## **​ Key Features​** ​

Player vs. Player Betting: Players can wager currency against each other with a fair, true 50/50 chance to take home the pot. ​

Anti-Spam & Auto-Refunds: Strictly limits players to one active game at a time. If a player hosts a game and decides to join someone else's instead, their hosted game is automatically cancelled and refunded. ​

Smart Betting Limits: Set configurable minimum and maximum bet limits to keep your server's economy balanced and controlled. ​

Economy Tax System: Apply an optional, configurable tax percentage taken from the winning pot to act as a powerful server money sink. ​

Custom Chat Input: Players can seamlessly click a button in the GUI to type exact wager amounts directly into the chat for precise betting. ​

Smart Broadcasting: Configurable thresholds ensure that only high-roller wins (over a specific amount) are broadcasted to the entire server. ​ Dynamic Menus & Visuals ​ ​

100% Configurable GUIs: Every menu utilizes an innovative grid-based format. Completely redesign layouts, add custom glass borders, and change items without touching any Java code. ​

Live Coinflip Animation: Features a thrilling, dedicated animation GUI that alternates between player heads before landing on the winner, keeping players on the edge of their seats. ​

Hex & Gradient Support: Fully supports MiniMessage formatting (e.g., `<gradient:#C68800:#FCCE01>`) for beautiful, modern RPG aesthetics across all menus and chat messages. ​

Immersive Sound Design: Satisfying sound effects are mapped to menu clicks, errors, victories, defeats, and even spectator ticks. ​

Automatic Pagination: The main panel seamlessly generates multiple pages if there are dozens of active games going on at once. ​ Economy & Statistics ​ ​

Multi-Currency Support: Fully supports Vault for standard money, but can effortlessly support custom currencies (like "Coins" or "Tokens") right from the creation menu. ​

Advanced Stat Tracking: Tracks lifetime stats for every player viewable directly in the GUI, including Wins, Losses, Win Rate %, Net Profit, Total Gambled, and Total Lost. ​

PlaceholderAPI Integration: Hook your stats into scoreboards, holograms, and tab lists with a full suite of `%vxcoinflip_...%` placeholders. ​ Backend Performance & Admin Tools ​ ​

Enterprise Database Support: Includes HikariCP connection pooling with out-of-the-box support for both local flatfile (H2) and remote network databases (MySQL) for flawless performance.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vortexstudio-1.gitbook.io/vortexstudio-docs/vxcoinflip.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
