ServerRewards

# 🏆 ServerRewards v1.0 - The Ultimate Player Progression System

Transform your server with a complete rewards ecosystem that keeps players engaged for hours! A feature-packed plugin that tracks activities, rewards milestones, and offers an exciting in-game shop.

## ✨ Key Features
🔹 Triple Activity Tracking - Earn points for combat, mining, and building
🔹 Massive Rewards Catalog - 75+ rewards across 12 categories
🔹 Smart Milestones - Automatic notifications when reaching point thresholds
🔹 Conversion System - Turn points into server economy money
🔹 Zero Lag - Optimized data handling with auto-save
🔹 Fully Configurable - Customize every aspect of the rewards system
🔹 Vault Compatible - Works with economy plugins

## 🚀 Quick Start

### 📥 Installation
1. Download `ServerRewards.jar`
2. Drop into your server's `plugins/` folder
3. Restart the server - works instantly with default settings
4. (Optional) Edit `config.yml` to adjust point values or rewards

### ⚙️ Core Configuration
```yaml
# Points Configuration
points:
  kill:
    ZOMBIE: 1
    PLAYER: 10
  mine:
    DIAMOND_ORE: 3
    IRON_ORE: 2
  build:
    DIAMOND_BLOCK: 3

# Shop Settings
rewards_shop:
  required_points: 100  # Minimum to access shop
  cooldown_hours: 0.5  # 30-minute cooldown between rewards
  gui:
    title: "&6&lREWARDS SHOP"
    size: 54
```

## 🔑 Permissions
- `serverrewards.admin` - All admin commands (op only)
- `serverrewards.rewards` - Access rewards shop (default: true)
- `serverrewards.convert` - Convert points to money (default: true)

## 💡 Pro Tips
- Perfect for economy servers when combined with Vault
- The 30-minute cooldown balances reward frequency perfectly
- Use `/setpoints` to run special events and competitions
- Great for minigame servers to reward participation

## 📦 Technical Specs
- Minecraft: 1.21+
- Java: 21+
- Dependencies: PaperAPI (included)
- RAM Usage: Under 5MB

📥 Revolutionize your server's progression system today!

## 🆚 Why Choose ServerRewards?
✔ **Player Retention** - Keeps players engaged long-term
✔ **Balanced Economy** - Multiple point types prevent inflation
✔ **Server-Friendly** - Minimal performance impact
✔ **Fully Customizable** - Adapt to any server type

## ⚖️ Recommended Configurations
| Server Type | Point Values | Cooldown | Best For              |
|-------------|-------------|----------|-----------------------|
| Survival    | Medium      | 30min    | Balanced progression  |
| Economy     | High        | 1hr      | Vault integration     |
| Minigames   | Low         | 15min    | Frequent rewards      |
| Creative    | Disabled    | -        | Reward builds only    |

🔗 Full documentation available on GitHub