ItemForge

The item in your hand, edited from one command

ItemForge edits the item in your hand from one command, on Paper and Spigot from 1.17 to 26.x: name, lore, enchantments, flags, unbreakable, stack size, custom model data and player heads. No other plugin is needed.

What sets it apart from the rename command your server probably has is not the list of verbs. It is that the three things those commands get wrong are the three things a staff member gets blamed for later.

The three decisions

Length is a limit, and it counts what the player sees: formatting codes take no room on screen, so they don't count against it. A name past the limit breaks anvils, holograms and hover text, which is why the ceiling exists.
Colour, style and obfuscated text are three permissions: colour is decoration, bold is how a dropped item passes for a staff one, and obfuscated text scrambles what the item is. itemforge.format.magic defaults to false, not to operators.
It lives in your config: to protect another material you don't recompile anything, and a material name that doesn't exist is reported on startup instead of silently doing nothing.

Details that only show up in use

Italic is turned off on every name and lore line. Minecraft italicises any custom name by itself, so a name typed with no formatting would otherwise come out formatted.
A tag nobody granted has no meaning: the parser is built from the player's permissions, so a tag that isn't colour, style or obfuscated is left on the item as plain text.
/item head <player> never freezes the server. The head is set by owner name, and a name nobody has used shows the default skin instead of an error.
/item strip asks for every permission it uses. It removes the name, lore, enchantments, flags, unbreakable and the model, so it needs all six, not just the two for name and lore.
Both & codes and modern tags are accepted, so your staff don't have to relearn anything.
Vanilla /item replace and /item modify still work. They are handed to Minecraft instead of showing ItemForge's usage.

Commands

/item name <text>, or with no text to clear it.
/item lore add|set|remove|clear
/item enchant <name> <level>, /item unenchant <name> and /item clearenchants. Names resolve the way a player would type them, with tab completion.
/item flag <flag>, /item unbreakable, /item amount <n> and /item model <n>
/item head <player>, /item strip and /item reload (aliases /itemforge and /if).

Permissions

One per verb (itemforge.name, itemforge.lore, itemforge.enchant and so on), so a builder rank can rename but not make things unbreakable. All default to operators.
Three for formatting: itemforge.format.colour, itemforge.format.style and itemforge.format.magic.
itemforge.protected for the material list, and itemforge.limits.bypass for a staff member testing something. The second defaults to false: it is granted, not inherited by being an operator.
Every node is declared in plugin.yml, so your permissions plugin can see them all.

Configurable

Longest display name, longest lore line and how many lore lines an item may carry.
The highest enchantment level, and the largest stack /item amount will set.
The protected material list: spawners, written books and filled maps out of the box, because a renamed one of those is how a fake passes for the real thing. Add your own.
Whether every edit is written to the console: who, which item and what changed.
English and Spanish are included, and every string a player sees lives in the language file.

Requirements

Paper or Spigot from 1.17 to 26.x, forks like Purpur included, on the Java version your server already uses.
No other plugin needed.

FAQ

Can a player use it?
Only if you give them the permissions. Everything defaults to operators.

Can I stop people renaming spawners?
Spawners are protected out of the box. Add any other material to the protected list in config.yml.

Can I see who edited what?
Yes. Turn on the console log and every edit is written with the player, the item and the change.

For questions or bug reports, use the discussion tab on this page or our Discord. Every update is announced on the Discord before it reaches the listing.