CoinFlip Plugin

Overview

CoinFlip is a GUI‐driven coin flip plugin for Spigot/Paper that hooks into EssentialsX economy. Create, join, and resolve coin flip games with an interactive dashboard, animation, and chat summaries—perfect for adding quick bets and excitement to your server!

Features

• Commands
  • /coinflip or /cf
    • Opens the main dashboard GUI
  • /coinflip create <amount>
    • Creates a new game, supports suffixes: k (thousand), m (million), b (billion), t (trillion)
  • /coinflip delete
    • Deletes your pending game and refunds your bet
  • /coinflip reload (ops‐only)
    • Reloads config.yml without a server restart
• Main Dashboard GUI (36 slots)
  • Player‐head icons for each active game
  • Barrier “No Games” placeholder when empty
  • ◀ Previous & ▶ Next page navigation
  • 📖 Statistics book icon (prints your wins/losses/profit in chat)
  • ★ Create Game star button
• Game Builder GUI (36 slots)
  • Red/Green wool for configurable –/+ bet increments
  • Center sign showing current bet total
  • Anvil icon opens chat for custom amount entry
  • Finish (slime) button finalizes creation
• Flip Animation
  • Configurable GUI size, cycle count, and tick interval
  • Alternates between the two player heads on a barrier background
• End‐Game Summary
  • Private DM to both players
  • Correctly displays WINNER (green) or LOSER (red)
  • Shows bet amount, winner name, and loser name
• Economy Integration
  • Uses EssentialsX /eco take & /eco give
• Restrictions
  • One pending flip per player
  • Inventory dragging/clicking disabled except on interactive buttons

Permissions

• coinflip.reload
  • Reload the plugin config (config.yml)
  • Default: OP only

Configuration (config.yml)

gui:
  main-title: "&fCoinflip Dashboard"
  builder-title: "&fCoinflip | Game Builder"

limits:
  min-bet: 100
  max-bet: 9999999

increments:
  values: [100, 500, 1000]

animation:
  title: "&fCoinflip | Flipping Coin..."
  size: 27
  cycles: 15
  interval: 3