# 💰 BountyHunter

_Put a price on their head — then collect when they fall._

## ✨ Overview
BountyHunter lets players spend their coins to place bounties on other players. When a bountied player is killed, the killer collects the entire pot, and earnings are tracked on a server leaderboard. Every player starts with a coin balance, bounties from multiple placers stack on a single target, and placements and collections can be broadcast to the whole server for maximum tension.

## 📦 Installation
1. Drop `BountyHunter.jar` into your server's `/plugins` folder.
2. Restart the server (built for Minecraft **1.21**, api-version `1.21`).
3. Tune `config.yml` (minimum bounty, starting balance, broadcasts) and players are ready to use `/bounty`.

## ⌨️ Commands

| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/bounty` | BountyHunter main command. Usage: `/bounty <place\|list\|top\|balance>`. `place <player> <amount>` places a bounty, `list` shows all active bounties, `top` shows the hunter leaderboard, and `balance` checks your coins. | `bh` | `bountyhunter.use` |

## 🔑 Permissions
- `bountyhunter.use` — Allows use of `/bounty` commands. Default: **true** (everyone).
- `bountyhunter.admin` — Admin-level BountyHunter access. Default: **op**.

## ⚙️ Configuration
- `min-bounty` (default `10.0`) — the minimum coins required per bounty placement.
- `starting-balance` (default `100.0`) — the coin balance new players begin with.
- `broadcast-bounties` (default `true`) — broadcast bounty placements and collections to the whole server.
- `top-limit` (default `10`) — number of entries shown in `/bounty top`.

## 📖 Full documentation
👉 https://spaleforce.com/wiki/bountyhunter

---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
Bounty Hunter - A price in your head
