Lore Editor

# 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 /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 &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.