LoreEditor

A powerful and lightweight Minecraft plugin for editing item names, lore, and metadata with full PlaceholderAPI integration.

Overview

LoreEditor provides server administrators and players with comprehensive tools to customize items in-game. Whether you're creating custom weapons for an RPG server, designing shop items, or personalizing player equipment, LoreEditor offers an intuitive command-based interface with extensive customization options.

Features

Complete Item Customization

• Custom Names: Rename any item with full color and formatting support
• Dynamic Lore: Add multiple lines of lore with individual control over each line
• Custom Model Data: Set custom model data values for resource pack integration
• Selective Editing: Remove specific lore lines without affecting others
• Smart Reset: Restore items to their default state with a single command

Advanced Color Support

• Traditional Minecraft color codes (& and § symbols)
• Hexadecimal color codes for RGB precision
• All formatting codes: bold, italic, underline, strikethrough, obfuscated
• Gradient and multi-color text support

PlaceholderAPI Integration

• Automatic detection and parsing of PlaceholderAPI placeholders
• Use any installed placeholder expansion in item names and lore
• Dynamic content that updates based on player data, server stats, economy, and more
• Support for complex placeholder combinations

Intelligent Enchantment Handling

• Automatically hides enchantment lore when custom lore is added
• Maintains enchantment functionality while displaying custom text
• Restores enchantment visibility when resetting items
• Clean integration between vanilla enchantments and custom descriptions

Commands

All commands require holding the item you want to modify in your main hand.

/item set metadata <number>

Set custom model data for resource pack textures.

Example:

/item set metadata 5

/item add lore <text>

Add a new line of lore to the item. Each use of this command adds an additional line.

Examples:

/item add lore &6Legendary Weapon
/item add lore &7Damage: &c+50
/item add lore &#FF5733Custom RGB Color
/item add lore &eOwner: %player_name%

/item remove lore <line1|line2|line3>

Remove specific lore lines by their line numbers. Use pipe symbols to remove multiple lines.

Examples:

/item remove lore line1
/item remove lore line2|line4
/item remove lore line1|line3|line5

/item rename <name>

Set a custom display name for the item.

Examples:

/item rename &c&lFlaming Sword
/item rename &#8B0000Dragon Fang
/item rename &6%player_name%'s Tool

/item reset

Reset the item to its default state, removing all custom names, lore, and model data. If the item has enchantments, their visibility will be restored.

Example:

/item reset

Permissions

loreeditor.use

• Grants access to all LoreEditor commands
• Default: op

loreeditor.*

• Wildcard permission for all plugin features
• Default: op

Configuration

LoreEditor works out of the box with no configuration required. The plugin automatically detects PlaceholderAPI if installed and enables placeholder parsing.

Dependencies:

• Required: None
• Optional: PlaceholderAPI 2.11.5+ (for placeholder support)

Examples

Custom Weapon

/item rename &#8B0000&lDragon Fang
/item add lore &7
/item add lore &c⚔ Damage: +50
/item add lore &9✦ Magic: +25
/item add lore &a❤ Lifesteal: 10%
/item add lore &7
/item add lore &6&l[LEGENDARY]
/item set metadata 1

Player-Bound Item

/item rename &6%player_name%'s Pickaxe
/item add lore &eOwner: %player_name%
/item add lore &7Level: %player_level%
/item add lore &bMined: %statistic_mine_block% blocks

Shop Item

/item rename &6[SHOP] &eDiamond Pack
/item add lore &7
/item add lore &fContains:
/item add lore &7• 64x Diamonds
/item add lore &7• 32x Emeralds
/item add lore &7
/item add lore &6Price: $500
/item add lore &aRight-click to purchase

Removing Unwanted Lines

Current lore has 5 lines, you want to remove lines 2 and 4:
/item remove lore line2|line4

Support

For bug reports, feature requests, or general support, please visit the GitHub repository or join our Discord community.