Skip to content

Reward Profiles

Jump to bottom
Rudra edited this page Jan 2, 2026 · 1 revision

Reward Profiles (reward_profiles.yml)

Reward profiles define what happens when an item reaches a specific level. Rewards can include enchantments, commands, and attribute modifications.

File Location

plugins/LevelTools/reward_profiles.yml

Structure

profiles:
  profile_id:
    levels:
      1:
        - "enchant2 efficiency 1"
      5:
        - "enchant2 efficiency 2"
        - "command broadcast {player} reached level 5!"
      10:
        - "enchant2 efficiency 3"
        - "attribute generic.attack_speed 0.5"

Reward Handlers

Each reward line follows the format: handler argument1 argument2 ...

enchant

Adds an enchantment, overriding the existing level.

- "enchant efficiency 3"

If the item has Efficiency 5, it will become Efficiency 3.

enchant2

Adds an enchantment only if the new level is higher than existing.

- "enchant2 efficiency 3"

If the item has Efficiency 5, nothing happens. If it has Efficiency 2, it becomes Efficiency 3.

Recommended for most use cases to prevent accidental downgrades.

enchant3

Adds to the existing enchantment level.

- "enchant3 efficiency 1"

If the item has Efficiency 2, it becomes Efficiency 3.

command

Runs a command as console.

- "command give {player} diamond 1"
- "command broadcast {player} leveled up their tool!"

Placeholders:

  • {player} - Player name
  • {level} - New level
  • {item} - Item type

player-command

Runs a command as the player.

- "player-command spawn"

player-opcommand

Runs a command as the player with temporary OP permissions.

- "player-opcommand specialplugin enchant"

Use with caution. The OP permission is removed immediately after execution.

attribute

Modifies an item attribute.

- "attribute generic.attack_speed 0.5"
- "attribute generic.attack_damage 2"

See Attribute Reference for valid attributes.

Default Profiles

tools

Used by pickaxes, axes, and shovels.

Level Rewards
1 Efficiency I
3 Efficiency II
5 Efficiency III
8 Efficiency IV
10 Efficiency V
11-15 Unbreaking I-III
20 Mending I
24-30 Fortune I-III
40+ Efficiency VI+ (beyond vanilla)
100 Efficiency X, Fortune V

swords

Used by swords.

Level Rewards
1 Sharpness I
3 Sharpness II
5 Sharpness III
8 Sharpness IV
10 Sharpness V
11-15 Unbreaking I-III
20 Mending I
24-30 Looting I-III
40+ Sharpness VI+
100 Sharpness X, Looting V

bows

Used by bows and crossbows.

Level Rewards
1 Power I
10 Power V
11-15 Unbreaking I-III
20 Mending I
24-30 Punch I-III
50 Flame I
100 Power X, Infinity I

fishing_rods

Used by fishing rods.

Level Rewards
1 Lure I
5 Luck of the Sea I
10 Lure II
15 Unbreaking I
25 Lure III
35 Luck of the Sea III
50 Mending I

Creating Custom Profiles

Example: Combat tool with attribute bonuses

profiles:
  elite_swords:
    levels:
      1:
        - "enchant2 sharpness 1"
      10:
        - "enchant2 sharpness 5"
        - "attribute generic.attack_speed 0.2"
      25:
        - "enchant2 fire_aspect 2"
        - "command broadcast &6{player} &eunlocked &cFire Aspect&e!"
      50:
        - "enchant2 sharpness 7"
        - "attribute generic.attack_damage 2"
        - "command give {player} experience_bottle 10"

Reference Links

Clone this wiki locally