Skip to content

Display Profiles

Jump to bottom
byteful edited this page Jul 16, 2026 · 2 revisions

Display Profiles (display_profiles.yml)

Display profiles define how leveled items appear to players. This includes the item name, lore, and action bar notifications.

File Location

plugins/LevelTools/display_profiles.yml

Structure

profiles:
  profile_id:
    name:
      enabled: false
      text: "{item} &7- &b{level}"
    action_bar:
      enabled: true
      text: "{progress_bar} &e{xp_formatted}&6/&e{max_xp_formatted}"
    lore:
      enabled: true
      lines:
        - ""
        - "&eLevel: &6{level}"
        - ""
        - "{progress_bar} &e{xp_formatted}&6/&e{max_xp_formatted}"
    progress_bar:
      total_bars: 50
      bar_symbol: '|'
      prefix_symbol: '['
      suffix_symbol: ']'
      prefix_color: '8'
      suffix_color: '8'
      completed_color: 'e'
      placeholder_color: '7'

Placeholders

Available in all text fields (name.text, action_bar.text, lore.lines):

Placeholder Description Example
{level} Current item level 15
{xp} Current XP (raw number) 1523.45
{max_xp} XP needed for next level 1600
{xp_formatted} Current XP with suffixes 1.52K
{max_xp_formatted} Max XP with suffixes 1.60K
{progress_bar} Rendered progress bar string [||||||||------]
{item} Original item name Diamond Pickaxe

PlaceholderAPI

If PlaceholderAPI is installed, the following placeholders resolve against the item in the player's main hand:

Placeholder Description
%leveltools_level% Current item level, or N/A if not a supported tool
%leveltools_xp% Current item XP (raw double)
%leveltools_max_xp% XP required for the next level
%leveltools_progress_bar% Rendered progress bar from the item's display profile
%leveltools_progress% Percent 0-100 (one decimal place)
%leveltools_item_profile% Item profile id, or N/A
%leveltools_max_level% Profile max level, or N/A

Number Formatting

Large numbers are formatted with two decimal places and a suffix: K (thousands), M (millions), B (billions), T (trillions), Q (quadrillions). Examples: 1.50K, 2.30M, 1.10B.

Display Options

Name

name:
  enabled: false
  text: "{item} &7- &b{level}"

Modifies the item's display name. Disabled by default to preserve custom item names.

Action Bar

action_bar:
  enabled: true
  text: "{progress_bar} &e{xp_formatted}&6/&e{max_xp_formatted}"

Shows XP progress above the hotbar when gaining XP. Recommended to keep enabled for player feedback.

Lore

lore:
  enabled: true
  lines:
    - ""
    - "&eLevel: &6{level}"
    - ""
    - "{progress_bar} &e{xp_formatted}&6/&e{max_xp_formatted}"

Adds level/XP info to the item's lore. Each line in the list is a separate lore line.

Progress Bar

progress_bar:
  total_bars: 50
  bar_symbol: '|'
  prefix_symbol: '['
  suffix_symbol: ']'
  prefix_color: '8'
  suffix_color: '8'
  completed_color: 'e'
  placeholder_color: '7'
Option Description Default
total_bars Number of bar characters 50
bar_symbol Character for each bar |
prefix_symbol Character before bar [
suffix_symbol Character after bar ]
prefix_color Color code for prefix 8 (dark gray)
suffix_color Color code for suffix 8 (dark gray)
completed_color Color for filled bars e (yellow)
placeholder_color Color for empty bars 7 (gray)

Color Codes

Progress bar color fields take a single Minecraft color code character (without &), e.g. e for yellow or 8 for dark gray. Standard Minecraft color codes (&0-&f, &l, &n, &o, &r) apply in any text field.

Example Output

The same bar_symbol is used for both filled and empty segments; only the color changes. With default settings at 60% progress, all 50 bars are rendered with completed_color for the first 30 and placeholder_color for the remaining 20.

Default Profile

The default profile:

  • Name: Disabled (preserves original item names)
  • Action Bar: Shows progress bar with XP
  • Lore: Shows level and progress bar
  • Progress Bar: 50 yellow/gray bars

Creating Custom Profiles

Example: Compact display for combat items

profiles:
  combat_display:
    name:
      enabled: true
      text: "&c{item} &7[&6Lv.{level}&7]"
    action_bar:
      enabled: true
      text: "&c+XP &7| {progress_bar}"
    lore:
      enabled: true
      lines:
        - "&8Combat Tool"
        - ""
        - "&7Level: &f{level}"
        - "&7XP: &f{xp_formatted}/{max_xp_formatted}"
    progress_bar:
      total_bars: 20
      bar_symbol: '='
      prefix_symbol: '['
      suffix_symbol: ']'
      prefix_color: '7'
      suffix_color: '7'
      completed_color: 'c'
      placeholder_color: '8'

Example: Minimal action-bar-only display

profiles:
  minimal:
    name:
      enabled: false
      text: ""
    action_bar:
      enabled: true
      text: "&7Lv.&f{level} &8| &e{xp_formatted}&7/&e{max_xp_formatted}"
    lore:
      enabled: false
      lines: []
    progress_bar:
      total_bars: 10
      bar_symbol: '|'
      prefix_symbol: ''
      suffix_symbol: ''
      prefix_color: '7'
      suffix_color: '7'
      completed_color: 'a'
      placeholder_color: '8'

Clone this wiki locally