Skip to main content
LevelsRM comes with 6 pre-configured custom items that can be fully customized. Each item is configured in its own file under the items/ directory.

​
Item Configuration Structure

Each item file follows this structure: 
enabled: true

item-material: STICK
name: "&cThe Stick!"

lore:
  - "&fYour custom item lore."

# Custom model data(s) for the item
string-model-data: "item-id"
float-model-data: 122

shiny: true
unbreakable: true

enchants:
  - ENCHANT:LEVEL

crafting:
  enabled: false
  shape:
    - "SSS"
    - "SSS"
    - "SSS"
  ingredients:
    S: STICK

​
Configuration Options

​
Basic Settings

  • enabled - Whether the item is enabled
  • item-material - The base material for the item
  • name - Display name of the item (supports color codes)
  • lore - List of lore lines (supports color codes)

​
Visual Customization

  • string-model-data - Custom model data identifier
  • float-model-data - Custom model data value
  • shiny - Whether the item has enchantment glow
  • unbreakable - Whether the item is unbreakable

​
Enchantments

  • enchants - List of enchantments in format ENCHANT:LEVEL

​
Crafting Recipe

  • crafting.enabled - Whether crafting is enabled
  • crafting.shape - 3x3 crafting grid layout
  • crafting.ingredients - Mapping of symbols to materials

​
Available Items

LevelsRM includes 6 pre-configured items:
  1. exp-banisher.yml - Bans victims when used by killers
  2. heart-capper.yml - Caps maximum hearts for players
  3. level-stealer.yml - Steals levels from killed players
  4. multiplier.yml - Multiplier management item
  5. totem-of-exp.yml - Experience totem item
  6. xp-shard.yml - Experience shard item

​
Custom Model Data

You can use custom model data to create unique item appearances: 
# Example with custom model data
string-model-data: "levelsrm_banisher"
float-model-data: 1001

​
Crafting Recipes

Example crafting recipe: 
crafting:
  enabled: true
  shape:
    - "DDD"
    - "DED"
    - "DDD"
  ingredients:
    D: DIAMOND
    E: EMERALD

​
Color Codes

You can use both legacy color codes and hex colors: 
name: "&c&lCustom Item"  # Legacy color codes
lore:
  - "&fThis is white text"
  - "&aThis is green text"
  - "&cThis is red text"
All items come pre-configured but are fully editable. You can modify any aspect of the items to match your server’s theme.