rExpLevel

How it works

1. A player runs /rexp pack bottle 30.
2. The plugin takes 30 levels and one empty glass bottle.
3. The player gets a bottle with 30 levels inside.
4. A right-click on the bottle gives the experience back.

Features

• Experience packing into custom bottles with /rexp pack bottle 30.
• Experience packing into vanilla bottles o' enchanting, 7 XP each.
• Auto conversion: experience above 30 levels goes into bottles of 15 levels.
• A check right after an XP gain or on a timer.
• Your own bottle look per level: material, name, lore, glint, CustomModelData.
• Free mode: a player packs any level up to 500.
• Redeem with a right-click or a throw.
• ADD or FOLD mode: 15 plus 30 levels gives 45 or about 33.
• An empty glass bottle as a cost, returned after use.
• PlaceholderAPI: %rexp_auto% and %rexp_mode%.
• Any message goes to the chat or the action bar.
• No built-in menu: bind the plugin commands to DeluxeMenus buttons.
• MiniMessage, Folia support.

Requirements

Commands

Alias: /rx. Every player has rexp.use, rexp.pack and rexp.auto. Operators have rexp.give and rexp.reload.

Good to know

• The plugin sends anonymous usage statistics to bStats. Set metrics: false in config.yml to turn it off.
• The plugin checks for a new version. Set update-check: false in config.yml to turn it off.

settings:
  debug: false # detailed console messages for troubleshooting
  metrics: true # anonymous bStats statistics
  update-check: true # checks for a new plugin version

commands:
  main: rexp # main command name
  aliases: # extra command names
    - rx

config-version: 2 # internal field, leave it as is

# true: a player creates a bottle with any level up to bottle.max-levels
# false: /rexp pack bottle accepts only levels from the bottles section
bottle-create: false

# Shared bottle look. Applies to levels missing from the bottles section.
bottle:
  material: EXPERIENCE_BOTTLE # bottle item
  name: "<white>Experience bottle</white> <gray>({points} xp)</gray>" # {points}: experience in XP
  lore: # {levels}: levels inside the bottle
    - ''
    - " <white>Contains: <#99ff66>{levels} LVL</white>"
    - " <gray>Right-click to absorb</gray>"
    - ''
  glint: true # enchantment glint
  custom-model-data: 0 # CustomModelData for a resource pack, 0 turns it off
  max-levels: 500 # level cap for one bottle in pack and give
  require-glass-bottle: true # true: creating a bottle costs an empty glass bottle
  # true: the player gets the empty bottle back after use.
  # Works with require-glass-bottle: true here and in auto.yml.
  return-glass-bottle: false
  # DRINK: experience on right-click. THROW: thrown like a vanilla bottle.
  # Only EXPERIENCE_BOTTLE is thrown, any other material is always drunk.
  redeem: DRINK
  # ADD: levels are added, 15 lvl plus a 30 lvl bottle gives 45 lvl.
  # FOLD: experience counts in XP like vanilla, 15 lvl plus a 30 lvl bottle gives about 33 lvl.
  exp-give: FOLD

# Bottles with their own look. Key: experience level from 1 to bottle.max-levels.
# material, name, lore, glint and custom-model-data are optional, missing fields come from the bottle section.
# Empty list: bottles: {}
bottles:
  15:
    material: EXPERIENCE_BOTTLE
    name: "<white>Bottle with 15 levels</white>"
    lore:
      - ''
      - " <white>Contains: <#99ff66>15</#99ff66> levels of experience"
      - " <gray>Right-click to use</gray>"
      - ''
  30:
    material: EXPERIENCE_BOTTLE
    name: "<white>Bottle with 30 levels</white>"
    lore:
      - ''
      - " <white>Contains: <#99ff66>30</#99ff66> levels of experience"
      - " <gray>Right-click to use</gray>"
      - ''

experience:
  xp-per-bottle: 7 # XP price of one vanilla bottle o' enchanting

config-version: 4 # internal field, leave it as is

auto-convert:
  enabled-by-default: false # true: auto conversion is on for new players from the first join
  default-mode: BOTTLE # default mode: BOTTLE custom bottles, EXPERIENCE vanilla bottles
  trigger: EVENT # EVENT: check after an XP gain. PERIODIC: check on a timer
  interval-seconds: 3 # timer pause in seconds, read with trigger: PERIODIC

  bottle: # custom bottle mode
    keep-levels: 30 # levels the player keeps, the rest goes into bottles
    bottle-levels: 15 # levels in one bottle
    max-bottles-per-cycle: 64 # bottle limit per check
    require-glass-bottle: true # true: every bottle costs an empty glass bottle
    hunger-per-bottle: 0 # hunger cost per bottle, 0 turns it off. Fractions work: 0.1

  experience: # vanilla bottle mode
    keep-levels: 30 # levels the player keeps
    max-bottles-per-cycle: 64 # bottle limit per check
    hunger-per-bottle: 0 # hunger cost per bottle, 0 turns it off

config-version: 1 # internal field, leave it as is