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