LoreEditor

Edit item display names and lore in-game with colors, line-by-line editing, copy/paste, gradients, and more. Hold any item in your main hand and use /lore commands. Compatible with Paper / Folia 1.21+.

---

Command overview

Command	Description
/lore help	Show all commands
/lore reload	Reload config.yml
/lore name <text>	Set display name (colors supported)
/lore name	Clear display name
/lore add <text>	Append lore (use | or \n for multiple lines)
/lore add <line> <text>	Append text to a specific line
/lore set <text>	Replace all lore
/lore set <line> <text>	Set only line N
/lore clear	Clear all lore
/lore clear <line>	Clear only line N
/lore swap <a> <b>	Swap two lines
/lore copy / /lore paste	Copy name + lore, then paste to another item (same session)
/lore trim	Remove empty top/bottom lines; trim spaces
/lore center <line>	Roughly center one line (titles)
/lore gradient <#start> <#end> <text>	Add one gradient lore line

---

Core features

• Any item in main hand (weapons, armor, tools, spears, etc.); only checks that it is not air.
• Rich colors: & codes, hex &#RRGGBB, short #RGB, named colors (&red, &aqua), literal &&.
• Multi-line input: split with \|, or use \n; escape a real pipe with \|.
• Line-based editing: set, append, clear, or swap individual lines; append to the same line across multiple commands.
• Copy / paste name and lore between items without retyping.
• Gradient and center helpers for shop/RPG-style items.
• Configurable limits (max lines, line length, messages) with /lore reload.
• Folia-supported; no global scheduler abuse.

---

Color codes (quick)

Syntax	Meaning
&a, &c, &6 …	Classic colors
&l, &o, &r	Bold, italic, reset
&#RRGGBB / #RRGGBB	Custom hex
#RGB	Short hex (#f00 → red)
&red, &aqua …	Named presets
&&	Literal & character

---

Permissions

Permission	Description
loreeditor.use	Base access (grant to all editors)
loreeditor.add	/lore add
loreeditor.set	set, swap, paste, trim, gradient, center
loreeditor.clear	/lore clear
loreeditor.name	/lore name
loreeditor.reload	/lore reload

Default: all permissions go to OP. Assign via LuckPerms or similar.

---

Configuration

File: plugins/LoreEditor/config.yml

Option	Description	Default
max-lore-lines	Max lore lines per item	20
max-line-length	Max visible chars per line	80
center-width	Width used by /lore center	24
messages	In-game feedback text	See file

Run /lore reload after edits.

---

FAQ

• “Hold an item” with a spear? — Use main hand, not off-hand.
• Enchantments (e.g. Protection III)? — Vanilla enchants stay; only custom name/lore change. Avoid full /lore set if another plugin puts enchant text in lore.
• Folia? — Supported.
• No colors? — Check syntax (&, &#); most setups need no resource pack.

---

MornDream · LoreEditor — Custom item text made simple.