CoinFlips

!Features

!CoinFlips !Paper

---

• 🎮 Interactive CoinFlip Game: Create and join heads or tails games with custom bets via an intuitive GUI.
• 🖥️ Fully Configurable GUI: Every menu (main, create, join, stats, top) is driven entirely by guis.yml — patterns, items, actions, textures, all configurable.
• 📊 Statistics System: Track wins, losses, ratio, total bet and profit per player.
• 🏆 Leaderboard: Display top players by profit with custom player head textures for empty slots.
• 🤖 Discord Webhook: Automatic embed notifications on game creation, win and loss — fully configurable titles, descriptions and colors.
• 🔌 PlaceholderAPI Support: Use placeholders to display stats in scoreboards, holograms and other plugins.
• ⏱️ Cooldown System: Prevents abuse with a configurable delay between game creations.
• 🔒 Private Games: Create password-protected games to play with a specific player.
• 📢 Automatic Broadcast: Announces wins to the whole server with configurable messages.
• 💾 Database Support: H2, SQLite or MySQL — choose what fits your server.
• 🔄 Update Notifier: Automatically checks for new versions and notifies admins on join.
• 🛠️ Admin Commands: Reload config, bypass bet limits and more.

---

!Commands

Player Commands

Command	Description
/cf	Opens the main menu
/cf create <amount>	Creates a new game with the specified bet
/cf join <id>	Joins an existing game by its ID
/cf cancel	Cancels your current waiting game
/cf stats [player]	Displays your or another player's statistics
/cf top	Shows the leaderboard
/cf private <amount>	Creates a private game
/cf help	Shows command help

Admin Commands

Command	Description
/cf reload	Reloads the configuration

---

!Perms

Permission	Description	Default
coinflips.use	Use player commands	true
coinflips.create	Create games	true
coinflips.join	Join games	true
coinflips.stats	View statistics	true
coinflips.top	View the leaderboard	true
coinflips.private	Create private games	true
coinflips.reload	Reload the configuration	op
coinflips.bypass	Bypass bet min/max restrictions	op
coinflips.admin	All admin permissions	op

---

!Placeholders

Placeholder	Description
%coinflip_wins%	Number of player victories
%coinflip_losses%	Number of player defeats
%coinflip_ratio%	Win ratio in percentage
%coinflip_profit%	Total player profit
%coinflip_total_bet%	Total amount bet
%coinflip_games_active%	Number of active games waiting

---

!Configs

prefix: '<gradient:#FCEF00:#FFF652><bold>CoinFlips</bold></gradient> &7» '

database: # h2, sqlite or mysql
  type: h2

private-games:
  enabled: true
  password-length: 4

number-formatting:
  mode: 0 # 0 = formatted (1,000), 1 = short (1K), 2 = raw (1000.00)

update-notifier:
  enabled: true
  on-join: true

discord:
  enabled: false
  webhook-url: 'https://discord.com/api/webhooks/your-webhook-url'
  embed:
    create:
      title: 'New Coinflip!'
      description: '{player} created a coinflip for {amount} {currency}.'
      color: 3447003
      footer: 'Coinflips'
    win:
      title: 'Coinflip Won!'
      description: '{player} won a coinflip of {amount} {currency}!'
      color: 65331
      footer: 'Coinflips'
    lose:
      title: 'Coinflip Lost!'
      description: '{player} lost a coinflip of {amount} {currency}.'
      color: 15158332
      footer: 'Coinflips'

coinflip:
  min-bet: 1000
  max-bet: 100000000
  cooldown: 5
  win-chance: 50
  multiplier: 2