LevelStar is a lightweight Spigot/Paper plugin that adds a level system based on experience points gained through PvP. Designed especially for crystal PvP practice servers, it rewards players with points for defeating opponents. Once enough points are collected, players level up, with their levels displayed in customizable colors.

⚠️ Before Installing

Make sure you have the following plugins installed:

• PlaceholderAPI → required
• TAB by NEZNAMY → for displaying levels in the TAB list
• LuckPerms → for prefixes/suffixes support
• LPC → (optional) → a chat formatter plugin (built on LuckPerms) that lets you display placeholders like %levelstar_level% directly in chat.

Without PlaceholderAPI, the placeholders (%levelstar_level%, %levelstar_level_raw%) will not work.

Features

• Gain points on kill, automatically added toward leveling.
• Fully configurable levels, points, and colors via config.yml.
• Level-up messages: private or broadcast to the whole server.
• PlaceholderAPI support:
• %levelstar_level% → level with color formatting
• %levelstar_level_raw% → raw integer level
• Data stored using SQLite.

points:
  per_kill: 200
  per_level: 5000
max-level: 2000
min-level: 1
level-format: "{level} ★"
level-up-message: "&aYou leveled up! {display}!"
level-up-message-type: "private"

levels:
  "1-10": "#AAAAAA"
  "11-20": "#00FF00"
  "21-30": "#00AAFF"

If using the default config (25 kills | 1 level):

• Level 1 → 0 pts | 0 kills
• Level 10 → 45,000 pts | 225 kills
• Level 50 → 245,000 pts | 1,225 kills
• Level 100 → 495,000 pts | 2,475 kills
• Level 200 → 995,000 pts | 4,975 kills
• Level 500 → 2,495,000 pts | 12,475 kills
• Level 1000 → 4,995,000 pts | 24,975 kills
• Level 1500 → 7,495,000 pts | 37,475 kills
• Level 2000 → 9,995,000 pts | 49,975 kills

Show Level on TAB (with TAB plugin)

To display player levels on the TAB list you can use the TAB by NEZNAMY

1. Install TAB plugin on your server.
2. Go to: /plugins/TAB/groups.yml
3. Edit the DEFAULT section like this:

_DEFAULT_:
  tabprefix: "&7[%levelstar_level%&7] %luckperms-prefix%" # Shows level on TAB
  tagprefix: "%luckperms-prefix%" # Optional: show level above player name
  customtabname: "%player%"
  tabsuffix: "%luckperms-suffix%"
  tagsuffix: "%luckperms-suffix%"

Now each player will see their LevelStar level directly in the TAB list.

LevelStar requires Paper/Spigot 1.21+ and optionally supports PlaceholderAPI for placeholders. The plugin provides a simple command /levelstar reload to reload the configuration, which requires the permission levelstar.reload.