LevelUP Reward

LevelUpReward

A plugin for rewarding players when they vanilla level up.

🎯 Key Features

• 🎁 Automatic rewards when leveling up
• 📊 Level ranges with different rewards
• ⚙️ Flexible configuration via config file
• 🎮 Commands for management and information
• 🔄 Config reload without server restart
• 🎯 Placeholder support (%player%, %level%)

📋 Requirements

• Paper 1.20.1+
• Vault (for economy commands)
• PlaceholderAPI (optional, for additional placeholders)

🚀 Installation

1. Download the JAR file
2. Place it in your server's plugins folder
3. Restart the server
4. Configure settings in config.yml

⚙️ Configuration
Default config:

# Reward configuration for level ranges
rewards:
  # Rewards for levels 1-100
  - min-level: 1
    max-level: 100
    executor: console  # console or player
    commands:
      - "give %player% diamond 5"
      - "eco give %player% 1000"
      - "title %player% title \"§aNew Level!\" \"§e+1 level\" 10 40 10"
  
  # Rewards for levels 200-300
  - min-level: 200
    max-level: 300
    executor: player
    commands:
      - "give %player% diamond 10"
      - "give %player% emerald 5"
      - "eco give %player% 5000"
      - "title %player% title \"§aMaster Level!\" \"§eReached level %level%\" 20 60 20"
  
  # Rewards for levels 500+
  - min-level: 500
    max-level: 999999
    executor: console
    commands:
      - "give %player% netherite_ingot 3"
      - "effect %player% saturation 60 1 true"
      - "broadcast %player% reached legendary level %level%!"

Configuration explanation:

• min-level: Minimum level for this reward
• max-level: Maximum level for this reward
• executor: Command executor (console or player)
• commands: List of commands to execute

🎮 Commands
/levelinfo | Show your level and available rewards | levelupreward.info

/levelupreload | Reload plugin configuration | levelupreward.reload

🔐 Permissions

levelupreward.info | Access to /levelinfo command | default - true

levelupreward.reload | Access to /levelupreload command | default -op

🎯 Usage Examples

Example 1: Simple reward

rewards:
  - min-level: 1
    max-level: 10
    executor: console
    commands:
      - "give %player% diamond 1"

Example 2: Complex reward

rewards:
  - min-level: 50
    max-level: 100
    executor: player
    commands:
      - "tell %player% Congratulations on reaching level 50!"
      - "eco give %player% 5000"

Example 3: Using PlaceholderAPI

rewards:
  - min-level: 100
    max-level: 200
    executor: console
    commands:
      - "tell %player% Your balance: %vault_balance%"
      - "tell %player% Your rank: %essentials_rank%"

📝 Logging

The plugin logs all actions:

• Command executions
• Configuration errors
• Config reloads

Example log:

[LevelUpReward] Executed command from console: give Steve diamond 5
[LevelUpReward] LevelUpReward configuration reloaded!

🐛 Issues & Questions

If you encounter issues or have questions:

1. Check server logs
2. Verify configuration is correct
3. Check version compatibility
4. Create an issue on Modrinth