> For the complete documentation index, see [llms.txt](https://docs.supremeventures.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supremeventures.ca/freebies/item-meta.md).

# Item Meta

Item Meta is a small, easy to use plugin designed for quickly templating and previewing ItemStack styling in-game without leaving, configs, or restarts. Using the below commands, you simply hold your item in your hand, and execute commands to modify any aspect of ItemStack configuration.

## Commands Overview

The following commands are used to manage and modify item metadata in the game:

* **/meta glow `true|false`**\
  Set the item to glow and hide enchantments.
* **/meta display|name `{text}`**\
  Set the display name of the item using any adventure codes and text. If no text is provided, the plugin will attempt to resolve the current name & prompt you to edit it.
* **/meta lore**\
  Manage the lore (description) of the ItemStack:
  * **/meta lore add `<text>`**\
    Add a line to the lore with the specified text.
  * **/meta lore remove `<line-number>`**\
    Remove the lore line at the specified line number. Must be within range.
  * **/meta lore insert `<line-number>`** **`<text>`**\
    Insert a new lore line at the specified line number. Index must be within the current lore range.
  * **/meta lore clear**\
    Clear all existing lore from the item.
  * **/meta lore edit `<index> {text}`**\
    Edit an existing lore line. If no text is provided, the plugin will attempt to find the current line styling & prompt you to edit it via a suggestion command.&#x20;
* **/meta unstackable `true|false`**\
  Set the item to be unstackable. Unstackable means that a given item will not be stackable with other items of the same type, lore, displayname & meta. This is achieved by adding a unique data container to each item. If an item is made "unstackable" and the amount is set to `> 1`, the resulting items **will be stackable** as the item stack was modified to all have the same unique code.&#x20;
* **/meta unbreakable `true|false`**\
  Set the item to be unbreakable. Unbreakable items also have a `UNBREAKABLE` item flag which will show on the item once added. You can hide this with `/meta flags add HIDE_UNBREAKBLE`
* **/meta flags**\
  Manage the flags on the ItemStack:
  * **/meta flag add `<item-flag>`**\
    Add a specific item flag.
  * **/meta flag remove `<item-flag>`**\
    Remove a specific item flag.
  * **/meta flag list**\
    List all flags present on the item in hand.
  * **/meta flag listall**\
    List all possible item flags that can be added to this item. This list is dependent on your servers native version. In 1.20, 1.20.1 & 1.20.3 item flags have been changed.
* **/meta info**\
  Display detailed information about the item in hand. Type, enchants, data containers, etc.
* **/meta enchant `<enchantment> <level>`**\
  Add an enchantment to a ItemStack. This action will override the `/meta glow` command removing the provided `HIDE_ENCHANTS` flag & removing the default enchant added to create the flow effect (`FIRE_ARROWS`). If you'd still like to hide enchants, use `/meta flags add HIDE_ENCHANTS`. To remove enchants, use `0` as the level.&#x20;
* **/meta material `<type>`**\
  Allows you to change the current material type of the item you are holding, while transferring all other metadata.
* **/meta amount `<amount>`**\
  Allows you to change the amount of an item you are currently holding (like `/stack` from essentials)
* **/meta export `<format>`**

  Allows you to export a given item to a provided format. By default, ItemMeta provided exporting to YAML/YML formats (Gucci Style) and to Base64.&#x20;
