LevelTools - RPG Item Leveling

A plugin that adds a leveling system to any in-game item.

3,85k
Download

LevelTools - RPG Item Leveling

<h5 align="center">Support/Help Server: https://discord.gg/G8BDgqsuyw</h5> <h5 align="center">Wiki: https://github.com/byteful/LevelTools/wiki</h5>

Logo

<h3 align="center">A plugin that adds a leveling system to any item.</h3>

Features

- Supports versions 1.8 - 1.21. - 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.

v2.0.0 - Profile System

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 | |-------------|---------|------| | Item Profiles | Define how XP is gained | `trigger_profiles.yml` | | Item Profiles | Define rewards per level | `reward_profiles.yml` | | Item Profiles | Define name, lore, action bar | `display_profiles.yml` | | Item Profiles | Tie everything together | `item_profiles.yml` |

Trigger Types

- `BLOCK_BREAK` - XP when breaking blocks - `ENTITY_KILL` - XP when killing entities - `FISHING` - XP when catching items - `RIGHT_CLICK` / `LEFT_CLICK` - XP on click - `CONSUME` - XP when consuming items - `FARMING` - 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.

Migration from v1.x

Your old config will be automatically backed up to `old_config.yml` and migrated to the new profile system.

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

- Configuration - Trigger Profiles - Reward Profiles - Display Profiles - Item Profiles

bStats Graph

Gallery

ADS