🪙 CoinFlip — Advanced Gambling System

⚠️ Warning: Vault plugin required

CoinFlip is a complete and modern gambling plugin that allows players to bet their money in a heads or tails game with smooth animations, detailed statistics, and competitive leaderboards.

---

⚙️ Main Features

• 🎲 Complete CoinFlip system
  Bet your money and try to double it with a simple heads or tails game.

• 💰 Configurable betting limits
  Set minimum and maximum bet amounts.

• 💸 Customizable tax system
  Apply a configurable tax on winnings.

• 🎞️ Smooth coin flip animation
  Clean animation with a slow reveal for maximum suspense.

• 📊 Detailed player statistics
  Track wins, losses, win ratio, and net profit.

• 🏆 Advanced leaderboards
  Compete for top positions based on wins, games played, winnings, profit, and ratio.

• 🕒 Game history (in development)
  View previous CoinFlip games.

• 🔗 PlaceholderAPI support
  Use CoinFlip data anywhere on your server.

• 🏦 Vault economy integration
  Fully compatible with all Vault-supported economy plugins.

• 🛠️ Fully configurable
  Menus, limits, messages, and settings via config.yml and language files.

---

🌈 Color Support

• 🎨 Supports & and § color codes
• 🌈 HEX colors (e.g. #00ff99)
• 🏷️ Custom named colors (e.g. <yellow>, <soft_yellow>, <vibrant_red>)
• 🌅 Gradients gradient:#FFD700:#FFA500Text</gradient>

---

🎨 GUI Experience

• ✨ Modern and clean graphical interface
• 🧩 Fully configurable menus (titles, sizes, items, slots, materials)
• 🔄 Real-time updates when CoinFlips are created or joined
• 🪙 Smooth coin flip animation

---

💻 Commands

Command	Description
/coinflip	Open the main menu
/coinflip create <amount>	Create a new CoinFlip
/coinflip join [id]	Join an existing CoinFlip
/coinflip cancel	Cancel your pending CoinFlip
/coinflip stats [player]	View player statistics
/coinflip top	View leaderboards
/coinflip reload	Reload configuration
/coinflip help	Display help

---

🔗 PlaceholderAPI

👤 Personal Statistics

• %cf_wins% → Number of wins
• %cf_losses% → Number of losses
• %cf_total_games% → Total games played
• %cf_win_percentage% → Win percentage
• %cf_total_winnings% → Total money won
• %cf_total_losses% → Total money lost
• %cf_net_profit% → Total net profit
• %cf_best_win% → Biggest single win

🏆 Leaderboards (Top 10)

• Available types: wins, games, winnings, profit, ratio