Display Profiles

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:

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.6K
{progress_bar}	Visual progress bar	[||||||||------]
{item}	Original item name	Diamond Pickaxe

Number Formatting

Large numbers are automatically formatted with suffixes:

• K - Thousands (1,000)
• M - Millions (1,000,000)
• B - Billions (1,000,000,000)

Examples: 1.5K, 2.3M, 1.1B

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

Use Minecraft color codes (without &):

Code	Color
0	Black
1	Dark Blue
2	Dark Green
3	Dark Aqua
4	Dark Red
5	Dark Purple
6	Gold
7	Gray
8	Dark Gray
9	Blue
a	Green
b	Aqua
c	Red
d	Light Purple
e	Yellow
f	White

Example Output

With default settings at 60% progress:

[||||||||||||||||||||||||||||||-------------------]

(Yellow filled bars, gray empty bars)

Default Profile

The default profile provides a clean, minimal display:

• 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'