# Bounty Plugin

A comprehensive Minecraft bounty system plugin for Spigot and Paper servers.

## Version Compatibility
- Minecraft versions: **1.8.x - 1.21.x**
- Server types: Spigot, Paper

## Features

### Core Bounty System
- Place bounties on players using in-game money
- Bounty stacking: multiple players can add to existing bounties
- Anonymous bounties: hide who placed the bounty
- Automatic expiry system with configurable duration
- Full refund on bounty expiry

### Economy Integration
- Vault dependency for economy management
- Works with any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
- Configurable min/max bounty amounts
- Transaction safety with rollback capabilities

### GUI System
- Beautiful interactive menu to browse active bounties
- Pagination for large bounty lists
- Sort by amount, player name, or timestamp
- Fully customizable items and lore

### Leaderboards & Statistics
- Top bounty hunters (most successful claims)
- Top targets (most bounties placed on them)
- Highest single payouts tracking
- Kill streak system

### Anti-Abuse Features
- Immunity system for protected players
- Cooldown system to prevent spam
- Permission-based controls
- Self-bounty prevention

### Storage Options
- **YAML**: Simple file-based storage (default)
- **SQLite**: Embedded database for medium servers
- **MySQL**: External database for large networks

## Installation

1. Download `Bounty-1.0.0.jar` from the `target/` folder
2. Install Vault plugin on your server
3. Install an economy plugin (EssentialsX recommended)
4. Place the jar in your server's `plugins/` folder
5. Restart your server
6. Configure the plugin in `plugins/Bounty/config.yml`

## Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/bounty add <player> <amount>` | Place a bounty on a player | `bounty.use` |
| `/bounty check [player]` | Check bounty on yourself or another player | `bounty.check` |
| `/bounty remove <player>` | Remove a bounty (admin only) | `bounty.remove` |
| `/bounty list` | Open the bounty GUI | `bounty.list` |
| `/bounty top` | View leaderboards | `bounty.top` |
| `/bounty reload` | Reload configuration | `bounty.reload` |

## Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `bounty.use` | Place bounties | All players |
| `bounty.check` | Check bounty information | All players |
| `bounty.list` | View bounty list GUI | All players |
| `bounty.top` | View leaderboards | All players |
| `bounty.remove` | Remove bounties (admin) | Operators |
| `bounty.reload` | Reload plugin | Operators |
| `bounty.immune` | Cannot have bounties placed on them | Operators |
| `bounty.anonymous` | Place anonymous bounties | All players |
| `bounty.*` | All permissions | Operators |

## Configuration

The plugin creates three main configuration files:

### config.yml
Main configuration including:
- Database settings (YAML/SQLite/MySQL)
- Economy limits (min/max amounts)
- GUI customization
- Bounty expiry duration
- Cooldown settings
- Reward settings

### lang.yml
All user-facing messages:
- Command feedback
- Error messages
- GUI text
- Placeholders support

## Database Setup

### YAML (Default)
No setup required - works out of the box.

### SQLite
```yaml
database:
type: SQLITE
sqlite:
file: bounties.db
```

### MySQL
```yaml
database:
type: MYSQL
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: password
pool-size: 10
```

## Support

For issues or questions:
- Check the configuration files first
- Make sure Vault and an economy plugin are installed
- Verify permissions are set correctly

## Credits

**Author**: ROTIxSUBJE
**Version**: 1.0.0
**API**: Spigot/Paper 1.8-1.21.x