LevelUP Reward

Minecraft 版本： 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： paper

标签： game-mechanics management utility

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