Skip to main content

Item nametags

An item nametag lets a player rename a piece of gear: drag the tag onto the item and an anvil GUI opens where you type the new name (legacy & colour codes are parsed). A blacklist filter can reject names containing banned words.

The nametag — items/nametag.yml​

type: nametag
material: NAME_TAG
name: "&bItem Nametag"
lore:
  - "&7Drag onto gear to rename it"
  - "&7(& colour codes work)."
# Words a renamed item may not contain (case-insensitive substring of the colour-stripped name).
blacklist: []                    # empty = allow any name

:::note Anvil GUI, with a 1.8.9 fallback On modern servers the drag opens our own anvil rename GUI (a real anvil is never hijacked). Typing the name in chat is the 1.8.9 fork's fallback path only. :::

The blacklist is matched case-insensitively as a substring of the color-stripped name, so adding ["slur", "admin"] blocks any name containing those anywhere. An empty list allows anything.

:::tip Curb impersonation and slurs Populate blacklist with staff role names and any disallowed terms so players can't mint gear named to impersonate staff or carry offensive text. :::

Minting & giving​

/se nametag                      # mint a nametag to yourself
/se give nametag <player>

Result messages live in lang.yml under scroll.nametag.*.