CoinFlips

---

• 🎮 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.

---

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 |

---

| 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 |

---

| 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 |

---

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