NewCraftRank SitesA free website and storeMake yours ›
AshlarFree server software built on Paper, with DDoS and backdoor protection See Ashlar ›CommunityAsk questions, share builds and find people to play with Join the forum ›
Resources / Plugins / CustomNametag

CustomNametag

A lightweight, modern nametag plugin for Paper 1.21.x powered by Display Entities.

PluginsFree1.21
by haz3l · listed from Modrinth
Download ›

Direct download from Modrinth · 2 downloads

What it does

CustomNametag is a plugin for Paper / Spigot servers, made by haz3l. A lightweight, modern nametag plugin for Paper 1.21.x powered by Display Entities.

It supports Minecraft 1.21. It has been downloaded 2 times on Modrinth. That puts it at #127 of the 129 cosmetic and display plugins listed here. The last update came out on Nov 4, 2026.

Supported versions

1.21

Release history

The newest is 1.0.0, released on Nov 4, 2026. It is made for Minecraft 1.21.11. It runs on Paper. The download is 26 KB.

VersionReleasedMinecraftType
1.0.0Nov 4, 20261.21.11Release

Commands

The commands named on the Modrinth page of CustomNametag:

/nametag

Permissions

Permission nodes named there, to give with a plugin like LuckPerms:

customnametag.usecustomnametag.admin
Description from the author on Modrinth

CustomNametag

CustomNametag is a modern nametag plugin powered by vanilla Text Display entities. Instead of relying on legacy scoreboard teams that cause prefix limits, flickering, and compatibility conflicts with other scoreboard or tab plugins, CustomNametag creates smooth, multi-line, customizable floating nametags above players.


Features

  • Text Display Engine: Utilizes vanilla TextDisplay entities with smooth billboard orientation without requiring any client-side mods.
  • First-Person Safe: Automatically hides your own nametag from your first-person camera view so your crosshair and screen remain completely clear.
  • LuckPerms & PlaceholderAPI: Seamlessly displays prefixes, suffixes, and group formats, with full support for any PlaceholderAPI placeholders.
  • Live Ping Indicator: Displays a real-time, customizable latency counter on the secondary nametag line.
  • Player Personalization: Players can customize their own nametag styling on the go:
  • Custom background colors (Hex #RRGGBB, named colors, or full transparency).
  • Toggle text shadows for improved readability in bright environments.
  • Toggle visibility to hide other players' nametags for screenshots or preference.
  • Safe Lifecycle Management: Reliably tracks teleports, dimension transitions, spectator mode, and disconnects with zero ghost entities left behind.

Commands & Permissions

Command · Description · Permission
/nametag visibility · Toggle seeing other players' nametags · customnametag.use
/nametag background · Change your nametag background (#hex, color name, or transparent) · customnametag.use
/nametag textshadow · Toggle text shadow on your nametag · customnametag.use
/nametag reload · Reload the configuration and reapply nametags · customnametag.admin

Short alias: /cnt


Configuration

All aspects can be customized directly in config.yml:

  • Custom format strings for names, ranks, and ping lines.
  • Y-axis height offset and billboard alignment.
  • Server-wide defaults for background transparency and text shadows.
  • Configurable update tick intervals.
  • Fully customizable messages.

Written by haz3l. Read it with pictures on Modrinth.

How to install CustomNametag

  1. Make sure your server runs Paper and Spigot on Minecraft 1.21.

  2. Download the .jar file from Modrinth and put it in the plugins folder of your server.

  3. Restart the server. Avoid /reload, many plugins do not handle it well.

  4. Type /plugins in the console: CustomNametag should be listed in green. Its config files are created in the plugins folder on the first start.

Full guide: How to install plugins on a Minecraft server

Compatibility

Minecraft versions
1.21
Runs on
Paper, Spigot
Edition
Java
Needs
Nothing else
License
MIT
Price
Free
Upkeep
Actively updated (Nov 13, 2026)

CustomNametag compared with similar ones Compare all alternatives

ResourceDownloadsVersionsLast updatePrice
CustomNametagthe one you looked at21.218 days agoFree
Simple RanksTomMustBe1232K1.20 – 26.xJun 7, 2026Free
Custom Join MessagesInsprill28K1.12 – 26.x25 days agoFree
squaremapjpenilla184K1.19 – 26.x27 days agoFree

Questions

Does CustomNametag work on Minecraft 26.x?

Not yet. The newest version it supports is Minecraft 1.21.

Is CustomNametag free?

Yes. CustomNametag is free to download from Modrinth.

Which server software does CustomNametag run on?

CustomNametag runs on Paper and Spigot servers.

Is CustomNametag still updated?

Yes. The last update came out in the past day.

What are the best alternatives to CustomNametag?

The closest ones are Simple Ranks, Custom Join Messages and squaremap. Compare all alternatives

Alternatives to CustomNametag

Simple RanksPlugins · 1.20 – 26.x

Simple rank plugin allowing for custom-colored, ordered ranks in tab list, name tags, chat, and Placeholder API placeholders!

Free31,790 downloads
Custom Join MessagesPlugins · 1.12 – 26.x

Welcome players with first-join, join, and quit messages, publicly or privately, via Chat, Titles, Action Bars, Boss Bars, and Sounds. Permission-based and…

Free27,520 downloads
squaremapPlugins · 1.19 – 26.x

squaremap is a minimalistic & lightweight world map viewer for Minecraft servers, using the vanilla map rendering style

Free183,638 downloads
THologramsPlugins · 1.21 – 26.x

Next-gen lightweight 3D hologram & display entity engine with Motion DNA, Folia multi-threading, zero tick overhead, and interactive hitboxes.

Free50 downloads
Compare all alternatives ›

Reviews

–★★★★★
0 reviews
50
40
30
20
10

Log in to leave a review.