# 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."
```