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 setif 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.
