Описание
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 - 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 |
|-------------|---------|------|
| **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 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](https://github.com/byteful/LevelTools/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 ` | Reset hand item for player | `leveltools.admin` |
| `/leveltools reset --all` | Reset all items for player | `leveltools.admin` |
| `/leveltools xp ` | Set hand item XP | `leveltools.admin` |
| `/leveltools 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](https://github.com/byteful/LevelTools/wiki/Developer-API).**
## 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](https://github.com/byteful/LevelTools/wiki/Configuration)
- [Trigger Profiles](https://github.com/byteful/LevelTools/wiki/Trigger-Profiles)
- [Reward Profiles](https://github.com/byteful/LevelTools/wiki/Reward-Profiles)
- [Display Profiles](https://github.com/byteful/LevelTools/wiki/Display-Profiles)
- [Item Profiles](https://github.com/byteful/LevelTools/wiki/Item-Profiles)
