Description
Gallery
Changelog
Versions
Support/Help Server: https://discord.gg/G8BDgqsuyw
Wiki: https://github.com/byteful/LevelTools/wiki
A plugin that adds a leveling system to any item.
Features
- Supports versions 1.8 to latest.
- Supports Folia.
- No dependencies.
- Super efficient, no lag.
- Simple developer API.
- Profile-based configuration system.
- Any item can level up with custom triggers.
- Commands & enchants on level up.
- Supports blacklisting/whitelisting for blocks, entities, and items.
- ActionBar notifications.
- Item lore modification.
LevelTools v2.0 introduces a modular profile-based configuration system. Instead of > hardcoded tool types, you can now configure any item to level up.
Profile Types
| Profile Type | Purpose | File |
|---|---|---|
| Trigger Profiles | Define how XP is gained | trigger_profiles.yml |
| Reward Profiles | Define rewards per level | reward_profiles.yml |
| Display Profiles | Define name, lore, action bar | display_profiles.yml |
| Item Profiles | Tie everything together | item_profiles.yml |
Trigger Types
BLOCK_BREAK- XP when breaking blocksENTITY_KILL- XP when killing entitiesFISHING- XP when catching itemsRIGHT_CLICK/LEFT_CLICK- XP on clickCONSUME- XP when consuming itemsFARMING- XP when tilling soil and breaking plants
Default Supported Items
Out of the box, LevelTools supports:
- Pickaxes, Axes, Shovels (block mining)
- Swords, Bows, Crossbows (combat)
- Fishing Rods (fishing)
- Hoes (farming)
Add any item by creating custom profiles. See the Wiki for details.
Commands
| Command | Description | Permission |
|---|---|---|
/leveltools help |
Shows command help | None |
/leveltools reload |
Reloads configuration | leveltools.admin |
/leveltools reset <player> |
Reset hand item for player | leveltools.admin |
/leveltools reset <player> --all |
Reset all items for player | leveltools.admin |
/leveltools xp <amount> |
Set hand item XP | leveltools.admin |
/leveltools level <level> |
Set hand item level | leveltools.admin |
/leveltools levelup |
Increase hand item level by 1 | leveltools.admin |
/leveltools debug |
Show debug information | leveltools.admin |
Developer API
View detailed API usage here.
PlaceholderAPI
| Placeholder | Description |
|---|---|
%leveltools_level% |
Item level (main hand) |
%leveltools_xp% |
Current XP (main hand) |
%leveltools_max_xp% |
XP needed for next level |
%leveltools_progress% |
Progress percentage |
Wiki
Full documentation available at: https://github.com/byteful/LevelTools/wiki
All Versions
+ Add Version
[2.2.0] LevelTools - RPG Item Leveling 2.2.0
by byteful on Oct 15, 2026
Download
# Changes
- Support for MC 26.3
- Configurable XP formulas: global, per permission (leveltools.formula.<id>), and per item profile
- Added force_nbt option, tool data migrates between NBT and PDC automatically
- Added option for player-planted crops to give farming XP once fully grown
- Added option to block enchanted books on LevelTools items in anvils
- Old configs are automatically updated with the new options (backup is saved)
- Melons, pumpkins, sugar cane, cactus, bamboo, kelp and mushrooms now give farming XP
- Tilling only gives XP when the block is actually tilled
- Levels can no longer exceed max_level through commands or anvils
- Fixed level rewards not running again after a reset
- Fixed cancelled block placements and multi-block placements (doors, beds) not being tracked correctly
- Fixed tools not losing durability when gaining XP from kills, fishing and armor
- Fixed level-up sound volume/pitch being swapped
- Misc bug fixes
- Dependency updates
[2.1.2] [v2.1.2] MC 26.1 Support
by byteful on Oct 15, 2026
Download
# Changes
- Support for MC 26.1.2
- Misc bug fixes
- Dependency updates
[2.1.1] [v2.1.1] Armor & multi-trigger profiles
by byteful on Oct 15, 2026
Download
# Changes
- Native support for detecting armor durability as a trigger type
- Allow configuring multiple trigger profiles for an item profile.
- Dependency updates
[2.1.0.1] LevelTools - RPG Item Leveling 2.1.0.1
by byteful on Oct 15, 2026
Download
# Changes
- Fixed support for old Minecraft versions
- Fixed support for non-Paper forks
[2.1.0] LevelTools - RPG Item Leveling 2.1.0
by byteful on Oct 15, 2026
Download
# Changes
- Added default configuration for tridents
- Added default configuration for hoes
- Added FARMING trigger type
- Improved developer API
[2.0.0] [v2.0.0] A New Era
by byteful on Oct 15, 2026
Download
# Changes
LevelTools has been improved a lot. Enjoy!
- Completely new configuration system
- Profile system (display profiles, item profiles, reward profiles, etc)
- View everything at [Wiki](https://github.com/byteful/LevelTools/wiki)
- Automatic migration so no worries
- Dependency updates
- Improved Folia support
- Fishing rod support
LevelTools has been improved a lot. Enjoy!
[1.4.0.2] LevelTools - RPG Item Leveling 1.4.0.2
by byteful on Oct 15, 2026
Download
# Changes
- Actually fixed concurrency error with saving block data.
- Updated dependencies.
[1.4.0.1] LevelTools - RPG Item Leveling 1.4.0.1
by byteful on Oct 15, 2026
Download
# Changes
- Fixed concurrency error with saving block data.
- Fixed reset command permission check.
- Updated dependencies
[1.4.0] LevelTools - RPG Item Leveling 1.4.0
by byteful on Oct 15, 2026
Download
# Changes
- Folia support
- 1.21 support
- New player placed block system
- Dependency updates
- Max level bug fix
[1.3.8] LevelTools - RPG Item Leveling 1.3.8
by byteful on Oct 15, 2026
Download
# Changes
- Add hex color support (Ex:
&#xxxxxx) - Update some dependencies
[1.3.7] LevelTools - RPG Item Leveling 1.3.7
by byteful on Oct 15, 2026
Download
# Changes
- Fixes a bug that only occurs on 1.20.5/6
[1.3.6.1] LevelTools - RPG Item Leveling 1.3.6.1
by byteful on Oct 15, 2026
Download
# Changes
- Command bug fix
- Formatting change in startup message
[1.3.6] LevelTools - RPG Item Leveling 1.3.6
by byteful on Oct 15, 2026
Download
# Changes
Ex: 'leveltools.booster.2' will give a 2x booster to anyone with the permission
Ex: 'leveltools.booster.1.5' will give a 1.5x booster to anyone with the permission
Ex: '100 + {current_level} * 100' is the default formula in config.yml
Please update your configurations to support this new value!
- Permissions-based XP booster system
- New formula configuration for flexible next XP values
Ex: 'leveltools.booster.2' will give a 2x booster to anyone with the permission
Ex: 'leveltools.booster.1.5' will give a 1.5x booster to anyone with the permission
Ex: '100 + {current_level} * 100' is the default formula in config.yml
Please update your configurations to support this new value!
[1.3.5.2] LevelTools 1.3.5.2
by byteful on Oct 15, 2026
Download
# Changes
- Fix a bug where rewards would keep applying
