Overview
Item commands let you manipulate items in your hand or inventory - repairing tools and armour, renaming items with MiniMessage formatting, adding and removing enchantments, wearing items as a hat, and looking up item details.
Repair
| Command |
Description |
/repair [player] |
Repair the item in your hand. Admin targeting repairs the target's held item. |
/repair works on any damageable item including tools, weapons, armour, and Elytra. Items that are already at full durability are skipped.
Rename
| Command |
Description |
/rename <name> |
Rename the item in your hand. A name argument is required. |
Supports MiniMessage formatting for colors, gradients, and decorations. Renamed items retain their custom name through anvils and grindstones. The rename blacklist (rename.blacklist-words), length limits, and normalization are configurable.
Enchant & Unenchant
| Command |
Description |
/enchant <enchantment> [level] |
Add an enchantment to the held item at the given level (defaults to 1). |
/unenchant [enchantment] |
Remove a specific enchantment, or all enchantments if none specified. |
Enchantment levels above the vanilla maximum (up to 255) require essentialsc.enchant.unsafe, or setting enchant.allow-unsafe: true in config.yml to allow them for everyone who can use /enchant. The enchantment names use the standard Bukkit key format (e.g. sharpness, protection, unbreaking).
Enchanting with unsafe levels may cause unexpected behaviour with some plugins that expect vanilla enchantment levels. Use with caution.
Hat
| Command |
Description |
/hat |
Wear the item in your hand as a hat, swapping with your current helmet slot. |
Certain items can be blocked from being worn as a hat via the material blacklist. Blocks can be disallowed unless the player has essentialsc.hat.blocks, and items can optionally be required to have lore or a custom name. If the current helmet has Curse of Binding, swapping it requires essentialsc.hat.binding_bypass.
| Key |
Type |
Default |
Description |
hat.blacklist-enabled |
Boolean |
true |
Enable the material blacklist check. |
hat.blacklist-items |
List |
bedrock, barrier, command_block, structure_void, jigsaw, light |
Materials that cannot be worn as a hat. |
hat.allow-blocks |
Boolean |
false |
Allow full blocks to be worn as hats. |
hat.require-lore |
Boolean |
false |
Require the item to have lore before it can be worn. |
hat.require-custom-name |
Boolean |
false |
Require the item to have a custom name before it can be worn. |
Other Item Commands
| Command |
Description |
Permission |
/itemid |
Show detailed information about the item in your hand - material, durability, enchantments, NBT. |
essentialsc.itemid |
/clearinventory [player] |
Clear your or another player's entire inventory including armour and offhand. |
essentialsc.clearinventory |
/worth [inventory] |
Check the total shop value of items in your hand or entire inventory. |
essentialsc.worth.hand / .inventory |
Permissions
| Permission |
Default |
essentialsc.repair |
Operators |
essentialsc.repair.others |
Operators |
essentialsc.rename |
Operators |
essentialsc.rename.bypass |
Operators |
essentialsc.enchant |
Operators |
essentialsc.enchant.unsafe |
Operators |
essentialsc.unenchant |
Operators |
essentialsc.hat |
Everyone |
essentialsc.hat.blocks |
Operators |
essentialsc.hat.binding_bypass |
Operators |
essentialsc.itemid |
Operators |
essentialsc.clearinventory |
Operators |
essentialsc.clearinventory.others |
Operators |
essentialsc.worth.hand |
Everyone |
essentialsc.worth.inventory |
Everyone |