CoinFlipZ Plugin - Casino Games for Minecraft

CoinFlipZ is a comprehensive gambling plugin for Minecraft servers that offers two exciting game modes:

• Coin Flip: 1v1 betting where players can challenge each other to a coin flip
• Roulette: Multi-player roulette table where multiple players can place different types of bets

Features

• Fully integrated with Vault economy
• Interactive GUI for both game modes
• Customizable betting limits and house edge
• Detailed statistics tracking
• Admin controls and monitoring tools
• Grey stained glass themed GUI design

Installation Guide

Prerequisites

• Minecraft server running Spigot/Paper/Bukkit 1.20 or higher
• Vault plugin installed
• An economy plugin compatible with Vault (such as EssentialsX Economy)

Installation Steps

1. Download the CoinFlipZ.jar file
2. Place the jar file in your server's /plugins/ directory
3. Restart your server or use /reload command
4. The plugin will generate default configuration files
5. Use /coinflipz reload to apply any configuration changes

Commands

Player Commands

• /coinflipz or /cfz - Opens the main menu
• /cfz coinflip [amount] - Start a coin flip bet with specified amount
• /cfz roulette - Open the roulette table
• /cfz stats - View your gambling statistics

Admin Commands

• /cfz admin - Opens the admin control panel
• /cfz reload - Reloads the configuration
• /cfz toggle - Enables/disables the plugin
• /cfz reset [player] - Resets a player's statistics

Permissions

• coinflipz.use - Access to basic plugin features
• coinflipz.coinflip - Permission to use coin flip
• coinflipz.roulette - Permission to use roulette
• coinflipz.admin - Access to admin commands

Configuration

The plugin creates a config.yml file with customizable options. See the config section below for details on available settings.

# CoinFlipZ Configuration
# -----------------------

# General settings
enabled: true
debug-mode: false

# Economy settings
min-balance-required: 0.0
house-edge-percentage: 5.0  # The percentage that the house takes from each bet

# Coin Flip settings
coinflip:
  min-bet: 10.0
  max-bet: 10000.0
  # Time in seconds before a coin flip game expires if no one joins
  expiry-time: 300
  # Whether to broadcast new coin flip games to all players
  broadcast-new-games: true
  
# Roulette settings
roulette:
  min-bet: 5.0
  max-bet: 5000.0
  # Payouts for different bet types (multipliers)
  payouts:
    number: 36.0  # 1 in 37 chance (0-36)
    color: 2.0    # Red/Black (18 in 37 chance)
    even-odd: 2.0 # Even/Odd (18 in 37 chance)
    dozen: 3.0    # 1-12, 13-24, 25-36 (12 in 37 chance)
    column: 3.0   # 1st/2nd/3rd column (12 in 37 chance)
    low-high: 2.0 # 1-18, 19-36 (18 in 37 chance)
  
# Database settings (for stats tracking)
database:
  type: SQLite  # SQLite or MySQL
  mysql:
    host: localhost
    port: 3306
    database: coinflipz
    username: root
    password: password
  
# GUI settings
gui:
  title-color: GOLD
  text-color: YELLOW
  background-material: GRAY_STAINED_GLASS_PANE
  
# Message settings
messages:
  prefix: "&6[CoinFlipZ] &e"
  no-permission: "&cYou don't have permission to do that!"
  not-enough-money: "&cYou don't have enough money!"
  coin-flip-created: "&aYou created a coin flip game with a bet of %amount%!"
  coin-flip-joined: "&aYou joined %player%'s coin flip game!"
  coin-flip-won: "&aYou won! &6You received %amount%!"
  coin-flip-lost: "&cYou lost! Better luck next time."
  roulette-bet-placed: "&aYou placed a bet of %amount% on %bet%!"
  roulette-won: "&aYou won! &6You received %amount%!"
  roulette-lost: "&cYou lost! Better luck next time."